---
id: conformance-system-v1
prd: null
title: Conformance system v1
type: epic
status: done
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
- [x] [01 — defineFeature helper + Instrumented/Captured/Audited brands](01-define-feature-helper/_story.md)
- [x] [02 — `assertFeatureConformance` + boot wiring](02-boot-assertions/_story.md)
- [x] 03 — AST-aware ESLint rules (both halves shipped)
  - [x] [03.a — Structural rules](03-a-structural-eslint-rules/_story.md)
  - [x] [03.b — Manifest-aware AST rules](03-b-ast-eslint-rules/_story.md)
- [x] [04 — CI drift gate](04-ci-drift-gate/_story.md)
- [x] [05 — Generator updates](05-generator-updates/_story.md)
- [x] [06 — Migrate blog / media / navigation / marketing-pages](06-feature-migrations/_story.md)
- [x] 07 — Migrate auth feature reference (completed inline in milestone i; signIn through ProductionUseCase slot)
