37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
---
|
|
id: agent-workflow-docs-v1
|
|
prd: null
|
|
title: Agent-workflow docs rollout
|
|
type: epic
|
|
status: done
|
|
features: [docs]
|
|
created: 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)
|
|
|
|
## Stories
|
|
- [x] [01 — Surface conformance system across CLAUDE.md / AGENTS.md / guides](01-docs-rewrite/_story.md)
|