Get Magic Done (GMD)

Self-improving agent orchestration for Claude Code

npx get-magic-done-cc@latest

Why GMD

• Self-evolution — agents detect workflow gaps, author new skills, and validate them via TDD before integration.
• 19 behavioral skills — brainstorming, TDD, debugging, review, and verification patterns auto-discovered at SessionStart.
• Model-aware orchestration — Haiku, Sonnet, and Opus selected per task via a 9-cell profile x complexity routing table.
• One-command installer — npx get-magic-done-cc@latest deploys commands, agents, hooks, skills, and runtime into ~/.claude/.
• Update manager — SessionStart version check plus /gmd:update keeps installs current with a single command.

Prerequisites

• Claude Code — Anthropic's CLI. Install from https://docs.anthropic.com/en/docs/claude-code. Verify:

claude --version

• Node.js ≥ 18 — matches package.json engines.node (single source of truth). Verify:

node --version

• OS — macOS, Linux, or Windows (tested on Windows 11 + bash).

Quick Start

1. Initialize a project.

/gmd:new-project

Claude will prompt you for project name, core value, and tech stack.

2. Plan the first phase.

/gmd:plan-phase 1

Claude will decompose the phase into plans, each with verification steps.

3. Execute the phase.

/gmd:execute-phase 1

Claude will run plans in waves, commit after each, and report results.

Command Reference

Init

| Command | Description | | --- | --- | | /gmd:new-project | Initialize a new project with deep context gathering and PROJECT.md | | /gmd:new-milestone | Start a new milestone cycle — update PROJECT.md and route to requirements | | /gmd:set-profile | Switch model profile for GMD agents (quality/balanced/budget) | | /gmd:settings | Configure GMD workflow toggles and model profile | | /gmd:update | Update GMD to latest version with changelog display | | /gmd:reapply-patches | Reapply local modifications after a GMD update | | /gmd:help | Show available GMD commands and usage guide | | /gmd:join-discord | Join the GMD Discord community |

Planning

| Command | Description | | --- | --- | | /gmd:add-phase | Add phase to end of current milestone in roadmap | | /gmd:discuss-phase | Gather phase context through adaptive questioning before planning | | /gmd:insert-phase | Insert urgent work as decimal phase (e.g., 72.1) between existing phases | | /gmd:list-phase-assumptions | Surface Claude's assumptions about a phase approach before planning | | /gmd:plan-milestone-gaps | Create phases to close all gaps identified by milestone audit | | /gmd:plan-phase | Create detailed phase plan (PLAN.md) with verification loop | | /gmd:remove-phase | Remove a future phase from roadmap and renumber subsequent phases | | /gmd:research-phase | Research how to implement a phase (standalone - usually use /gmd:plan-phase instead) |

Execution

| Command | Description | | --- | --- | | /gmd:add-tests | Generate tests for a completed phase based on UAT criteria and implementation | | /gmd:add-todo | Capture idea or task as todo from current conversation context | | /gmd:check-integration | On-demand per-phase cross-phase integration check | | /gmd:check-todos | List pending todos and select one to work on | | /gmd:codex-verify | Delegate code verification to Codex CLI as an independent second-opinion agent | | /gmd:debug | Systematic debugging with persistent state across context resets | | /gmd:execute-phase | Execute all plans in a phase with wave-based parallelization | | /gmd:gemini-verify | Cross-model second-opinion verification via Gemini CLI (tiered timeouts, Sonnet fallback) | | /gmd:pause-work | Create context handoff when pausing work mid-phase | | /gmd:quick | Execute a quick task with GMD guarantees (atomic commits, state tracking) but skip optional agents | | /gmd:resolve-gap | Resolve a detected workflow gap by authoring, testing, and promoting a new skill. User-invoked only. | | /gmd:resume-work | Resume work from previous session with full context restoration | | /gmd:test-skill | Adversarial testing of a skill via subagent comparison | | /gmd:validate-phase | Retroactively audit and fill Nyquist validation gaps for a completed phase | | /gmd:verify-work | Validate built features through conversational UAT |

Milestone

| Command | Description | | --- | --- | | /gmd:audit-milestone | Audit milestone completion against original intent before archiving | | /gmd:complete-milestone | Archive completed milestone and prepare for next version |

Maintenance

| Command | Description | | --- | --- | | /gmd:cleanup | Archive accumulated phase directories from completed milestones | | /gmd:health | Diagnose planning directory health and optionally repair issues | | /gmd:map-codebase | Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents | | /gmd:progress | Check project progress, show context, and route to next action (execute or plan) |

Vault Sync

GMD's optional Obsidian vault component mirrors planning artifacts into a navigable knowledge graph. Sync via node bin/gmd-tools.cjs vault-sync --all (gated by components.obsidian.enabled in ~/.claude/get-magic-done/config.json).

Backfill is implicit. vault-sync --all walks both active milestone planning content (.planning/{phases,milestones,*.md}) and archived milestones (.planning/milestones/v*-phases/) in a single pass. There is no separate --backfill flag — running vault-sync --all against a fresh vault populates the full v1.0 → v1.3.x history alongside active-milestone content; re-running it is idempotent (no duplicates, no epoch bump on unchanged sources).

Troubleshooting

| Symptom | Fix | | --- | --- | | Install state unknown — is GMD installed? | Run /gmd:health, or cat ~/.claude/get-magic-done/VERSION to confirm the installed version. | | /gmd:* commands don't appear after install | Restart Claude Code — commands load at session start. | | npx serves an old version | Clear the npx cache: npx clear-npx-cache, then rerun npx get-magic-done-cc@latest. | | Hook log shows Cannot find module 'config.js' | Reinstall: npx get-magic-done-cc@latest. | | Skills show [disabled] unexpectedly | Run /gmd:settings to review and re-enable, or reinstall if config.json is corrupted. | | Install fails or hooks crash on older Node | Upgrade to Node.js ≥ 18 (see Prerequisites); node --version to verify. | | Non-bash shell on Windows causes path errors | Use bash (tested on Windows 11 + bash per Prerequisites). |

Built on ideas from GSD.