@hegemonart/get-design-done 1.14.3 → 1.14.5

package/skills/figma-write/SKILL.md

@@ -24,10 +24,9 @@ Flags:
 
 ## Prerequisites
 
-1. Figma desktop app running with Dev Mode enabled
-2. Remote Figma MCP registered: `claude mcp add figma --transport http https://mcp.figma.com/v1/sse`
-3. `.design/DESIGN-CONTEXT.md` exists (run `discover` first)
-4. `figma: available` in `.design/STATE.md` `<connections>` block
+1. Remote Figma MCP registered (writes are remote-only). Preferred: `claude plugin install figma@claude-plugins-official`. Manual: `claude mcp add --transport http figma https://mcp.figma.com/mcp`.
+2. `.design/DESIGN-CONTEXT.md` exists (run `discover` first)
+3. `.design/STATE.md` `<connections>` shows `figma: available (…, writes=true)`. If `writes=false` (desktop-only variant), writes are not supported — the agent will STOP with an instruction to install the remote MCP.
 
 ## Required Reading
 

package/skills/new-project/SKILL.md

@@ -43,7 +43,7 @@ One-time project initialization. Replaces "run scan cold" by gathering context u
    Files named `design-*-conventions.md` are read by explore/plan/design.
    Populated by `/gdd:sketch-wrap-up` and manual edits.
    ```
-10. Print: "Project initialized. Run `/gdd:brief` to capture your design problem, or `/gdd:explore` to scan directly."
+10. Print: "Project initialized. Run `/gdd:brief` to capture your design problem, or `/gdd:explore` to scan directly. Run `/gdd:connections` to wire up optional integrations (Figma, Storybook, Chromatic, etc.)."
 
 ## Do Not
 

package/skills/progress/SKILL.md

@@ -31,6 +31,16 @@ Next: /gdd:<next-stage>
 
 Recommend next stage via the same logic as `/gdd:next` (route by which artifacts exist).
 
+### First-run connection nudge
+
+After the pipeline state block, check STATE.md `<connections>`. If every entry is `not_configured` AND `.design/config.json > connections_onboarding` is absent (user has never run the wizard), append once:
+
+```
+Tip: run /gdd:connections to see what integrations can plug in (Figma, Storybook, Chromatic, etc.).
+```
+
+Suppress the nudge on subsequent invocations in the same session (track via a transient marker file `.design/.connections-nudge-shown` written at first emit, deleted on next session start by no mechanism — so effectively once per session).
+
 ## Step 3 — Forensic audit (only if `--forensic`)
 
 Run these six checks and print PASS/WARN/FAIL per check:

package/skills/scan/SKILL.md

@@ -39,18 +39,30 @@ At scan entry, before running any step:
 
 Run both probes below. MCP tools may be in the deferred tool set — **always call ToolSearch first**; without it, a deferred tool invocation fails silently.
 
-**Figma probe (single probe covers both reads and writes — remote MCP exposes `get_metadata`, `get_variable_defs`, `use_figma` on the same server):**
+**Figma probe (variant-agnostic — resolves any server prefix matching `/figma/i`):**
 
 ```
-Step A1 — ToolSearch check:
-  ToolSearch({ query: "select:mcp__figma__get_metadata", max_results: 1 })
-  → Empty result      → figma: not_configured  (skip all Figma steps)
-  → Non-empty result  → proceed to Step A2
+Step A1 — Keyword ToolSearch:
+  ToolSearch({ query: "figma get_metadata use_figma", max_results: 10 })
 
-Step A2 — Live tool call:
-  call mcp__figma__get_metadata
-  → Success           → figma: available   (reads AND use_figma writes both available)
-  → Error             → figma: unavailable  (skip all Figma steps)
+  Parse results for tool names matching:
+    - /^mcp__([^_]*figma[^_]*)__get_metadata$/i  → read-capable prefix set
+    - /^mcp__([^_]*figma[^_]*)__use_figma$/i     → write-capable prefix set
+
+  Empty read set      → figma: not_configured   (skip all Figma steps)
+  One or more matches → proceed to Step A2
+
+Step A2 — Tiebreaker selection:
+  Preference order when multiple read prefixes match:
+    1. Prefer prefixes that appear in BOTH read set and write set
+    2. Prefer `figma` (canonical remote server name)
+    3. Prefer non-`figma-desktop`
+    4. Alphabetical
+
+Step A3 — Live tool call on resolved prefix:
+  call mcp__<prefix>__get_metadata
+  → Success → figma: available (prefix=mcp__<prefix>__, writes=<true|false>)
+  → Error   → figma: unavailable  (skip all Figma steps)
 ```
 
 **Refero probe:**
@@ -138,6 +150,14 @@ Write: graphify: <status> to STATE.md <connections>
 
 After all 4 probes, STATE.md `<connections>` contains all 4 status entries (plus the Wave A `figma:` and `refero:` probes = 6 total entries). Downstream plans (08-02 through 08-05) read these values without re-probing.
 
+**First-run connection nudge:** after writing STATE.md, check whether every probed connection came back `not_configured` AND `.design/config.json > connections_onboarding` is absent. If so, print once at the end of scan output:
+
+```
+Tip: run /gdd:connections to walk through setup for Figma, Storybook, Chromatic, and 9 other integrations.
+```
+
+Suppress the nudge if any probe returned `available` or `unavailable`, or if the user has already run `/gdd:connections` (marker: `connections_onboarding` block present or previously drained).
+
 ### Write STATE.md
 
 Update `.design/STATE.md` with probe results:
@@ -228,7 +248,7 @@ Produce a color inventory table:
 
 ### If `figma: available`
 
-Call `mcp__figma__get_variable_defs` (no arguments — returns all variables in the active Figma file).
+Read the resolved prefix from STATE.md `<connections>` (e.g., `prefix=mcp__figma__` or `prefix=mcp__figma-desktop__`) and call `{prefix}get_variable_defs` (no arguments — returns all variables in the active Figma file).
 
 > If no Figma file is open, the call errors. Treat any error as a graceful skip: update STATE.md `<connections>` to `figma: unavailable` and continue with Step 2 results only.
 

package/skills/verify/SKILL.md

@@ -28,13 +28,14 @@ Run at stage entry, after reading STATE.md:
 ```
 Step P1 — ToolSearch check:
   ToolSearch({ query: "Claude_Preview", max_results: 5 })
-  → Empty result      → preview: not_configured  (skip all Preview steps in this stage)
+  → Empty result      → preview: not_loaded  (MCP not registered — skip all Preview steps in this stage)
   → Non-empty result  → proceed to Step P2
 
 Step P2 — Live tool call:
   call mcp__Claude_Preview__preview_list
-  → Success           → preview: available
-  → Error             → preview: unavailable
+  → Success                               → preview: available
+  → Error containing "permission"/blocked → preview: permission_denied
+  → Any other error                       → preview: unreachable
 
 Write preview status to .design/STATE.md <connections>.
 ```