Bootstrap or repair the repo UI SSOT (ui/tokens, ui/contract, ui/styles, docs/context/ui) for data-ui contract + Tailwind B1; run codegen + validation with an approval gate when overwriting.
Establish and maintain a robust, low-drift UI/UX foundation for LLM-led development using:
ui/tokens/* (values live here)ui/contract/contract.json (data-ui roles + enumerations)ui/styles/* (tokens + contract + feature layer)docs/context/ui/ui-spec.jsonThis skill is the only way to initialize or repair the UI system. It is intentionally deterministic and idempotent.
.ai/.tmp/ui/<run-id>/See:
./references/locked-system-parameters.mdUse when the user asks to:
Avoid when:
ui-feature-delivery)ui-governance-gate)default.light, default.dark (provided)--force) and always requires approvalui/ (tokens, contract, styles, patterns)docs/context/ui/ui-spec.json.ai/.tmp/ui/<run-id>/ui/ and docs/context/ui/ui-spec.json already exist.run-id and create evidence dir:
.ai/.tmp/ui/<run-id>/00-intake.md, 01-analysis.md, 02-proposal.md, 03-execution-log.md, 04-post-verify.mdui/tokens/*, ui/contract/contract.json, ui/styles/contract.css), STOP and request explicit approval.python3 .ai/skills/features/ui/ui-system-bootstrap/scripts/ui_specctl.py init
python3 .ai/skills/features/ui/ui-system-bootstrap/scripts/ui_specctl.py codegen
python3 .ai/skills/features/ui/ui-system-bootstrap/scripts/ui_specctl.py validate
ui/styles/tokens.css regeneratedui/codegen/contract-types.ts regenerateddocs/context/ui/ui-spec.json regeneratedRecord results in 04-post-verify.md.
node .ai/tests/run.mjs --suite ui