docs(work): scaffold agent-workflow-docs-v1 epic + story 01
This commit is contained in:
42
docs/work/agent-workflow-docs-v1/01-docs-rewrite/_story.md
Normal file
42
docs/work/agent-workflow-docs-v1/01-docs-rewrite/_story.md
Normal 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
|
||||
Reference in New Issue
Block a user