From b2dfd91367a1d0081aacfbb61d020421c7580ec2 Mon Sep 17 00:00:00 2001
From: Danijel Martinek <danijel@fraqtal.xyz>
Date: Tue, 12 May 2026 21:24:03 +0200
Subject: [PATCH] docs(work): scaffold docs/work and conformance-system-v1 epic

---
 docs/work/README.md                      | 16 ++++++++++
 docs/work/conformance-system-v1/_epic.md | 39 ++++++++++++++++++++++++
 2 files changed, 55 insertions(+)
 create mode 100644 docs/work/README.md
 create mode 100644 docs/work/conformance-system-v1/_epic.md

diff --git a/docs/work/README.md b/docs/work/README.md
new file mode 100644
index 0000000..1811bf1
--- /dev/null
+++ b/docs/work/README.md
@@ -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)
diff --git a/docs/work/conformance-system-v1/_epic.md b/docs/work/conformance-system-v1/_epic.md
new file mode 100644
index 0000000..a039deb
--- /dev/null
+++ b/docs/work/conformance-system-v1/_epic.md
@@ -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)