docs(work): scaffold agent-workflow-docs-v1 epic + story 01

This commit is contained in:
2026-05-13 07:27:04 +02:00
parent be1938404a
commit 5cc59e79db
2 changed files with 78 additions and 0 deletions

View File

@@ -0,0 +1,42 @@
---
id: 01-docs-rewrite
epic: agent-workflow-docs-v1
title: Surface conformance system across top-level docs
type: technical-story
status: in-progress
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
- [ ] 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