feat(designbook): technology-neutral IR + stack-adapter pipeline (WHYNOT-WP-0002 T01-T06)
Author the design language once in the canonical React designbook and project it
one-way onto each stack: React -> designbook/ -> ir/ -> adapters/<stack>/.
Phase 0 — contracts & governance (T01-T03):
- ir/SCHEMA.md + ir/schema/{component,tokens}.schema.json — neutral IR contract
(W3C DTCG tokens; React prop -> HTML attribute mapping; non-portable props flagged).
- adapters/ADAPTER_CONTRACT.md — inputs, drift-report + parity-result shapes,
idempotency rules, CI exit codes (0 ok / 2 usage / 3 drift / 4 parity / 5 internal).
- .claude/rules/designbook-propagation.md + DesignSystemIntroduction.md §5.1 —
one-way directionality + drift-resolution workflow.
T04 — canonical React designbook + the missing pull tool:
- The bundled /design-sync skill only PUSHES repo->cloud; it cannot populate
designbook/. Added scripts/designbook_pull.py + `make designbook-pull`, which drives
the local claude binary headless (acceptEdits) so DesignSync fetch+write runs in a
subprocess (contents never hit the orchestrator's context). Pulled 44 files;
excludes the _whynot-design-seed/ self-copy. Corrected the docs that wrongly called
/design-sync the pull.
T05 — IR extractor (scripts/ir-extract.mjs + `make ir`):
- ir/tokens.json (80 tokens, DTCG, var() -> {ref} alias resolution); ir/components/*.json
(10 contracts parsed from .jsx signatures: enum/boolean/number inference, prop->attr
map, style/callback marked non-portable); ir/exemplars/*.
T06 — Lit token adapter (adapters/lit/ + `make adapt-lit`):
- Full-gen tokens into src/styles/colors_and_type.css :root (marker-bounded, idempotent
no-op on re-run; hand-authored type CSS preserved).
NOTE: token regen synced Lit to canonical React — fonts IBM Plex -> system stacks and 8
status tokens added. This is a VISUAL change: review and run `pnpm test:visual:update`
before merge. Remaining: T07 scaffold+drift, T08 parity, T09 runbook, T10 2nd-adapter.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -78,7 +78,7 @@ Establish the durable interfaces before any code, so future stacks slot in clean
|
||||
|
||||
```task
|
||||
id: WHYNOT-WP-0002-T01
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "66187d76-3755-4204-ad71-d9fae8ed38ac"
|
||||
```
|
||||
@@ -95,7 +95,7 @@ name, group, description, props (name/type/enum/default/required), **prop→attr
|
||||
|
||||
```task
|
||||
id: WHYNOT-WP-0002-T02
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "6fe8481c-02b3-407d-9b7b-c47f161c0dcd"
|
||||
```
|
||||
@@ -110,7 +110,7 @@ machine-readable **drift report**, a **parity result**), idempotency rules (rege
|
||||
|
||||
```task
|
||||
id: WHYNOT-WP-0002-T03
|
||||
status: todo
|
||||
status: done
|
||||
priority: medium
|
||||
state_hub_task_id: "97aadf8a-4d56-47d0-b841-d664d0676a53"
|
||||
```
|
||||
@@ -128,7 +128,7 @@ triaged/closed), and how this extends the existing atelier→repo pipeline. Upda
|
||||
|
||||
```task
|
||||
id: WHYNOT-WP-0002-T04
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "ed4dd1d4-f649-40f0-83f5-9cbd88622a7b"
|
||||
```
|
||||
@@ -149,7 +149,7 @@ a minimal token-plus-core-components React designbook is enough to prove the pip
|
||||
|
||||
```task
|
||||
id: WHYNOT-WP-0002-T05
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "dcdc0b01-756f-4253-9599-e5d5dfbe1083"
|
||||
```
|
||||
@@ -168,7 +168,7 @@ T01. Add `make ir`. `ir/` is committed so a re-extract surfaces blueprint change
|
||||
|
||||
```task
|
||||
id: WHYNOT-WP-0002-T06
|
||||
status: todo
|
||||
status: done
|
||||
priority: high
|
||||
state_hub_task_id: "a106c673-e849-4d06-91c9-3f7f63fec2ea"
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user