@hegemonart/get-design-done 1.59.5 → 1.59.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hegemonart/get-design-done",
-  "version": "1.59.5",
+  "version": "1.59.7",
   "description": "A design-quality pipeline for AI coding agents: brief, explore, plan, design, and verify UI work against your design system.",
   "author": "Hegemon",
   "homepage": "https://github.com/hegemonart/get-design-done",

package/reference/skill-graph.md

@@ -9,7 +9,7 @@ is a `composes_with` edge (the source calls the target as sub-orchestration); a
 a `next_skills` edge (a pipeline hint for what runs next). Stage grouping is best-effort and
 inferred from the skill name; skills with no stage keyword fall under Utility.
 
-Skills: 95. Composition edges: 19 composes_with, 6 next_skills.
+Skills: 96. Composition edges: 20 composes_with, 7 next_skills.
 
 ```mermaid
 flowchart TD
@@ -78,6 +78,7 @@ flowchart TD
     n_fast["fast"]
     n_figma_extract["figma-extract"]
     n_graphify["graphify"]
+    n_handoff["handoff"]
     n_health["health"]
     n_help["help"]
     n_instinct["instinct"]
@@ -138,6 +139,8 @@ flowchart TD
   n_explore --> n_list_assumptions
   n_explore --> n_sketch
   n_explore -.-> n_plan
+  n_handoff --> n_verify
+  n_handoff -.-> n_verify
   n_new_cycle --> n_brief
   n_new_project --> n_brief
   n_new_project -.-> n_brief

package/scripts/lib/install/doctor-codex-plugin.cjs

@@ -20,7 +20,7 @@
  * path is COMPUTED (pure string composition via `os.homedir()`), NOT
  * verified. The maintainer verifies the cache after running the field-
  * test command on a Codex-installed machine (see
- * docs/codex-plugin-field-test.md).
+ * the maintainer field-test notes).
  *
  * Phase 28.8 D-14: the `.claude-plugin/marketplace.json` catalog file is
  * reused from Claude Code's marketplace per Codex's legacy-compatible

package/scripts/lib/install/doctor-cursor-marketplace.cjs

@@ -137,14 +137,14 @@ function readJsonFileSafe(filePath) {
 function buildGuidance(r) {
   switch (r.state) {
     case MARKETPLACE_STATES.NOT_SUBMITTED:
-      return 'submit publisher application at cursor.com/marketplace/publish; see docs/cursor-marketplace-field-test.md';
+      return 'submit publisher application at cursor.com/marketplace/publish';
     case MARKETPLACE_STATES.SUBMITTED_PENDING:
       return 'await Cursor team review approval; no published SLA per D-16';
     case MARKETPLACE_STATES.APPROVED_PUBLISHED:
       return 'plugin is live at ' + (r.marketplaceUrl || '<marketplace-url>');
     case MARKETPLACE_STATES.REJECTED:
       return 'address rejection reason: ' + (r.rejectionReason || '<unspecified>')
-        + '; re-submit per docs/cursor-marketplace-field-test.md';
+        + '; re-submit at cursor.com/marketplace/publish';
     default:
       return '';
   }

package/scripts/lib/manifest/skills.json

@@ -218,6 +218,19 @@
       "name": "graphify",
       "description": "Manage the Graphify knowledge graph for the current project. Build, query, status, diff. When available, design-planner and design-integration-checker use the graph for pre-search consultation."
     },
+    {
+      "name": "handoff",
+      "description": "Handoff-first entry point that initializes a cycle from a Claude Design handoff bundle (URL, ZIP, HTML, PDF, or PPTX), skips the explore/plan stages, and routes straight to post-handoff verify. Thin wrapper over the Handoff Routing logic in the root pipeline router and the claude-design connection. Use when a Claude Design bundle was sent or dropped into the project and you want to implement and verify it without re-running discovery, or when arguments start with handoff or contain --from-handoff.",
+      "argument_hint": "<bundle-path-or-url>",
+      "user_invocable": true,
+      "tools": "Read, Write, Bash, Glob, Grep, Task",
+      "composes_with": [
+        "verify"
+      ],
+      "next_skills": [
+        "verify"
+      ]
+    },
     {
       "name": "health",
       "description": "Reports .design/ artifact health - staleness, missing files, token drift, broken state transitions. Activates for requests involving checking .design artifact health, staleness, token drift, or broken state transitions.",

package/scripts/skill-templates/handoff/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: gdd-handoff
+description: "Handoff-first entry point that initializes a cycle from a Claude Design handoff bundle (URL, ZIP, HTML, PDF, or PPTX), skips the explore/plan stages, and routes straight to post-handoff verify. Thin wrapper over the Handoff Routing logic in the root pipeline router and the claude-design connection. Use when a Claude Design bundle was sent or dropped into the project and you want to implement and verify it without re-running discovery, or when arguments start with handoff or contain --from-handoff."
+argument-hint: "<bundle-path-or-url>"
+user-invocable: true
+tools: Read, Write, Bash, Glob, Grep, Task
+---
+
+# gdd-handoff
+
+Initialize a design cycle from a Claude Design handoff bundle, then route to verify in
+post-handoff mode. This skill is the named home for the inline **Handoff Routing** block in
+the root pipeline router (`SKILL.md`); invoking `{{command_prefix}}handoff <path>` runs the
+same sequence. See `connections/claude-design.md` for bundle formats and parsing rules.
+
+## Role
+
+You do no design work yourself. You resolve a handoff bundle, seed `.design/STATE.md` for a
+handoff-sourced cycle, dispatch the synthesizer + discussant agents, and hand off to the
+verify skill. Stages scan/discover/plan are skipped by design - a handoff bundle replaces them.
+
+## Invocation Contract
+
+- **Input**: a bundle path or hosted URL as the argument, OR `--from-handoff <path>`, OR a
+  previously-recorded `handoff_path` in `.design/STATE.md`.
+- **Output**: a handoff-sourced `.design/STATE.md` and a routed call to
+  `Skill("get-design-done:verify", "--post-handoff")`.
+
+## Procedure
+
+### 1. Resolve the bundle path
+
+- `{{command_prefix}}handoff <path>` -> bundle path is the argument.
+- `--from-handoff <path>` -> bundle path is the value after the flag.
+- A `https://api.anthropic.com/v1/design/h/<hash>` URL in the arguments -> treat as the bundle.
+- None of the above -> read `handoff_path` from `.design/STATE.md`. Still absent -> error:
+  "Provide a bundle path: {{command_prefix}}handoff ./path/to/bundle.html".
+- For a file path: verify the file exists; if not, error "Bundle not found at <path>".
+
+### 2. Initialize STATE.md
+
+- If `.design/STATE.md` does not exist, copy `reference/STATE-TEMPLATE.md` to `.design/STATE.md`.
+- In `<position>` set: `handoff_source` (per the bundle format - see the claude-design
+  connection table), `handoff_path: <resolved path>`, `skipped_stages: scan, discover, plan`,
+  `status: handoff-sourced`, `stage: verify`.
+- In `<connections>` set `claude_design: available`; leave every other connection unchanged.
+
+### 3. Spawn the synthesizer in handoff mode
+
+```
+Task("design-research-synthesizer", """
+mode: handoff
+handoff_path: <resolved bundle path>
+state_path: .design/STATE.md
+""")
+```
+
+Wait for `## SYNTHESIZE COMPLETE`.
+
+### 4. Spawn the discussant in from-handoff mode
+
+```
+Task("design-discussant", """
+<mode>--from-handoff</mode>
+<required_reading>.design/STATE.md</required_reading>
+""")
+```
+
+Wait for `## DISCUSS COMPLETE`. This step surfaces every `(tentative)` decision for user
+confirmation; do not skip it - implementing against unconfirmed inferred values is the primary
+handoff failure mode.
+
+### 5. Route to verify
+
+```
+Skill("get-design-done:verify", "--post-handoff")
+```
+
+Verify relaxes the DESIGN-PLAN.md prerequisite for handoff flows and adds a Handoff
+Faithfulness section to DESIGN-VERIFICATION.md.
+
+### 6. Optional write-back (post-verify)
+
+After verify completes without FAIL-level gaps, check STATE.md `<connections>` for `figma:`.
+If `figma: available`, offer to write implementation status back to Figma (annotates frames +
+Code Connect mappings) via `agents/design-figma-writer.md` with `mode: implementation-status`.
+Skip silently when figma is `not_configured` or `unavailable`.
+
+## Do Not
+
+- Do not run scan, discover, or plan - the bundle replaces them.
+- Do not promote PDF/PPTX-sourced decisions to `(locked)` without explicit user confirmation.
+- Do not commit raw extracted bundle files - only persist decisions to STATE.md.
+
+## Cross-references
+
+- `connections/claude-design.md` - bundle formats, field catalogue, confidence tagging.
+- Root `SKILL.md` `## Handoff Routing` - the inline routing this skill wraps.
+- `get-design-done:verify` (`--post-handoff`) - the stage this skill routes to.

