docs(work): scaffold docs/work and conformance-system-v1 epic
This commit is contained in:
16
docs/work/README.md
Normal file
16
docs/work/README.md
Normal 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)
|
||||
39
docs/work/conformance-system-v1/_epic.md
Normal file
39
docs/work/conformance-system-v1/_epic.md
Normal file
@@ -0,0 +1,39 @@
|
||||
---
|
||||
id: conformance-system-v1
|
||||
prd: null
|
||||
title: Conformance system v1
|
||||
type: epic
|
||||
status: in-progress
|
||||
features: [cross-cutting]
|
||||
created: 2026-05-12
|
||||
---
|
||||
|
||||
## Goal
|
||||
Build the feature-conformance enforcement system so AI agents get layered,
|
||||
sub-second feedback on drift between manifest and code.
|
||||
|
||||
## Why
|
||||
See `docs/architecture/feature-conformance-explainer.html` and
|
||||
`docs/architecture/agent-first-workflow-and-conformance.md`.
|
||||
|
||||
## In scope
|
||||
- defineFeature helper + brand types
|
||||
- assertConformance + boot wiring
|
||||
- AST-aware ESLint rules
|
||||
- CI drift gate
|
||||
- Generator updates for manifest + contracts + test stubs
|
||||
- Documentation rewrite (manifest-first workflow)
|
||||
- Migration of auth feature as the reference
|
||||
|
||||
## Out of scope
|
||||
- Migration of blog, media, navigation, marketing-pages (Phase 3)
|
||||
- Sandcastle orchestration (Phase 2: work-system-v1 epic)
|
||||
|
||||
## Stories
|
||||
- [ ] [01 — defineFeature helper + Instrumented/Captured/Audited brands](01-define-feature-helper/_story.md)
|
||||
- [ ] 02 — `assertConformance` + boot wiring (later plan)
|
||||
- [ ] 03 — AST-aware ESLint rules (later plan)
|
||||
- [ ] 04 — CI drift gate (later plan)
|
||||
- [ ] 05 — Generator emits manifest + contracts + test stubs (later plan)
|
||||
- [ ] 06 — Documentation rewrite (later plan)
|
||||
- [ ] 07 — Migrate auth feature reference (later plan)
|
||||
Reference in New Issue
Block a user