Skip to content

feat(plan,verify): tool-agnostic design version pinning - #110

Merged
rshankras merged 1 commit into
mainfrom
feat/97-design-pin
Nov 4, 2026
Merged

rshankras merged 1 commit into
mainfrom
feat/97-design-pin

Conversation

@rshankras

Copy link
Copy Markdown
Owner

Closes #97.

What

Tool-agnostic design version pinning. Every design tool exports PNGs, so there's no API client, no fingerprinting and no .fig decoder.

plan: new "Design Pin" step (UI phases)

  • Pins the frames for the phase. It uses PNGs already in .planning/design/phase-N/pinned/, or asks once for an export folder.
    • Under /apple:autonomous it never asks.
    • With no design file it skips silently.
  • Hashes the frames into pin.tsv (name → sha256) and records the pin in PLAN.md:
    <design-pin source="Figma" version="v12 / 2026-11-04" link="…" scale="2x" frames=".planning/design/phase-N/pinned/"/>
  • UI tasks name their frame in <action>.
  • plan gains Bash and AskUserQuestion.

verify: new step 3.7c "Design Changes Since Pin"

  • Compares a fresh export (same scale) with the pin by name and hash. Output: added / removed / changed screens.
  • Reads both PNGs and describes the visible difference in one line.
  • The results are change requests, not defects: they never affect PASS / PARTIAL / FAIL.
  • If every screen shows as changed, it warns that the export scale probably differs.
  • Check 8 now compares against the pinned frame.

Optional Figma add-on. With FIGMA_TOKEN in the environment (never asked for in chat, never printed):

  • plan records the file's latest version id from /v1/files/<key>/versions.
  • verify skips the re-export when that id hasn't changed.

Also

  • <design-pin> added to templates/PLAN.md
  • "Design Changes Since Pin" sections in templates/VERIFICATION.md and verify's report
  • a help Planning Files row
  • CHANGELOG entry

Tested

  • The pin and compare snippets, extracted verbatim from plan.md and verify.md, ran in a temp project with frame names that include spaces (Profile Edit.png). Changing, removing and adding a frame reported changed Profile Edit.png, removed Settings.png and added Onboarding.png.
  • ./scripts/validate.sh passes and claude plugin validate . passes.
  • Not tested: the Figma versions call, because no token is set here.

🤖 Generated with Claude Code

plan pins exported PNG frames per UI phase (.planning/design/phase-N/
pinned/ + pin.tsv hashes + <design-pin> in PLAN.md); verify compares a
fresh export by name and hash and reports added/removed/changed screens
as change requests, not defects. Optional Figma version-history check
when FIGMA_TOKEN is set.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@rshankras
rshankras merged commit dee9526 into main Nov 4, 2026
2 checks passed
@rshankras
rshankras deleted the feat/97-design-pin branch November 4, 2026 14:49
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.

Design version pinning: pin exported frames per phase + image diff at verify (tool-agnostic; Figma version history optional)

1 participant