package/skills/handoff/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: gdd-handoff
+description: "Handoff-first entry point that initializes a cycle from a Claude Design handoff bundle (URL, ZIP, HTML, PDF, or PPTX), skips the explore/plan stages, and routes straight to post-handoff verify. Thin wrapper over the Handoff Routing logic in the root pipeline router and the claude-design connection. Use when a Claude Design bundle was sent or dropped into the project and you want to implement and verify it without re-running discovery, or when arguments start with handoff or contain --from-handoff."
+argument-hint: "<bundle-path-or-url>"
+user-invocable: true
+tools: Read, Write, Bash, Glob, Grep, Task
+---
+
+# gdd-handoff
+
+Initialize a design cycle from a Claude Design handoff bundle, then route to verify in
+post-handoff mode. This skill is the named home for the inline **Handoff Routing** block in
+the root pipeline router (`SKILL.md`); invoking `/gdd:handoff <path>` runs the
+same sequence. See `connections/claude-design.md` for bundle formats and parsing rules.
+
+## Role
+
+You do no design work yourself. You resolve a handoff bundle, seed `.design/STATE.md` for a
+handoff-sourced cycle, dispatch the synthesizer + discussant agents, and hand off to the
+verify skill. Stages scan/discover/plan are skipped by design - a handoff bundle replaces them.
+
+## Invocation Contract
+
+- **Input**: a bundle path or hosted URL as the argument, OR `--from-handoff <path>`, OR a
+  previously-recorded `handoff_path` in `.design/STATE.md`.
+- **Output**: a handoff-sourced `.design/STATE.md` and a routed call to
+  `Skill("get-design-done:verify", "--post-handoff")`.
+
+## Procedure
+
+### 1. Resolve the bundle path
+
+- `/gdd:handoff <path>` -> bundle path is the argument.
+- `--from-handoff <path>` -> bundle path is the value after the flag.
+- A `https://api.anthropic.com/v1/design/h/<hash>` URL in the arguments -> treat as the bundle.
+- None of the above -> read `handoff_path` from `.design/STATE.md`. Still absent -> error:
+  "Provide a bundle path: /gdd:handoff ./path/to/bundle.html".
+- For a file path: verify the file exists; if not, error "Bundle not found at <path>".
+
+### 2. Initialize STATE.md
+
+- If `.design/STATE.md` does not exist, copy `reference/STATE-TEMPLATE.md` to `.design/STATE.md`.
+- In `<position>` set: `handoff_source` (per the bundle format - see the claude-design
+  connection table), `handoff_path: <resolved path>`, `skipped_stages: scan, discover, plan`,
+  `status: handoff-sourced`, `stage: verify`.
+- In `<connections>` set `claude_design: available`; leave every other connection unchanged.
+
+### 3. Spawn the synthesizer in handoff mode
+
+```
+Task("design-research-synthesizer", """
+mode: handoff
+handoff_path: <resolved bundle path>
+state_path: .design/STATE.md
+""")
+```
+
+Wait for `## SYNTHESIZE COMPLETE`.
+
+### 4. Spawn the discussant in from-handoff mode
+
+```
+Task("design-discussant", """
+<mode>--from-handoff</mode>
+<required_reading>.design/STATE.md</required_reading>
+""")
+```
+
+Wait for `## DISCUSS COMPLETE`. This step surfaces every `(tentative)` decision for user
+confirmation; do not skip it - implementing against unconfirmed inferred values is the primary
+handoff failure mode.
+
+### 5. Route to verify
+
+```
+Skill("get-design-done:verify", "--post-handoff")
+```
+
+Verify relaxes the DESIGN-PLAN.md prerequisite for handoff flows and adds a Handoff
+Faithfulness section to DESIGN-VERIFICATION.md.
+
+### 6. Optional write-back (post-verify)
+
+After verify completes without FAIL-level gaps, check STATE.md `<connections>` for `figma:`.
+If `figma: available`, offer to write implementation status back to Figma (annotates frames +
+Code Connect mappings) via `agents/design-figma-writer.md` with `mode: implementation-status`.
+Skip silently when figma is `not_configured` or `unavailable`.
+
+## Do Not
+
+- Do not run scan, discover, or plan - the bundle replaces them.
+- Do not promote PDF/PPTX-sourced decisions to `(locked)` without explicit user confirmation.
+- Do not commit raw extracted bundle files - only persist decisions to STATE.md.
+
+## Cross-references
+
+- `connections/claude-design.md` - bundle formats, field catalogue, confidence tagging.
+- Root `SKILL.md` `## Handoff Routing` - the inline routing this skill wraps.
+- `get-design-done:verify` (`--post-handoff`) - the stage this skill routes to.