---
id: 01-docs-rewrite
epic: agent-workflow-docs-v1
title: Surface conformance system across top-level docs
type: technical-story
status: done
feature: docs
depends-on: []
blocks: []
---

## Goal
Update CLAUDE.md, AGENTS.md, and four guides so agents picking up this
repo discover and follow the manifest-first workflow by default.

## Done when
- CLAUDE.md has a "Conformance system" section + manifest-first ordering
  added to Key Conventions
- AGENTS.md's per-feature conventions mention the manifest contract
- adding-a-feature.md updated to the 4-step ordering
- scaffolding-a-feature.md notes the manifest emission + boot assertion
- tdd-workflow.md links to the conformance enforcement
- New conformance-quickref.md exists as a single-page agent reference

## In scope
Mechanical doc updates pointing at existing artifacts (the design doc, the
feature-conformance-explainer.html, the actual rules / wrappers / script
already merged).

## Out of scope
- Rewriting the existing architecture docs (already in place)
- Updating per-package AGENTS.md inside packages/*

## Tasks
- [x] Epic + story scaffold
- [x] CLAUDE.md update
- [x] AGENTS.md update
- [x] adding-a-feature.md update
- [x] scaffolding-a-feature.md update
- [x] tdd-workflow.md update
- [x] conformance-quickref.md (new)
- [x] Final verification + closeout