Claude Code First
An evidence-based specification of how to run a software project in which Claude Code is the primary author of the code and a person governs what is built. Each rule rests on graded findings from five projects run this way, and each finding on pointers into their pinned sources, which a gate checks on every push.
What comes next
From the product's own docs/ROADMAP.md at 54e1414.
Nothing is open on this product's roadmap right now.
Recently shipped
All 80 entries →- CCF80 · 54e1414Rule pages print literal asterisks around every normative sentence that holds an italic term
Rule pages render a bold normative sentence holding an italic term as strong with em inside, and a test fails on any rule page that prints two asterisks.
- CCF79 · cc174ebThe site header links neither alegauss.github.io nor the GitHub repository, unlike every other alegauss site
Every page's header carries the "part of alegauss" chip to alegauss.github.io and a GitHub button to the repository, and a test fails on a header without either.
- CCF78 · 3e0abeemarkdownlint lints the governed docs/DEFERRED.md, and fails on a blank line roadkeep wrote there
markdownlint now ignores docs/DEFERRED.md beside the other four governed files, and its gate passes with the file as roadkeep wrote it.
- CCF77 · 72e902bThe guide and specification pages carry their own 892-line stylesheet, outside the design system
The guide and spec pages take fonts, tokens and site.css at 2026.3.22, re-keyed to the mark's rose, with analytics behind consent; style.css keeps only this site's own blocks.
- CCF76 · 84af454The site shows no mark of its own: no favicon, no logo in the header, no social card
Every built page links icon.svg and carries og:image, the guide header shows the mark, and a stdlib-drawn og.png renders the mark and title.
- CCF75 · 52a4b67the files-over-APIs open question names what would settle it, and nothing has been measured against it
F410 grades Shio's SH1141 at R1/S3: files cost 1.29x less and the agent writes 3.1x less; AP's open question and the guide say so, and corpus.md now lists a commit cited past a pin.
- CCF74 · cf33932the method admits no evidence of what a project's own sessions cost, so the session-budget question cannot be settled
method.md admits session-cost aggregates on four conditions, harness.md records H16-H20 and O4, and evidence/sessions holds a cost per task for all five projects.
- CCF73 · 14f3078the guide's lessons say nothing about what an agent-facing surface costs, and the page types its lesson count
The guide's ninth lesson shapes the agent's path to the task and measures it, linking F409, F8, AP-5 and AP-6, and its lesson count is computed from the cards.