agentic-dev/docs/work/agent-workflow-docs-v1/01-docs-rewrite/_story.md

id, epic, title, type, status, feature, depends-on, blocks

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

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

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