Claude Code Pilot

Universal Claude Code configuration for any project. Bundles two complementary systems:

• GSD (Get Shit Done) v1.22.4 — Methodology. Spec-driven development with fresh 200k contexts per task. Prevents context rot.
• ECC (Everything Claude Code) v1.8.0 — Toolbox. Session persistence, continuous learning, verification, quality gates. Prevents knowledge loss.

One command to install. /setup wizard auto-configures everything.

Install

cd your-project
npx claude-code-pilot
claude
> /setup

The Workflow

npx claude-code-pilot            ← install (once)
claude → /setup                         ← wizard scans codebase, generates CLAUDE.md

# Development
/gsd:discuss-phase 1                    ← GSD: capture requirements
/gsd:plan-phase 1                       ← GSD: atomic plans
/checkpoint create "before-impl"        ← ECC: snapshot
/gsd:execute-phase 1                    ← GSD: build with fresh contexts
/verify                                 ← ECC: build → types → lint → tests → security
/gsd:verify-work 1                      ← GSD: does it match the spec?
/save-session                           ← ECC: persist for next session
/learn                                  ← ECC: extract reusable patterns

# Next session
/resume-session                         ← ECC: load previous context
/evolve                                 ← ECC: promote instincts → skills
/kit:update                             ← update everything

What's Included (254 files after install)

GSD — Methodology (32 commands, 12 agents)

| Command | What | |---------|------| | /gsd:new-project | Initialize with roadmap and milestones | | /gsd:discuss-phase N | Capture requirements | | /gsd:plan-phase N | Atomic plans (max 3 tasks per subagent) | | /gsd:execute-phase N | Build in fresh 200k contexts | | /gsd:verify-work N | Goal-backward verification | | /gsd:quick "task" | Same quality, lighter process | | /gsd:progress | Milestone progress | | /gsd:help | All 32 commands |

12 specialized subagents: executor, planner, verifier, debugger, codebase-mapper, roadmapper, etc.

ECC — Toolbox (9 commands, 6 agents, 3 skills)

| Command | What | |---------|------| | /verify | 6-phase quality check (build, types, lint, tests, security, diff) | | /checkpoint | Git-backed snapshots with before/after comparison | | /save-session | Persist what worked, what didn't, exact next step | | /resume-session | Load previous session context | | /learn | Extract reusable patterns from session | | /evolve | Promote learned instincts into skills/commands/agents | | /quality-gate | On-demand quality pipeline | | /model-route | Recommend model tier (Haiku/Sonnet/Opus) | | /sessions | List, load, alias saved sessions |

6 agents: architect, code-reviewer, security-reviewer, tdd-guide, e2e-runner, doc-updater.

3 skills: continuous-learning-v2 (instinct system), strategic-compact, verification-loop.

Kit — Infrastructure

| Feature | What | |---------|------| | /setup wizard | Scans codebase, generates CLAUDE.md, installs language rules | | /setup:refresh | Updates config after project changes | | /kit:update | Updates kit + GSD + ECC | | Safety hooks | Blocks rm -rf, DROP TABLE, push --force; protects .env/lock files | | Notifications | Desktop alerts (task complete, idle, permission needed) | | Context modes | dev.md, research.md, review.md | | Language rules | 9 common + 7 language-specific sets (activated by /setup) |

How GSD and ECC Work Together

| | GSD | ECC | |---|---|---| | Purpose | Structure how to work | Ensure quality of work | | Core | Phases, milestones, subagents | Verification, learning, persistence | | Verification | "Does it match the spec?" | "Is it production-ready?" | | Context | Fresh 200k per task | Strategic compact, pre-compact save | | Knowledge | Plans in files | Instincts that evolve into skills | | Persistence | Atomic commits | Session files with full context |

Hooks (13 total)

| Hook | Event | Source | |------|-------|--------| | Command blocker | PreToolUse:Bash | Kit | | File protection | PreToolUse:Write|Edit | Kit | | Context monitor | PostToolUse | GSD | | GSD update check | SessionStart | GSD | | Kit update check | SessionStart | Kit | | Session loader | SessionStart | ECC | | Session saver | Stop | ECC | | Pre-compact save | PreCompact | ECC | | Strategic compact | PreToolUse:Edit|Write | ECC | | Task completed | Stop | Kit | | Idle prompt | Notification | Kit | | Permission needed | Notification | Kit | | Statusline | Always | GSD |

Language Rules

The installer copies 9 common rules (always active) and 7 language-specific rule sets into available-rules/. The /setup wizard detects your language and activates the matching set.

Available: TypeScript, Python, Go, Swift, Kotlin, PHP, Perl.

Self-Updating

On every session start, the kit checks npm for new versions. When available, the agent sees: "⬆️ Pilot update available. Run /kit:update."

# From Claude Code:
/kit:update

# From terminal:
npx claude-code-pilot@latest --update

Updates preserve your CLAUDE.md, architecture docs, and settings customizations.

CLI

npx claude-code-pilot [options]

  -l, --local       Install to .claude/ (default)
  -g, --global      Install to ~/.claude/
  -u, --update      Update existing installation
  --uninstall       Remove kit files (preserves CLAUDE.md)
  -h, --help        Show help

Credits

• GSD by TÂCHES (MIT)
• ECC by Affaan Mustafa (MIT)
• find-skills by Vercel Labs
• Context7 by Upstash