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
shippingThe PRD. Problem, evidence, goals, non-goals, competitive posture, pricing surface, year-1 plan.
For: Customers, design partners, investors
Library Architecture
shippingHow the OSS library is built. Monorepo layout, package boundaries, harness primitives, framework-agnostic core.
For: OSS contributors, library consumers
SaaS Platform
shippingThe SaaS architecture on AWS. Control plane, data plane, multi-tenant isolation, GitHub App, billing.
For: Platform engineers, infra reviewers
AI / Spec-Generation Pipeline
shippingThe 3-pass LLM pipeline. Model routing, prompt caching, harness-primitive grounding, confidence scoring, eval harness.
For: ML infra engineers, applied AI leads
Security & Compliance
shippingSTRIDE threat model, SOC 2 Type II control mapping, customer-cloud runner, encryption, IR plan.
For: Customer security teams, auditors
Operations & SRE
shippingSLOs, on-call rotation, deployment pipeline, capacity planning, runbooks, backup/DR, GA milestones.
For: SRE, on-call engineers
Data Platform & Feedback Loops
shippingThe 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
shippingPersonas, end-to-end journey, dashboard wireframes, CLI, GitHub App, notifications, onboarding, RBAC, accessibility.
For: PM, design, customer success
Adapter / Connector Spec
shippingPer-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
shippingThe 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
shippingWhat 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