T-APNC-design-language-agentpants-palette-burndown
Status: open/ready · Impact: low · Complexity: medium
apps/agentpants carries the ring’s largest literal debt (~2,400 raw
Tailwind palette classes and dark: variants). Its adoption PR extended
the layer but deliberately left the debt. Burn it down to --d-* tokens
so theming actually reaches the app.
| Location | Role today |
|---|---|
apps/agentpants/src-nuxt/app/ | Raw palette classes and dark: variants throughout components and pages; the layer’s tokens available but unused there. |
Proposed
Section titled “Proposed”Literals replaced by token-backed styling, directory by directory, with visual parity at each step. The T-J04U-design-language-no-raw-palette-check baseline for this app ratchets toward zero.
Approach
Section titled “Approach”- Rank directories by literal count; sweep one per commit.
- Map each literal to its token (
--d-*or bridge-provided--ui-*semantics); drop the paireddark:variant — tokens carry mode. - Screenshot parity per sweep (light + dark).
- Lower the guard baseline as counts fall.
Files to touch
Section titled “Files to touch”| Location | Kind | Change |
|---|---|---|
apps/agentpants/src-nuxt/app/ | modify | literal → token sweeps |
Acceptance criteria
Section titled “Acceptance criteria”- AC-1: Raw-palette count for the app reaches 0 (guard baseline 0).
- AC-2: Visual parity screenshot pairs accompany each sweep PR.
- AC-3: Theme switching (platinum ↔ others, light/dark) restyles the swept surfaces.
Out of scope
Section titled “Out of scope”- Component restructuring; behavior changes.
Dependencies
Section titled “Dependencies”- The agentpants adoption PR merges first; T-J04U-design-language-no-raw-palette-check provides the ratchet.
Discovery context
Section titled “Discovery context”docs/planning/design-language/PLAN.mdPhase 3 (“burn down opportunistically, not big-bang”).