docs(work): scaffold docs/work and conformance-system-v1 epic

This commit is contained in:
2026-05-12 21:24:03 +02:00
parent 31906b9e3e
commit b2dfd91367
2 changed files with 55 additions and 0 deletions

16
docs/work/README.md Normal file
View File

@@ -0,0 +1,16 @@
# docs/work — the local task system
Filesystem-backed Epic/Story/Task hierarchy used by AI agents and humans alike.
See `docs/architecture/agent-first-workflow-and-conformance.md` for the full
design. Until the `work-system-v1` epic ships orchestration tooling, this
folder is human-driven — agents read the files for context, humans flip
checkboxes.
## Layout
- `prds/<date>-<slug>.prd.md` — source PRDs
- `<epic-slug>/_epic.md` — one folder per epic
- `<epic-slug>/<story-slug>/_story.md` — one folder per story
- `<epic-slug>/<story-slug>/<task-slug>.task.md` — one file per task
- `_templates/` — copy-paste templates (added in work-system-v1)
- `_state.json` — derived index (added in work-system-v1)