Enable /design-sync round-trip (Claude Design ↔ repo, no zip) #92

Closed
opened 2026-07-02 01:08:43 +02:00 by timothy · 1 comment
Owner

Enable the /design-sync round-trip so new screens can move Claude Design → repo without manual zip exports.

Context: the ChicoryTV Design System is imported at design-system/ (mirror of Claude Design project eb3b6122-45fe-40fd-aac1-1f825a11a2ff). The DesignSync MCP tool works from the main session; the /design-sync skill itself is not yet installed locally.

Do

  • Install/enable the /design-sync skill in this environment.
  • Verify a full round-trip: pull a changed/new component from the Claude Design project into design-system/, and push a local change back, against the real project id — no zip.
  • Document the workflow in docs/ (prototype in Claude Design → /design-sync pull → implement in web/), including the localDir (design-system/) and how it maps to the project structure.

Acceptance: a new prototype created in Claude Design can be pulled into the repo and implemented with no zip download.

Enable the /design-sync round-trip so new screens can move Claude Design → repo without manual zip exports. **Context:** the ChicoryTV Design System is imported at `design-system/` (mirror of Claude Design project `eb3b6122-45fe-40fd-aac1-1f825a11a2ff`). The `DesignSync` MCP tool works from the main session; the `/design-sync` skill itself is not yet installed locally. **Do** - Install/enable the `/design-sync` skill in this environment. - Verify a full round-trip: pull a changed/new component from the Claude Design project into `design-system/`, and push a local change back, against the real project id — no zip. - Document the workflow in `docs/` (prototype in Claude Design → `/design-sync` pull → implement in `web/`), including the localDir (`design-system/`) and how it maps to the project structure. **Acceptance:** a new prototype created in Claude Design can be pulled into the repo and implemented with no zip download.
timothy added this to the Design system (Claude Design ↔ prod) milestone 2026-07-02 01:08:43 +02:00
timothy added the frontend label 2026-07-02 01:08:43 +02:00
timothy added a new dependency 2026-07-02 01:08:43 +02:00
Author
Owner

Closing — round-trip verified end-to-end during #93 (PR #138)

What was done: the design-sync round-trip is live, exercised by the Settings screen with zero zip exports:

  • Push: Settings.jsx prototype + app.html wiring + design_handoff_settings/ bundle written to the Claude Design project (eb3b6122-…) via the DesignSync MCP (finalize_plan → write_files with localPath from design-system/ as localDir).
  • Pull: get_file on the remote handoff verified byte-identical with the local mirror; list_files provides the structural diff for future incremental pulls.
  • Docs: workflow documented in docs/design-sync.md (main 9497df0d) — the pieces, the 7-step per-screen workflow as practiced in #93, and gotchas (deletes: [] required, @dsCard manifest, token-name verification against the SPA).

Deviation from the issue text: no separate /design-sync skill was installed — the DesignSync MCP tool (main session only) plus the documented procedure IS the workflow; a skill wrapper adds nothing today. Reopen if a packaged skill becomes worthwhile.

Acceptance met: a new prototype moved Claude Design ↔ repo and was implemented in the SPA with no zip download (#93 / PR #138).

## Closing — round-trip verified end-to-end during #93 (PR #138) **What was done**: the design-sync round-trip is live, exercised by the Settings screen with zero zip exports: - **Push**: `Settings.jsx` prototype + `app.html` wiring + `design_handoff_settings/` bundle written to the Claude Design project (`eb3b6122-…`) via the DesignSync MCP (`finalize_plan` → `write_files` with `localPath` from `design-system/` as localDir). - **Pull**: `get_file` on the remote handoff verified byte-identical with the local mirror; `list_files` provides the structural diff for future incremental pulls. - **Docs**: workflow documented in `docs/design-sync.md` (main 9497df0d) — the pieces, the 7-step per-screen workflow as practiced in #93, and gotchas (`deletes: []` required, `@dsCard` manifest, token-name verification against the SPA). **Deviation from the issue text**: no separate `/design-sync` skill was installed — the DesignSync MCP tool (main session only) plus the documented procedure IS the workflow; a skill wrapper adds nothing today. Reopen if a packaged skill becomes worthwhile. **Acceptance met**: a new prototype moved Claude Design ↔ repo and was implemented in the SPA with no zip download (#93 / PR #138).
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Reference: timothy/ersatztv#92