docs-design-system
Design System Documentation Audit & Update
Audit design docs under _docs/_build/design/ (and the _docs/design/ symlink) against the live codebase so documentation stays the single source of truth for how the design chain is implemented in this repo.
Ground truth file: _docs/_build/design/DESIGN_SYSTEM_SSOT.md — update this first when reconciling; then align DESIGN_CHAIN.md, DESIGN_CHARTER.md, and layers/*.md as needed.
Target: $ARGUMENTS
If no target is provided, audit the full _docs/_build/design/ tree and src/app/globals.css, tailwind.config.ts, src/components/ui/, and src/components/ (excluding _archive/).
Design chain (reference)
Bottom-up: D0 charter → D1 tokens (globals.css, tailwind.config.ts) → D2 primitives (src/components/ui/) → D3 domain components → D4 patterns/layouts → D5 pages → D6 motion.
Design values flow downstream only (see .cursor/rules/react-nextjs-best-practices.mdc design chain).