Roadmap#

[roadmap]Reference

Done — v2.11#

• ✅ Hardened reference form endpoint (components.forms).
• ✅ Component templates split into static / interactive / polymorphic (templates).
• ✅ Env rule corrected — the starter has no required build-time keys (structure.env).
• ✅ Conformance table empty: every Required rule is true of the starter.

Done — v2.10#

• ✅ prefetch enabled, hover strategy, all internal links (perf.prefetch).
• ✅ HeroCanvas and ShinyButton removed, clearing the last raw-value holdouts (tokens.scoped-styles).

Done — v2.9#

• ✅ SectionMain side rules confirmed as intentional, not a gap (components.composition).
• ✅ Starter lineage rewritten around the template repo; starterVersion inherited automatically (structure.git).

Done — v2.3#

• ✅ Generated STANDARDS.md retired; rule ids are now clickable in every file via generated rule-links blocks (guardrails.docs-check).
• ✅ Doc/ removed — component documentation has one home, src/content/components/*.mdx (components.docs).
• ✅ Plan.md moved to plan, with its shipped showcase section dropped.
• ✅ launch skill's staging rule reconciled with seo.staging (conformance).

Done — v2.2#

• ✅ Type gate swapped to astro check; the three errors it surfaced are fixed (structure.gate, conformance).
• ✅ Site URL single-sourced (seo.identity); the placeholder guard shipped with it was reverted in v2.4.

Done — v2.1#

• ✅ Split the rulebook into task-scoped modules with a router (guardrails.docs-check, changelog).
• ✅ Stable rule ids replace section numbers everywhere; §N is banned syntax.
• ✅ scripts/check-docs.mjs wired into npm run check.
• ✅ Verification tiers so the gate scales with blast radius.
• ✅ AGENTS.md reduced to a contract of pointers; CLAUDE.md points at it.
• ✅ build-component command deleted; its unique content rescued into components.styling.

P2 — tooling#

1. Clear the remaining astro check hints — unused locals, and the deprecated z re-export in content.config.ts. They don't fail the gate; raising --minimumFailingSeverity to hint only makes sense once they're at zero.
2. Stand up linting (guardrails.lint) with the listed rules; run inside check.
3. Prettier + shared config (guardrails.format).
4. Minimal CI: check + eslint on PR (guardrails.ci).
5. Lighthouse CI asserting perf.budgets budgets, and axe-core (guardrails.axe).
6. Adopt astro:env for typed env (structure.env).
7. Cookie-consent gating as a reusable component (perf.third-party).
8. Two more skills (guardrails.skills): design-system intake (runbook phases 1–2) and a standalone accessibility audit (checklist.a11y).