Documentation

10 design documents.
One source of truth.

Every architectural decision, evidence claim, and commitment lives in one of these documents. They cross-reference each other heavily — start with whichever matches your role.

Numbered design docs

Product Spec

shipping

The PRD. Problem, evidence, goals, non-goals, competitive posture, pricing surface, year-1 plan.

For: Customers, design partners, investors

Library Architecture

shipping

How the OSS library is built. Monorepo layout, package boundaries, harness primitives, framework-agnostic core.

For: OSS contributors, library consumers

SaaS Platform

shipping

The SaaS architecture on AWS. Control plane, data plane, multi-tenant isolation, GitHub App, billing.

For: Platform engineers, infra reviewers

AI / Spec-Generation Pipeline

shipping

The 3-pass LLM pipeline. Model routing, prompt caching, harness-primitive grounding, confidence scoring, eval harness.

For: ML infra engineers, applied AI leads

Security & Compliance

shipping

STRIDE threat model, SOC 2 Type II control mapping, customer-cloud runner, encryption, IR plan.

For: Customer security teams, auditors

Operations & SRE

shipping

SLOs, on-call rotation, deployment pipeline, capacity planning, runbooks, backup/DR, GA milestones.

For: SRE, on-call engineers

Data Platform & Feedback Loops

shipping

The moat doc. Per-tenant data assets, RAG retrieval, weekly tuning cycle, cross-tenant insights. Why customers pay.

For: Platform engineers, prospective customers

Customer Experience & Product Surface

shipping

Personas, end-to-end journey, dashboard wireframes, CLI, GitHub App, notifications, onboarding, RBAC, accessibility.

For: PM, design, customer success

Adapter / Connector Spec

shipping

Per-vendor integration spec for Jam, LogRocket, Sentry Replay, FullStory, Datadog RUM. Endpoints, payloads, normalization, quirks.

For: Adapter implementers, vendor partners

First-Party Recorder & Chrome Extension

shipping

The closed-loop input edge. Why first-party beats third-party for the agent loop, MV3 architecture, captured event surface, programmatic API, three integration patterns including local-agent endpoint and MCP server roadmap.

For: Engineers integrating the recorder, agentic-coding integrators

QA Data Warehouse

shipping

What the SaaS centralizes — the org-wide queryable corpus of sessions, specs, runs, bug-classes, and signals. Six entity classes, REST API, eight-tool MCP server for Claude Code / Cursor / Aider mid-task investigation. The OSS-vs-SaaS buy-vs-build line.

For: Engineering leaders evaluating the SaaS, integration engineers