{ "schema_version": 1, "note": "Skill metadata SoT (Phase 41.5 seed = the live skills/ dir names). Phase 47 enriches each record (aliases, pin, description budget).", "skills": [ { "name": "add-backlog", "description": "Park a design idea for a future cycle. Writes to .design/backlog/BACKLOG.md.", "argument_hint": "[text]", "tools": "Read, Write, AskUserQuestion", "disable_model_invocation": true }, { "name": "analyze-dependencies", "description": "Queries the intel store to surface token fan-out, component call-graphs, decision traceability, and circular dependency detection. Requires .design/intel/ to exist (run build-intel.cjs first).", "tools": "Bash, Read, Glob, Grep" }, { "name": "apply-reflections", "description": "Review and selectively apply proposals from .design/reflections/.md. Diffs each proposal, prompts user to accept/skip/edit, then writes changes.", "argument_hint": "[--cycle ] [--filter ] [--dry-run]", "tools": "Read, Write, Edit, Bash, Glob", "composes_with": [ "audit" ] }, { "name": "audit", "description": "Run a design audit by spawning design-auditor, design-integration-checker, and (optionally) design-verifier + design-reflector agents, then printing a consolidated 7-pillar score summary. Use when the user wants to score the current design, retroactively verify a completed cycle, or quickly re-check after a fix. Activates for requests involving scoring an existing design, retroactively reviewing quality, or re-checking after a fix.", "argument_hint": "[--retroactive] [--quick] [--no-reflect]", "tools": "Read, Write, Task, Glob, Bash" }, { "name": "bandit-reset", "description": "Confirm-then-reset the per-(agent, bin, delegate) bandit posterior - backs up .design/telemetry/posterior.json to posterior.json.bak, then clears it to a fresh empty envelope. Mutation companion to read-only bandit-status. Use when the posterior is corrupted/unparseable, after a major agent/skill roster change invalidates accumulated arms, or when you deliberately want to rebootstrap adaptive routing from informed priors.", "argument_hint": "[--yes to skip the confirmation prompt]", "tools": "Read, Write, Bash, AskUserQuestion", "disable_model_invocation": true }, { "name": "bandit-status", "description": "Surface read-only per-(agent, bin, delegate) bandit posterior snapshot - alpha/beta/mean/stddev/count/last-used per arm. Phase 27.5 (v1.27.5) diagnostic. Use when investigating 'why did the bandit pick tier X for agent Y?' or when verifying posterior convergence after enabling adaptive_mode: full.", "argument_hint": "", "tools": "Read, Bash" }, { "name": "benchmark", "description": "Harvest and synthesize per-component design benchmarks from 18 design systems and produce canonical component specs at `reference/components/.md`. Use when adding a new component spec, running a benchmark wave, listing corpus coverage, or refreshing a spec after a design-system version bump.", "argument_hint": " | --wave | --list | --refresh ", "tools": "Read, Write, Bash, Grep, Glob, Task, WebFetch" }, { "name": "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 {{command_prefix}}explore finds no existing design system. Never invents a brand; never overwrites an existing DS.", "argument_hint": "[--primary ] [--secondary ] [--tone ] [--framework web|native-ios|native-android|flutter]", "user_invocable": true, "tools": "Read, Write, Bash, Glob, Grep, AskUserQuestion, Task" }, { "name": "brief", "description": "Stage 1 of 5 design intake that captures problem statement, audience, constraints, success metrics, and scope into .design/BRIEF.md, and bootstraps .design/STATE.md if missing. Use when starting a new design cycle and before {{command_prefix}}explore. Activates for requests involving capturing a problem statement, defining audience and constraints, or starting a new design brief.", "argument_hint": "[--re-brief to redo intake on existing project]", "tools": "Read, Write, AskUserQuestion, mcp__gdd_state__frontmatter_update, mcp__gdd_state__set_status, mcp__gdd_state__update_progress, mcp__gdd_state__get", "composes_with": [ "explore" ], "next_skills": [ "explore" ] }, { "name": "budget", "description": "Forecasts GDD design-cycle spend before the bill arrives. Reads .design/telemetry/costs.jsonl (cost per cycle) + .design/budget.json (the project_cap), runs the pure cost-forecast model via agents/cost-forecaster.md, and projects the next N cycles - surfacing 'at the current rate you'll hit your $X project cap in Y cycles.' Supports --scenario best|typical|worst and --cycles N. Read-only - it forecasts and warns; it never spends, edits budget.json, or halts (the budget-enforcer hook halts). Use to sanity-check spend trajectory before a long run.", "argument_hint": "[--cycles N] [--scenario best|typical|worst]", "user_invocable": true, "tools": "Read, Bash, Grep, Glob, ToolSearch, Task" }, { "name": "cache-manager", "description": "Maintains .design/cache-manifest.json for Layer B explicit cache per D-08. Computes deterministic SHA-256 input-hash from (agent-path + sorted-input-file-paths + input-content-hashes). On spawn: lookup key → return cached blob if within TTL, else miss. On completion: write result + TTL. Consulted by hooks/budget-enforcer.ts before every Agent spawn.", "user_invocable": false, "tools": "Read, Bash, Write", "disable_model_invocation": true }, { "name": "check-update", "description": "Manual plugin-update check. Shows cached state by default; --refresh bypasses the 24h TTL; --dismiss hides the nudge until a newer release ships; --prompt spawns design-update-checker for a richer summary.", "argument_hint": "[--refresh] [--dismiss] [--prompt]", "tools": "Read, Write, Bash, Task" }, { "name": "compare", "description": "Compute the delta between the `DESIGN.md` baseline (from explore) and the `DESIGN-VERIFICATION.md` result (from verify), reporting per-category score delta, anti-pattern delta (resolved vs new), must-have pass/fail change, and design drift (regressions without covering tasks in `DESIGN-PLAN.md`). Use after `verify` to measure whether a design pipeline cycle actually improved the design. Writes `.design/COMPARE-REPORT.md`. Activates for requests involving diffing a design baseline against verification output, or a before-after design delta.", "argument_hint": "", "user_invocable": true, "composes_with": [ "verify" ] }, { "name": "complete-cycle", "description": "Cycle closeout command that marks CYCLES.md entry complete, archives pipeline artifacts to .design/archive/cycle-N/, generates EXPERIENCE.md, rebuilds the search index, and resets STATE.md. Use when a design cycle has shipped and you're ready to start the next one.", "argument_hint": "[]", "tools": "Read, Write, Bash, AskUserQuestion", "composes_with": [ "audit" ] }, { "name": "connections", "description": "Interactive onboarding wizard for the 33 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`, `launchdarkly`, `statsig`, `growthbook`, `usertesting`, `maze`, `hotjar`), recommends based on project type, walks the user through setup (auto-run MCP install or copy-command fallback), writes results to `STATE.md `. Use after `{{command_prefix}}new-project` or whenever the user wants to add, inspect, or skip a connection. Re-runnable anytime. Activates for requests involving setting up external integrations, probing Figma or preview or storybook, or onboarding tools.", "argument_hint": "[list | | --auto]", "user_invocable": true, "tools": "Read, Write, Bash, Glob, Grep, AskUserQuestion, ToolSearch" }, { "name": "context", "description": "Queries the typed DesignContext graph at .design/context-graph.json - the design-semantic map of tokens, components, variants, states, motion, a11y patterns, screens, layers, and design patterns plus the edges between them. Lists and filters nodes and edges, traces a path between two nodes, finds the consumers of a node, and reports unreachable nodes, dependency cycles, and coverage. Use when the user wants to inspect the design graph, find what depends on a token or component, trace how one node reaches another, or check graph health. Activates for requests involving the design context graph, design dependencies, token consumers, component composition, unreachable design nodes, design cycles, or design coverage.", "argument_hint": "[nodes --type X | edges --type Z | path | consumers-of | unreachable | cycles | coverage]", "tools": "Read, Bash", "user_invocable": true, "registered_in_phase": "52" }, { "name": "continue", "description": "Alias for {{command_prefix}}resume - restore session context from the most recent checkpoint.", "argument_hint": "[]", "tools": "Read, Write, Bash, Glob", "disable_model_invocation": true }, { "name": "darkmode", "description": "Audit a project's dark mode implementation - detects architecture (CSS custom props, Tailwind `dark:` prefix, or JS class toggle), runs architecture-specific contrast / token-override / anti-pattern / meta-property checks, and writes a prioritized fix list to `.design/DARKMODE-AUDIT.md`. Use when the user wants to verify dark mode quality without re-running the full design pipeline. Read-only - no score writeback to `DESIGN.md`. Activates for requests involving auditing dark mode, checking dark-theme contrast, or dark-mode anti-patterns.", "argument_hint": "", "user_invocable": true, "composes_with": [ "audit" ] }, { "name": "debug", "description": "Symptom-driven design debugger with persistent state. Phase 1 builds a feedback loop; Phase 2 hypothesizes. Writes findings to .design/DEBUG.md. Use when a symptom needs systematic, one-variable-at-a-time tracking.", "argument_hint": "[]", "tools": "Read, Write, Grep, Glob, AskUserQuestion, Task" }, { "name": "design", "frontmatter_name": "design", "description": "Stage 4 of 5 orchestrator that reads DESIGN-PLAN.md, partitions tasks by wave + parallel-safe flag, and spawns design-executor agents with the appropriate isolation (worktree for parallel batches, in-place for sequential tail). Use when DESIGN-PLAN.md is approved and ready for implementation. Activates for requests involving implementing UI, building components, or turning a plan into working interface code.", "argument_hint": "[--auto] [--parallel] [--variants N]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob, Task, AskUserQuestion, mcp__gdd_state__get, mcp__gdd_state__transition_stage, mcp__gdd_state__update_progress, mcp__gdd_state__set_status, mcp__gdd_state__add_blocker, mcp__gdd_state__resolve_blocker, mcp__gdd_state__checkpoint", "composes_with": [ "figma-write", "paper-write", "pencil-write" ], "next_skills": [ "verify" ] }, { "name": "discuss", "description": "Adaptive design interview command that spawns design-discussant in normal / --all / --spec mode to gather decisions via one-question-at-a-time AskUserQuestion, writing D-XX entries to STATE.md . Use when locking design decisions outside the main pipeline or backfilling missing context.", "argument_hint": "[topic] [--all] [--spec] [--cycle ]", "tools": "Read, Write, Task", "composes_with": [ "list-assumptions" ] }, { "name": "do", "description": "Natural-language design task router. Parses your intent, maps to the right gdd command(s), confirms before executing. Activates for requests involving a natural-language design request, routing intent to the right command, or not knowing which skill to use.", "argument_hint": "", "tools": "Read, Write, AskUserQuestion" }, { "name": "explore", "description": "Stage 2 of 5 - unified exploration merging inventory grep + design interview. Probes 6 connections, scans the codebase, conducts the AskUserQuestion interview, and writes .design/DESIGN.md + DESIGN-DEBT.md + DESIGN-CONTEXT.md. Use after {{command_prefix}}brief to map the existing system and lock decisions before planning. Activates for requests involving researching design direction, gathering references, or exploring visual options.", "argument_hint": "[--skip-interview] [--skip-scan] [--incremental] [--full]", "tools": "Read, Write, Bash, Grep, Glob, Task, AskUserQuestion, mcp__gdd_state__get, mcp__gdd_state__transition_stage, mcp__gdd_state__probe_connections, mcp__gdd_state__update_progress, mcp__gdd_state__set_status, mcp__gdd_state__add_blocker, mcp__gdd_state__checkpoint, mcp__gdd_state__add_decision", "composes_with": [ "discuss", "list-assumptions", "sketch" ], "next_skills": [ "plan" ] }, { "name": "export", "description": "Packages a completed design cycle (.design artifacts + decisions + screenshots) into a stakeholder-shareable artifact - self-contained HTML, print-styled PDF (Paged.js-compatible), or a Notion page. Redacts secrets; --pseudonymize masks identity for external sharing; --pr posts the HTML preview as a PR comment. Use to hand a design-review packet to PMs/execs/brand who aren't in the repo.", "argument_hint": " --format html|pdf|notion [--pseudonymize] [--pr]", "user_invocable": true, "tools": "Read, Write, Bash, Glob, Grep, ToolSearch, Task" }, { "name": "extract-learnings", "description": "Extracts project-specific design patterns and decisions from .design/ artifacts and writes them to .design/learnings/. Optionally proposes updates to reference/ files for user review.", "tools": "Bash, Read, Write, Glob, Grep" }, { "name": "fast", "description": "Trivial inline design task. No subagents, no planning documents, no pipeline stages. Just do the thing described. Activates for requests involving a single quick design fix, a one-shot change, or a fast targeted edit.", "argument_hint": "", "tools": "Read, Write, Edit, Bash, Grep, Glob", "disable_model_invocation": true }, { "name": "figma-extract", "description": "Off-context Figma design-system extraction into a compact local digest (DESIGN.md + tokens.json + components.json). Pulls the file via the Figma REST API and digests it without the raw JSON ever entering the model context." }, { "name": "figma-write", "description": "Write design decisions from `.design/DESIGN-CONTEXT.md` back into the active Figma file by dispatching the `design-figma-writer` agent in one of three modes (annotate / tokenize / mappings). Use when the user has completed a design pipeline cycle and wants the decisions (layer comments, variable bindings, or Code Connect mappings) reflected in Figma. Operates proposal→confirm with `--dry-run` and `--confirm-shared` flags." }, { "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": "", "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.", "tools": "Read, Bash, Glob, Grep, mcp__gdd_state__get", "disable_model_invocation": true }, { "name": "help", "description": "Lists all available get-design-done commands with one-line descriptions", "tools": "Read", "disable_model_invocation": true }, { "name": "instinct", "description": "Inspects and manages atomic instinct learning units - small, scoped, confidence-weighted patterns the pipeline accumulates across cycles. Lists the project and global instinct stores, searches them by keyword, and promotes a vetted project instinct to the global store once it has cleared the cross-project gate. Use when the user wants to see what instincts exist, find an instinct by topic, or promote one to global scope. Activates for requests involving instincts, learned patterns, instinct promotion, instinct search, or the instinct store.", "argument_hint": "[list | query | promote ] [--scope project|global] [--domain ]", "tools": "Read, Bash", "user_invocable": true, "registered_in_phase": "51" }, { "name": "list-assumptions", "description": "Surfaces hidden design assumptions baked into the codebase before planning - pattern-based detection plus user-surfaced items.", "argument_hint": "[--area typography|color|layout|motion|a11y]", "tools": "Read, Grep, Glob", "disable_model_invocation": true }, { "name": "list-pins", "description": "Lists pinned skill aliases per harness with their source skill and pin timestamp. Use when you want to see which gdd skills have been pinned as standalone shortcuts and where.", "tools": "Read, Bash", "registered_in_phase": "46" }, { "name": "live", "description": "Live in-browser design mode. The user picks a DOM element on a running dev server (via the Claude Preview MCP), the agent generates N design variants in one batch, they hot-swap in place through HMR or preview_eval using a data-gdd-variant marker, the user accepts or discards, and the whole pick-generate-accept loop persists to .design/live-sessions so it survives a crash or resume. Use when the user wants to iterate on the look of a live component against a real running server, asks to try variants on a page, or runs the live command with a url; falls back to a screenshot-only degraded mode on harnesses without MCP support. Activates for requests involving in-browser design iteration, picking an element on a dev server, or generating variants with hot-swap.", "argument_hint": "[--variants N] [--resume ] [url]", "tools": "Read, Write, Edit, Bash, Glob, Grep, Task", "user_invocable": true, "registered_in_phase": "47" }, { "name": "locale", "description": "Inspects or sets the GDD CLI locale for this project. With no argument, reports the resolved locale (config.locale > env LANG > en), the fallback chain, and per-locale coverage (which message tables are complete vs placeholder). With a (en/ru/uk/de/fr/zh/ja), sets .design/config.json#locale after previewing the change. Localizes --help, common error messages, and skill prompt headers via scripts/lib/i18n/; missing keys fall back to English, so a partial locale never breaks the CLI. Use to switch GDD's own output language.", "argument_hint": "[]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob" }, { "name": "map", "description": "Dispatches 5 specialist codebase mappers in parallel. Produces .design/map/*.md files consumed by the explore stage.", "argument_hint": "[--only tokens|components|visual-hierarchy|a11y|motion]", "tools": "Read, Write, Bash, Task", "user_invocable": true }, { "name": "migrate", "description": "Migrates a project off GDD's own deprecated paths after an upgrade. Reads the machine-readable registry in reference/DEPRECATIONS.md (via scripts/lib/deprecation-registry.cjs), scans the project's .design/config.json + any local skill/agent references for paths that are now deprecated or removed at the installed version, and PREVIEWS a diff before changing anything. Interactive by default (confirm per change); --yes auto-applies; --dry-run previews only. Read-first, never silent. Use after {{command_prefix}}update flags a breaking change.", "argument_hint": "[--yes] [--dry-run]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob" }, { "name": "migrate-context", "description": "Migrates a pre-Phase-52 project from the flat .design/map/*.md mapper notes to the typed DesignContext graph at .design/context-graph.json. Reads the old map notes, runs the deterministic extract-*.mjs passes to build mapper fragments, merges them with merge-fragments.mjs, validates the result with validate-design-context.cjs, and flags every low-confidence transform for human review before anything is trusted. Read-first and reversible; --dry-run previews the plan without writing. Use when upgrading a project to the DesignContext graph and .design/map/*.md still holds the only structured design notes. Activates for requests involving migrating design maps, building the context graph from old notes, or DesignContext graph migration.", "argument_hint": "[--dry-run]", "tools": "Read, Write, Bash", "user_invocable": true, "registered_in_phase": "52" }, { "name": "new-addendum", "description": "Scaffolds a new Phase-54 composable reference addendum for a design-system, framework, or motion library: validates the kind and the slug, defaults composes_into by kind, and writes a 4-section skeleton at reference/{systems|frameworks|motion}/.md from the pure generator. Use when adding stack-specific guidance that an explore mapper should compose at spawn time and you want the frontmatter, the composes_into wiring, and the mandatory sections correct from the first commit. Activates for requests involving authoring a reference addendum, adding stack-specific mapper guidance, scaffolding a systems or frameworks or motion doc, or registering a new design-system.", "argument_hint": " ", "tools": "Read, Write, Bash, AskUserQuestion", "user_invocable": true, "registered_in_phase": "54" }, { "name": "new-cycle", "description": "Start a new design cycle. Creates cycle scope in STATE.md, initializes .design/CYCLES.md entry. Each cycle has its own goal and tracks its own decisions/tasks/pipeline runs.", "argument_hint": "[]", "tools": "Read, Write, AskUserQuestion", "composes_with": [ "brief" ] }, { "name": "new-project", "description": "Initialize a new get-design-done project. Gathers project context, creates PROJECT.md and STATE.md, initializes first cycle. Run once per project before any pipeline stage.", "argument_hint": "[--name ]", "tools": "Read, Write, AskUserQuestion, Bash, Glob", "composes_with": [ "brief" ], "next_skills": [ "brief" ] }, { "name": "new-skill", "description": "Scaffolds a new Phase-28.5 + Phase-50-compliant skill: gathers a name, a multi-paragraph v3 description, a lifecycle stage, an allowed-tools list, and optional composes_with neighbours, then writes scripts/skill-templates//SKILL.md from the pure generator. Use when adding a brand-new gdd skill and you want the frontmatter, length cap, and v3 description form correct from the first commit. Activates for requests involving authoring a skill, scaffolding a command, creating a new SKILL.md, or adding a slash command.", "argument_hint": "", "tools": "Read, Write, Bash, AskUserQuestion", "user_invocable": true, "registered_in_phase": "50" }, { "name": "next", "description": "Routes to the next pipeline stage based on current STATE.md position", "tools": "Read, Write, mcp__gdd_status, mcp__gdd_phase_current, mcp__gdd_plans_list", "disable_model_invocation": true }, { "name": "note", "description": "Zero-friction idea capture during any stage. Appends to .design/NOTES.md. Subcommands: add, list, promote.", "argument_hint": " [text|line-number]", "tools": "Read, Write", "disable_model_invocation": true }, { "name": "openrouter-status", "description": "Read-only OpenRouter catalog + tier-mapping diagnostic - surfaces catalog freshness (fetched_at vs the 24h TTL), the last-fetch timestamp, the resolved opus/sonnet/haiku → model mappings (via the Phase-33.6 adapter), and a per-tier preview. Use when investigating which OpenRouter model a tier resolves to, or whether the catalog cache is fresh/stale. Phase 33.6 (v1.33.6) diagnostic - {{command_prefix}}openrouter-status.", "argument_hint": "[--refresh]", "tools": "Read, Bash", "disable_model_invocation": true }, { "name": "optimize", "frontmatter_name": "optimize", "description": "Reads .design/telemetry/costs.jsonl + .design/agent-metrics.json, runs rule-based analysis, writes .design/OPTIMIZE-RECOMMENDATIONS.md. Pure advisory - no auto-apply. User reviews + decides.", "argument_hint": "[--refresh] [--min-spawns=N]", "user_invocable": true, "tools": "Read, Bash, Grep, Write" }, { "name": "override", "description": "Escalation surface for a risk-blocked action or a fact-force gate. Use when the Phase 56 risk gate blocked a writer action (suggested_action=block) and a reviewer has signed off, or when the first-write fact-force gate is holding a file you have legitimately reviewed. Activates for requests involving overriding a blocked edit, approving a high-risk change, or clearing a fact-force hold on a path.", "argument_hint": "> [--approver ] [--reason ]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob", "registered_in_phase": "56" }, { "name": "paper-write", "description": "Push design decisions from `.design/DESIGN-CONTEXT.md` into the active paper.design canvas by dispatching the `design-paper-writer` agent in one of three modes (annotate / tokenize / roundtrip). Use when the user has completed a design pipeline cycle and wants the decisions reflected in their paper.design canvas. Operates proposal->confirm with `--dry-run`.", "argument_hint": " [--dry-run]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob" }, { "name": "pencil-write", "description": "Update local `.pen` source files with design decisions from `.design/DESIGN-CONTEXT.md` by dispatching the `design-pencil-writer` agent in one of two modes (annotate / roundtrip). Use when the user has completed a design pipeline cycle and wants the decisions reflected in their `.pen` files. Operates proposal->confirm with `--dry-run`.", "argument_hint": " [--dry-run]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob" }, { "name": "pause", "description": "Write a numbered checkpoint so work can resume in a new session without re-running completed stages.", "argument_hint": "[context note]", "tools": "Read, Write, Bash, AskUserQuestion, mcp__gdd_state__get, mcp__gdd_state__set_status, mcp__gdd_state__add_blocker, mcp__gdd_state__checkpoint", "disable_model_invocation": true }, { "name": "peer-cli-add", "frontmatter_name": "peer-cli-add", "description": "Guided ladder for adding a brand-new peer (not in the v1.27 capability matrix) to gdd's peer-CLI delegation layer. Walks the verification ladder, scaffolds an adapter, updates the capability matrix, and handles Windows quirks. Run when you discover a new peer CLI you want gdd to delegate to.", "argument_hint": " ", "tools": "Read, Edit, Write, Bash, Grep" }, { "name": "peer-cli-customize", "frontmatter_name": "peer-cli-customize", "description": "Rewire role->peer mappings on a per-agent basis. File-edit-driven (touches frontmatter delegate_to: per agent), no runtime config layer. Run when you want a specific agent to delegate to a different peer than the default capability-matrix mapping suggests.", "argument_hint": "[] []", "tools": "Read, Edit, Bash, Grep" }, { "name": "peers", "description": "Discover peer-CLI capability matrix - which of {codex, gemini, cursor, copilot, qwen} are installed, allowlisted in .design/config.json, and (if Phase 23.5 has data) their cost/quality delta vs local. Single command, no flags. Read by users investigating delegation setup.", "argument_hint": "", "tools": "Read, Bash" }, { "name": "pin", "description": "Writes standalone shortcut aliases for a gdd skill across installed harness skill dirs. Use when you want a skill directly discoverable as its own command in every installed runtime.", "argument_hint": "", "tools": "Read, Bash", "registered_in_phase": "46" }, { "name": "plan", "frontmatter_name": "plan", "description": "Stage 3 of 5 orchestrator that reads DESIGN-CONTEXT.md, runs optional research (phase-researcher / pattern-mapper / assumptions-analyzer / synthesizer), spawns design-planner + design-plan-checker, and writes DESIGN-PLAN.md. Use when DESIGN-CONTEXT.md is locked and you need a wave-ordered execution plan. Activates for requests involving breaking design work into steps, sequencing implementation, or planning a build.", "argument_hint": "[--auto] [--parallel]", "user_invocable": true, "tools": "Read, Write, Bash, Glob, Task, AskUserQuestion, ToolSearch, mcp__gdd_state__get, mcp__gdd_state__transition_stage, mcp__gdd_state__add_decision, mcp__gdd_state__add_must_have, mcp__gdd_state__update_progress, mcp__gdd_state__set_status, mcp__gdd_state__add_blocker, mcp__gdd_state__checkpoint, mcp__gdd_state__probe_connections", "next_skills": [ "design" ] }, { "name": "plant-seed", "description": "Forward-looking design idea with a trigger condition. Seeds surface automatically when trigger is met. Writes to .design/SEEDS.md.", "argument_hint": "[--trigger ] [text]", "tools": "Read, Write, AskUserQuestion", "disable_model_invocation": true }, { "name": "pr-branch", "description": "Create a clean PR branch by filtering out .design/ and .planning/ commits. Code-review-ready branch for the design implementation work.", "argument_hint": "[]", "tools": "Read, Write, Bash", "disable_model_invocation": true }, { "name": "progress", "description": "Shows current pipeline position and routes to next action. --forensic runs 6-check integrity audit. Activates for requests involving showing current project state, routing to the next action, or a status check.", "argument_hint": "[--forensic]", "tools": "Read, Bash, Grep, Glob, mcp__gdd_state__get, mcp__gdd_status, mcp__gdd_phase_current" }, { "name": "quality-gate", "frontmatter_name": "quality-gate", "description": "Stage 4.5 of the pipeline. Detects, runs, and classifies project quality commands (lint / typecheck / test / visual-regression) between {{command_prefix}}design and {{command_prefix}}verify; writes the most recent run to STATE.md . Non-blocking on timeout (warn + proceed); failures spawn design-fixer until the loop converges or max_iters is reached.", "tools": "Read, Write, Edit, Bash, Grep, Glob, Task", "extra_frontmatter": [ "color: amber", "model: inherit", "default-tier: haiku", "size_budget: M", "parallel-safe: conditional-on-touches", "typical-duration-seconds: 180", "reads-only: false", "writes:", " - \".design/STATE.md\"", " - \".design/events.jsonl\"" ] }, { "name": "quick", "description": "Run the pipeline with optional agents skipped for speed. Skips: phase-researcher, design-assumptions-analyzer, design-integration-checker. Keeps: planner, executor, verifier, auditor. Activates for requests involving a lightweight design pass, a fast iteration, or a quick low-ceremony change.", "argument_hint": "[--skip ] [stage]", "tools": "Read, Task", "disable_model_invocation": true }, { "name": "reapply-patches", "description": "Reapply user modifications to reference/ files after a plugin update. Detects customizations via git diff against pristine baseline.", "argument_hint": "[--dry-run]", "tools": "Read, Write, Bash", "disable_model_invocation": true }, { "name": "recall", "description": "Search cross-cycle memory: decisions, learnings, experience archives. Returns ranked matches.", "argument_hint": " [--reindex]", "tools": "Read, Write, Bash", "disable_model_invocation": true }, { "name": "reflect", "description": "Run design-reflector on demand - produces .design/reflections/.md with improvement proposals. Review proposals with {{command_prefix}}apply-reflections.", "argument_hint": "[--dry-run] [--cycle ]", "tools": "Read, Write, Task" }, { "name": "report-issue", "frontmatter_name": "report-issue", "description": "Consent-gated GitHub issue reporter for /gdd. Triages locally against `reference/known-failure-modes.md`, layers Phase 22 secret-redaction with Phase 30 pseudonymization, drafts the payload to `.design/issue-drafts/`, opens `$EDITOR` for inspection, and submits via the user's `gh` CLI to a hardcoded repo only after explicit per-issue consent. Use when the user runs `{{command_prefix}}report-issue`, hits a failure on a whitelisted command with the `--report` flag, or asks to file a bug against get-design-done.", "argument_hint": "[] [--force-report]", "tools": "Read, Write, Grep, Bash" }, { "name": "resume", "description": "Restore session context from a numbered checkpoint. Lists available checkpoints when no argument given.", "argument_hint": "[]", "tools": "Read, Write, Bash, Glob, AskUserQuestion, mcp__gdd_state__get, mcp__gdd_state__set_status, mcp__gdd_state__resolve_blocker, mcp__gdd_state__checkpoint, mcp__gdd_status, mcp__gdd_phase_current, mcp__gdd_plans_list, mcp__gdd_decisions_list", "disable_model_invocation": true }, { "name": "review-backlog", "description": "Review parked backlog items and promote any to active cycle todo.", "tools": "Read, Write, AskUserQuestion", "disable_model_invocation": true }, { "name": "review-decisions", "description": "Surfaces the async decision-review queue for team mode. Reads .design/reviews// entries and reports each decision's state in the proposed → reviewing → approved → locked machine (via scripts/lib/collab/review-queue.cjs), so a team can see what's awaiting review, what's approved, and what's locked. --pending shows only decisions still needing action. Read-only - it reports the queue; it never advances a decision (that's a reviewer's explicit call). Use to run an async design-decision review without a meeting.", "argument_hint": "[] [--pending]", "user_invocable": true, "tools": "Read, Bash, Grep, Glob" }, { "name": "roi", "description": "Shows whether GDD spend actually shipped anything. Joins per-cycle cost (.design/telemetry/costs.jsonl) with what each cycle shipped - commits that SURVIVED in main vs commits that were reverted - and reports cost-per-shipped-commit + a stick rate per cycle. 'Shipped' = a commit surviving >= the window (default 14 days), which catches revert-after-bug-discovery. Markdown table, not a GUI. Read-only - it reads git log + cost telemetry and reports. Use to see which cycles were worth their spend.", "argument_hint": "[--since ] [--window-days 14]", "user_invocable": true, "tools": "Read, Bash, Grep, Glob" }, { "name": "rollout-status", "description": "Shows where a finished design cycle actually is in production rollout - unrolled / staging-only / canary-N% / prod-100% - by reading the feature-flag service (LaunchDarkly/Statsig/GrowthBook) via the rollout-coordinator. Surfaces STUCK rollouts (a canary that hasn't advanced for N days) and the design_arms outcome weighting. Read-only - GDD never advances or rolls back; it reports and notifies. Use after {{command_prefix}}ship to track the post-merge journey.", "argument_hint": "[] [--all] [--stuck]", "user_invocable": true, "tools": "Read, Bash, Grep, Glob, ToolSearch, Task" }, { "name": "router", "description": "Routes a /gdd command to fast|quick|full path + S|M|L|XL complexity_class and returns {path, complexity_class, model_tier_overrides, resolved_models, estimated_cost_usd, cache_hits}. A SKILL.md prompt the model executes to emit a routing-decision JSON from rule tables (no separate agent spawn). Optional/advisory - invoked only by the skills that opt into routing; the budget-enforcer hook tolerates its absence. Read by hooks/budget-enforcer.ts.", "argument_hint": " []", "tools": "Read, Bash, Grep" }, { "name": "settings", "description": "Manage .design/config.json settings. Subcommands: profile, parallelism, cleanup, show.", "argument_hint": "|parallelism |cleanup|show>", "tools": "Read, Write, AskUserQuestion, Bash, mcp__gdd_state__get, mcp__gdd_state__frontmatter_update", "disable_model_invocation": true }, { "name": "ship", "description": "Post-verify PR flow - creates a clean PR branch, invokes code review check, and prepares the PR for merge. Activates for requests involving finishing a cycle, packaging design output, or moving work to a pull request.", "argument_hint": "[--title ] [--draft]", "tools": "Read, Write, Bash, AskUserQuestion, Task", "disable_model_invocation": true, "composes_with": [ "pr-branch" ] }, { "name": "sketch", "description": "Multi-variant HTML design exploration that creates .design/sketches// with N standalone variants (default 3), browser-openable directly via file:// without a build step. Use when answering 'what could this look like?' before committing to a direction.", "argument_hint": "[topic] [--variants N] [--quick]", "tools": "Read, Write, AskUserQuestion, Bash", "composes_with": [ "sketch-wrap-up" ] }, { "name": "sketch-wrap-up", "description": "Walk through sketches, pick winner + rationale, group by design area, write project skills to ./.claude/skills/design--conventions.md.", "argument_hint": "[slug]", "tools": "Read, Write, Glob, AskUserQuestion" }, { "name": "skill-manifest", "description": "Lists all registered GDD skills and agents, with descriptions, from the intel store. Falls back to directory scan if intel store not present.", "tools": "Bash, Read, Glob" }, { "name": "spike", "description": "Timeboxed feasibility experiment that creates .design/spikes// with HYPOTHESIS.md, success/failure criteria, scratch/ subdirectory, and a default 60-minute timebox. Use when answering 'can this work?' before betting design or implementation effort on a risky approach.", "argument_hint": "[hypothesis] [--timebox ]", "tools": "Read, Write, Bash, AskUserQuestion", "composes_with": [ "spike-wrap-up" ] }, { "name": "spike-wrap-up", "description": "Close a spike - capture findings, write decision to STATE.md, update SUMMARY.md.", "argument_hint": "[slug]", "tools": "Read, Write, Glob, AskUserQuestion" }, { "name": "start", "frontmatter_name": "start", "description": "First-Run Proof Path - one command that scans your UI code and returns one concrete first fix. Leaf command, no STATE.md writes, no pipeline entry. Writes .design/START-REPORT.md and exits.", "argument_hint": "[--budget ] [--skip-interview] [--dismiss-nudge]", "tools": "Read, Grep, Glob, Bash, Write, Task", "disable_model_invocation": true }, { "name": "state", "description": "Query, recover, or roll back the Phase 57 SQLite state backbone. Use when you need to inspect the decisions/blockers/plans tables with a raw SELECT, rebuild a corrupt state.sqlite from the markdown STATE.md, or revert to the markdown-only source of truth by removing state.sqlite. Activates for requests involving querying the SQLite state database, recovering from SQLite corruption, or reverting the migration (demigrate).", "argument_hint": "\" | recover | demigrate>", "user_invocable": true, "tools": "Read, Bash, Grep, Glob", "registered_in_phase": "57" }, { "name": "stats", "description": "Cycle stats - decisions made, tasks completed, commits, timeline, git metrics.", "tools": "Read, Bash", "disable_model_invocation": true }, { "name": "style", "description": "Generate a component handoff doc at `.design/DESIGN-STYLE-.md` by dispatching the `design-doc-writer` agent in one of two modes: post-pipeline (uses `DESIGN-SUMMARY.md`) or pre-pipeline fallback (uses `DESIGN.md` + source). Use when the user wants a single-component spec covering tokens, states, and AI-slop detection. Invoke with a ComponentName, or with no argument to list available components.", "argument_hint": "[ComponentName]", "user_invocable": true }, { "name": "synthesize", "frontmatter_name": "synthesize", "description": "Streaming synthesizer - collapses N parallel-agent markdown outputs into one compact merged summary via a single Haiku 4.5 call. Invoked inline by orchestrators (skills/map/, skills/explore/, skills/plan/) after parallel spawns return. Not user-invocable.", "tools": "Read, Task", "user_invocable": false, "disable_model_invocation": true }, { "name": "timeline", "description": "Narrative retrospective across cycles: reads EXPERIENCE.md files and git log to produce a timeline view.", "argument_hint": "[ | - | all]", "tools": "Read, Bash, Glob", "disable_model_invocation": true }, { "name": "todo", "description": "Design backlog - add/list/pick design tasks. Writes to .design/TODO.md.", "argument_hint": " [text]", "tools": "Read, Write, AskUserQuestion, mcp__gdd_state__get, mcp__gdd_state__add_decision, mcp__gdd_state__add_must_have", "disable_model_invocation": true }, { "name": "turn-closeout", "description": "Portable mirror of the gdd-turn-closeout Stop hook (D-11). Closes the events.jsonl gap at turn-end and surfaces a stage-completion or paused-mid-task nudge. Tail-called by orchestrator skills ({{command_prefix}}next, {{command_prefix}}design, {{command_prefix}}verify) at exit on the 13 non-Claude runtimes that lack a Stop hook surface. Idempotent, non-blocking, ≤10ms typical.", "argument_hint": "(none - reads .design/STATE.md and .design/telemetry/events.jsonl from cwd)", "tools": "Read, Bash" }, { "name": "undo", "description": "Safe design change revert. Uses git log to find design commits, checks dependencies, reverts safely.", "argument_hint": "[]", "tools": "Read, Write, Bash, AskUserQuestion", "disable_model_invocation": true }, { "name": "unlock-decision", "description": "Reopens a LOCKED design decision - the only escape hatch from the hard lock. Requires an explicit --approver and writes an audit entry, then moves the decision locked → reviewing (via scripts/lib/collab/review-queue.cjs). Previews the audit record before writing; never unlocks silently. Use when a locked decision genuinely must change (a later constraint invalidated it) and a reviewer has signed off.", "argument_hint": " --approver [--reason ] [--dry-run]", "user_invocable": true, "tools": "Read, Write, Bash, Grep, Glob" }, { "name": "unpin", "description": "Removes pinned skill aliases across harness dirs, deleting only stubs that carry the gdd pin marker. Use when you no longer want a pinned shortcut and want hand-written skills left untouched.", "argument_hint": "", "tools": "Read, Bash", "registered_in_phase": "46" }, { "name": "update", "description": "Update get-design-done to the latest release. Preserves .design/config.json and ./.claude/skills/.", "argument_hint": "[--dry-run] [--version ] [--show-privacy-diff]", "tools": "Read, Write, Bash", "disable_model_invocation": true }, { "name": "using-gdd", "frontmatter_name": "using-gdd", "description": "Use when starting any GDD session - establishes how to find and apply GDD skills.", "disable_model_invocation": true }, { "name": "verify", "frontmatter_name": "verify", "description": "Stage 5 of 5 orchestrator that spawns design-auditor, design-verifier, and design-integration-checker in sequence, interprets pass/gap result, and drives the gap-response loop (inline fix, save-and-exit, or accept-as-is). Use when implementation is complete and ready for final pre-ship verification. Activates for requests involving checking finished UI against the design system, running a pre-ship review, or final verification.", "argument_hint": "[--auto] [--post-handoff]", "user_invocable": true, "tools": "mcp__gdd_state__get, mcp__gdd_state__transition_stage, mcp__gdd_state__add_must_have, mcp__gdd_state__add_blocker, mcp__gdd_state__resolve_blocker, mcp__gdd_state__update_progress, mcp__gdd_state__set_status, mcp__gdd_state__checkpoint, mcp__gdd_state__probe_connections", "composes_with": [ "audit", "debug" ], "next_skills": [ "ship" ] }, { "name": "warm-cache", "frontmatter_name": "warm-cache", "description": "Pre-warms Anthropic's 5-min prompt cache across all agents that import reference/shared-preamble.md. Issues one no-op Haiku ping per agent so the identical preamble-first prefix lives in Anthropic's cache before a design sprint starts. Layer A of the D-08 two-layer cache. Run this once at the start of a {{command_prefix}}* sprint for ~90% input-cost savings on the first repeated spawn.", "user_invocable": true, "argument_hint": "[--agents ]", "tools": "Read, Bash, Grep", "disable_model_invocation": true }, { "name": "watch-authorities", "description": "Fetches the design-authority feed whitelist, diffs against .design/authority-snapshot.json, and writes .design/authority-report.md (consumed by {{command_prefix}}reflect). Authority monitoring only - no trend-watching.", "argument_hint": "[--refresh] [--since ] [--feed ] [--schedule ]", "tools": "Read, Write, Task, Bash" }, { "name": "zoom-out", "frontmatter_name": "zoom-out", "description": "Asks the agent to go up a layer of abstraction and map the relevant modules and callers using the project's CONTEXT.md vocabulary. Use when the user is working in an unfamiliar area of code and needs orientation before deep work.", "disable_model_invocation": true, "argument_hint": "[scope]" } ] }