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