Research
Deep dives into specific engineering questions. Markdown-first. YAML frontmatter. Dated.
What lives here
Section titled “What lives here”Proposals
Synthesized ship plans. One proposal per decision. Cross-linked to the research that supports it.
Diagrams as code
Mermaid source inline in markdown. Rendered live by the site. No PNG/SVG artifacts committed.
Agent 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[Implementation]
View Mermaid source
flowchart LR A[User story] --> B[Research] --> C[Proposal] --> D[Implementation]The site renders Mermaid client-side. The source is the canonical artifact — no PNG/SVG is committed.