1.4 KiB
1.4 KiB
id, prd, title, type, status, features, created
| id | prd | title | type | status | features | created | |
|---|---|---|---|---|---|---|---|
| agent-workflow-docs-v1 | null | Agent-workflow docs rollout | epic | done |
|
2026-05-13 |
Goal
Surface the conformance-system-v1 mechanics across CLAUDE.md, AGENTS.md, and the feature-development guides so agents picking up this codebase follow the manifest-first workflow by default.
Why
The conformance system is the substrate, but agents read the top-level docs first. Until the docs say "feature.manifest.ts exists, here's what it does, here's how the gates fire," the system stays invisible to agents iterating on this repo for the first time.
In scope
- CLAUDE.md: add conformance system section + manifest-first ordering
- AGENTS.md: add manifest convention to per-package conventions
- docs/guides/adding-a-feature.md: update workflow to manifest → contracts → tests → code
- docs/guides/scaffolding-a-feature.md: note that generator now emits manifest + boot assertion
- docs/guides/tdd-workflow.md: link conformance system as the enforcement layer
- New docs/guides/conformance-quickref.md: ~80-line agent-facing reference
Out of scope
- Frontend-conformance docs (next epic)
- Work-system-v1 docs (those land with the work-system epic)
- Editing the original conformance design docs (already in place)