Skip to content

stardust: figma-to-eds — Figma web-kit donor adapter + EDS gate suite - #315

Open
paolomoz wants to merge 1 commit into
adobe:mainfrom
paolomoz:figma-to-eds
Open

stardust: figma-to-eds — Figma web-kit donor adapter + EDS gate suite#315
paolomoz wants to merge 1 commit into
adobe:mainfrom
paolomoz:figma-to-eds

Conversation

@paolomoz

Copy link
Copy Markdown
Collaborator

Implements the --donor-figma adapter that skills/reskin/reference/donor-sources.md § 3 specs as "FUTURE, contract defined", and extends it with an EDS apply/gate layer as a new stardust skill.

What's in the skill

  • SKILL.md — two donor modes (web-kit hardened, sample-pages contract-defined), five phases (Capture → Curate → Map → Apply → Gate), reskin-contract compliance (figma-mcp provenance, canon-source artifacts, node-id citations everywhere).
  • 5 generic instruments (scripts/): figma-screenshot.mjs (PNG export via the Figma desktop MCP's streamable-HTTP endpoint — zero agent-context cost, batchable), token-probe.mjs (byte-equality custom-property + element-ramp gate), geometry-gate.mjs (variant-matrix gate from Figma metadata x/y/w/h, with gap semantics below text blocks), component-diff.mjs (scaled pixel diff, reproducible verdicts recording crop/selector/threshold), run-all-gates.mjs (full-suite sweep for shared-layer regression).
  • Method references (reference/): the Figma MCP quirk ledger (usage-scoped variables, oversized dumps, embedded Tokens-Studio spec tables), export traps (baked checkerboards, floored line boxes, non-displacing strokes, height caps, canvas offsets, JPEG-in-PNG assets), threshold discipline with named tolerance classes, the gate-matrix model, EDS mapping rules, and the divergence-attribution register (live-vs-new deltas must cite a Figma mandate).
  • Synthetic eval (eval/run-eval.mjs): 4 checks on an invented design system — token probe positive + negative (single-hex perturbation detected), geometry gate, component-diff round-trip — no Figma connection required, only a node_modules with playwright/pixelmatch/pngjs (NODE_MODULES_DIR).

Also adds a cross-reference in reskin's donor-sources.md § 3 pointing at the adapter, and a CHANGELOG entry.

Validation

Hardened on a full production run against a financial-services client's Figma web kit (not included — the skill tree is grep-gated for client vocabulary): 35 modules gated (~2,700 geometry checks, ~120 pixel gates incl. functional gates for interactive chrome), 13 page archetypes audited through the divergence register with every delta traced to a kit mandate. The eval passes 4/4.

🤖 Generated with Claude Code

…gate suite

Implements the reskin --donor-figma contract (figma-mcp provenance,
canon-source artifacts) with five generic instruments (screenshot
export over MCP HTTP, token probe, geometry gate, component diff,
suite sweep), method references (MCP quirk ledger, export traps,
threshold discipline, gate-matrix model, divergence register), and a
synthetic eval. Validated end-to-end on a production financial-services
web kit; no client data included (grep-gated).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant