@hegemonart/get-design-done 1.36.3 → 1.37.2

package/skills/bootstrap-ds/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: gdd-bootstrap-ds
+description: "Bootstraps a design system for a GREENFIELD project that has none — no Figma, no tokens, no component library. Takes a brand input (primary color + optional secondary + tone tags + target framework) and emits a coherent OKLCH token system (color tints, modular type scale, 4pt/8pt spacing, radius + motion defaults) in 3 variants to pick from, then scaffolds proof components (button/input/card). Use at the start of a brand-new project, or when /gdd:discover finds no existing design system. Never invents a brand; never overwrites an existing DS."
+argument-hint: "[--primary <color>] [--secondary <color>] [--tone <tags>] [--framework web|native-ios|native-android|flutter]"
+user-invocable: true
+tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, Task
+---
+
+# /gdd:bootstrap-ds
+
+Greenfield design-system bootstrap. Closes the gap that GDD's `design-context-builder` assumes a design system already exists (in code or Figma) — a brand-new project has none. This skill is the **front door**: it collects a brand input and hands it to `agents/ds-generator.md`, which emits the token system + proof components per `reference/ds-bootstrap-rubric.md` (deterministic math in `scripts/lib/ds/token-scale.cjs`).
+
+## When to use
+
+- At the start of a brand-new project (no `tailwind.config`, no token file, no DS).
+- When `/gdd:discover` / `design-context-builder` reports **no existing design system** and the user opts to bootstrap one.
+
+If a design system **already exists**, do NOT run this — defer to `design-context-builder` (it maps the existing one). State that and stop.
+
+## Steps
+
+1. **Collect the brand input.** From flags, or via `AskUserQuestion` for anything missing:
+   - **primary** (required) — the brand color (hex / rgb / `oklch()`).
+   - **secondary** (optional) — a second brand color (emitted only if supplied — the rubric's ≤2-brand-colors rule).
+   - **tone tags** (optional) — `calm` / `corporate` / `editorial` / `playful` / `bold` (maps to the type ratio + chroma treatment).
+   - **target framework** (optional) — `web` (default) / `native-ios` / `native-android` / `flutter`. Detect from the project if absent (Phase 34 routing).
+2. **Delegate to `ds-generator`** (via `Task`): it resolves the primary to OKLCH, runs `token-scale.cjs` for **3 variants** (conservative / balanced / bold), and presents them.
+3. **Pick a variant.** Surface the 3 variants (primary `500`, type ratio, spacing baseline, radius, feel); the user picks ONE.
+4. **Emit + scaffold (proposal → confirm).** `ds-generator` emits the chosen token set (role-named CSS custom properties + the framework mapping) and scaffolds **button / input / card** as a coherence proof. Nothing is written to `src/` without confirmation.
+
+## Do Not
+
+- Do not invent a brand (no logomark, no typeface choice, no third brand color) — emit a token *system*, not an identity.
+- Do not overwrite an existing design system — defer to `design-context-builder`.
+- Do not add a color-conversion dependency — `token-scale.cjs` emits native CSS `oklch()`.
+
+## Output
+
+End with:
+
+```
+## BOOTSTRAP-DS COMPLETE
+```

package/skills/connections/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gdd-connections
-description: "Interactive onboarding wizard for the 21 external integrations the pipeline supports — probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`, `lazyweb`, `mobbin`, `slack`, `discord`, `linear`, `jira`, `notion`, `lottie`, `rive`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `/gdd:new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime."
+description: "Interactive onboarding wizard for the 27 external integrations the pipeline supports — probes all (`figma`, `refero`, `preview`, `storybook`, `chromatic`, `graphify`, `pinterest`, `claude-design`, `paper-design`, `pencil-dev`, `21st-dev`, `magic-patterns`, `lazyweb`, `mobbin`, `slack`, `discord`, `linear`, `jira`, `notion`, `lottie`, `rive`, `framer`, `penpot`, `webflow`, `v0-dev`, `plasmic`, `builder-io`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md <connections>`. Use after `/gdd:new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime."
 argument-hint: "[list | <connection-name> | --auto]"
 user-invocable: true
 tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
@@ -8,11 +8,11 @@ tools: Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch
 
 # /gdd:connections
 
-Interactive onboarding for the 21 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
+Interactive onboarding for the 27 external integrations the pipeline supports. Replaces "probe silently at scan entry and hope the user noticed" with an explicit "here is what can plug in, here is how."
 
 Canonical per-connection specs live in `../../connections/<name>.md` (one file per integration). The capability matrix + probe-pattern spec live in `../../connections/connections.md`. This skill is the **user-facing front end** for those specs.
 
-For the 21 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
+For the 27 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization, per-connection setup screen, auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts, see `./connections-onboarding.md`. For the cross-skill probe pattern + connection-handshake summary, see `../../reference/shared-preamble.md#connection-handshake-summary`. For the cross-skill output discipline, see `../../reference/shared-preamble.md#output-contract-reminders`.
 
 ---
 
@@ -38,7 +38,7 @@ For the 21 probe scripts (MCP + HTTP + CLI + file probes), bucket categorization
 
 ## Workflow
 
-1. **Probe all 21 connections** — run every probe script per `./connections-onboarding.md#step-1--probe-all-21-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) — never add new values.
+1. **Probe all 27 connections** — run every probe script per `./connections-onboarding.md#step-1--probe-all-27-connections`. MCP probes use `ToolSearch` first; HTTP / CLI / file probes follow non-MCP patterns. Merge results into `STATE.md <connections>` with the three-value schema (`available | unavailable | not_configured`) — never add new values.
 2. **Categorize + build summary** — bucket each probe result (available / recommended / optional / skipped / unavailable) using project-hint detection. Detail + recommendation mapping: `./connections-onboarding.md#step-2--bucket-categorization`.
 3. **Print summary table** — show buckets + value-prop one-liners (verbatim from `./connections-onboarding.md#step-3--summary-table`).
 4. **Route by mode** — `list` / `--auto` exits after summary; `<name>` jumps straight to Step 5; default mode opens an AskUserQuestion (configure recommended / pick one by one / configure all optional / re-check specific / exit). Routing detail: `./connections-onboarding.md#step-4--route-by-mode`.

package/skills/connections/connections-onboarding.md

@@ -9,7 +9,7 @@ last_updated: 2026-05-18
 
 Source: extracted from `skills/connections/SKILL.md` (Phase 28.5 rework — D-10 extract-then-link).
 The skill's load-bearing routing + invocation-mode dispatch stays in `../skills/connections/SKILL.md`;
-this file holds the 21 probe scripts, bucket categorization, per-connection setup screen,
+this file holds the 27 probe scripts, bucket categorization, per-connection setup screen,
 auto-run eligibility matrix, value-prop one-liners, and STATE.md / config.json write contracts.
 
 # Connections Onboarding Procedure
@@ -27,7 +27,7 @@ this file does NOT duplicate them; it points at them by name.
 
 ---
 
-## Step 1 — Probe all 21 connections
+## Step 1 — Probe all 27 connections
 
 Run every probe below in order. MCP probes call `ToolSearch` first (deferred tools fail silently without it). Write every result to `STATE.md <connections>` when done.
 
@@ -196,7 +196,49 @@ Bash: find . -name "*.riv" -not -path "*/node_modules/*" 2>/dev/null | head
   → none                               → rive: not_configured
 ```
 
-After all 21 probes complete, merge results into `STATE.md <connections>`. Preserve the three-value schema verbatim (`available | unavailable | not_configured`). Do not add new values.
+**framer:** (AI-native Wave 2 — canvas; MCP or API token)
+```
+ToolSearch({ query: "framer", max_results: 5 })
+→ Empty → framer: not_configured
+→ Non-empty → framer: available
+```
+
+**penpot:** (AI-native Wave 2 — canvas; self-hosted URL/token or cloud)
+```
+ToolSearch({ query: "penpot", max_results: 5 })
+→ Empty → penpot: not_configured
+→ Non-empty → penpot: available
+```
+
+**webflow:** (AI-native Wave 2 — generator; MCP or WEBFLOW token)
+```
+ToolSearch({ query: "webflow", max_results: 5 })
+→ Empty → webflow: not_configured
+→ Non-empty → webflow: available
+```
+
+**v0-dev:** (AI-native Wave 2 — generator; MCP-first, else V0_API_KEY)
+```
+ToolSearch({ query: "v0", max_results: 5 })
+→ Empty → v0-dev: not_configured
+→ Non-empty → v0-dev: available
+```
+
+**plasmic:** (AI-native Wave 2 — generator+canvas; MCP or token)
+```
+ToolSearch({ query: "plasmic", max_results: 5 })
+→ Empty → plasmic: not_configured
+→ Non-empty → plasmic: available
+```
+
+**builder-io:** (AI-native Wave 2 — generator; MCP-first, else BUILDER_API_KEY)
+```
+ToolSearch({ query: "builder", max_results: 5 })
+→ Empty → builder-io: not_configured
+→ Non-empty → builder-io: available
+```
+
+After all 27 probes complete, merge results into `STATE.md <connections>`. Preserve the three-value schema verbatim (`available | unavailable | not_configured`). Do not add new values.
 
 ---
 
@@ -286,6 +328,12 @@ One-line value props (use verbatim):
 | notion | export — `/gdd:export --format notion` writes a stakeholder page (degrade-to-HTML) |
 | lottie | verify — Lottie JSON motion check (frame-rate / duration / bloat / perf-budget), WARN-never-block |
 | rive | verify — Rive `.riv` motion check (size + state-machine reachability via the opt-in runtime), WARN-never-block |
+| framer | design — read Framer frames + write proposals (canvas, Wave 2) |
+| penpot | design — open-source Figma alt; read boards (self-hosted or cloud) |
+| webflow | design — read site structure as an adaptation source (Wave 2) |
+| v0-dev | generator — Vercel v0 prompt→component (MCP-first → REST + V0_API_KEY) |
+| plasmic | generator + canvas — emit code + read the Plasmic canvas |
+| builder-io | generator — Builder.io Visual Copilot (pull-only this phase) |
 
 ---
 
@@ -313,7 +361,7 @@ options:
   - "Exit"                            → emit ## CONNECTIONS COMPLETE, exit
 ```
 
-If recommended bucket is empty, swap that option for "Show all 21 and pick."
+If recommended bucket is empty, swap that option for "Show all 27 and pick."
 
 ---
 
@@ -379,6 +427,12 @@ options:
 | notion | `claude mcp add notion ...` (Notion MCP) | ✓ yes | Reversible MCP add; OAuth on first call |
 | lottie | (file-based — no install; drop a Lottie `.json` export in the repo) | n/a | Detected from Lottie exports / a `lottie-web` dep; live player opt-in |
 | rive | (file-based — no install; add a `.riv` export / `@rive-app` dep) | n/a | Detected from `.riv` files / a `@rive-app` dep; Rive runtime opt-in |
+| framer | `claude mcp add framer ...` (or API token) | ✓ yes | Reversible MCP add; canvas-category |
+| penpot | `claude mcp add penpot ...` (self-hosted URL or cloud + token) | ✓ yes | Reversible; self-host vs cloud |
+| webflow | `claude mcp add webflow ...` (or WEBFLOW token) | ✓ yes | Reversible; reads structure, not CMS authoring |
+| v0-dev | `claude mcp add v0 ...` (or V0_API_KEY) | ✓ yes | Reversible; MCP-first → REST fallback |
+| plasmic | `claude mcp add plasmic ...` (or token) | ✓ yes | Reversible; dual canvas+generator |
+| builder-io | `claude mcp add builder ...` (or BUILDER_API_KEY) | ✓ yes | Reversible; pull-only this phase |
 
 For non-auto-run connections, hide the "Run install command now" option entirely in 5.3.