agentic-dev/docs/work/conformance-system-v1/_epic.md

id, prd, title, type, status, features, created

id	prd	title	type	status	features	created
conformance-system-v1	null	Conformance system v1	epic	done	cross-cutting	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
• 02 — assertFeatureConformance + boot wiring
• 03 — AST-aware ESLint rules (both halves shipped)
  • 03.a — Structural rules
  • 03.b — Manifest-aware AST rules
• 04 — CI drift gate
• 05 — Generator updates
• 06 — Migrate blog / media / navigation / marketing-pages
• 07 — Migrate auth feature reference (completed inline in milestone i; signIn through ProductionUseCase slot)