Brain
The rig’s living reference. Read this first. Covers the event model, repo manifest, agent roles, surfaces, and known gaps.
Rig Docs
Whitepapers, research, proposals, and agent reference for the rig — shared autonomous engineering across multiple orgs and projects.
What lives here
Section titled “What lives here”Whitepapers
Leadership-level position papers. Each whitepaper anchors a cluster of research, user stories, and capability tracking.
Research
Deep dives into specific engineering questions. Markdown-first. YAML frontmatter. Dated.
User Stories
Concrete user-facing goals that drive proposals and feed the whitepaper capability tracker.
Proposals
Synthesized ship plans. One proposal per decision. Cross-linked to the research that supports it.
Decisions
Accepted proposals — the permanent record of what was decided and why.
Stories
Narrative walkthroughs of how the rig solves real problems. Written for humans and agents alike.
Reference
AGENTS.md for this repo, plus facts and pitfalls the rig’s agents use to stay coherent.
How content is authored
Section titled “How content is authored”All pages are markdown with YAML frontmatter, stored in src/content/docs/. The frontmatter schema is enforced in src/content.config.ts (title, description, type, audience, created, updated, topic, source_refs, supersedes/superseded_by).
Diagrams are authored as Mermaid source in fenced code blocks:
flowchart LR A[User story] --> B[Research] --> C[Proposal] --> D[Decision] --> E[Implementation]
View Mermaid source
flowchart LR A[User story] --> B[Research] --> C[Proposal] --> D[Decision] --> E[Implementation]The site renders Mermaid client-side. The source is the canonical artifact — no PNG/SVG is committed.