claude-code-pilot 2.0.0 → 3.1.0

package/README.md

@@ -1,11 +1,6 @@
 # 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.
+Universal Claude Code configuration for any project. One-command install, auto-setup wizard, 101 commands, 51 agents, 87 skills.
 
 ## Install
 
@@ -13,117 +8,99 @@ One command to install. `/setup` wizard auto-configures everything.
 cd your-project
 npx claude-code-pilot
 claude
-> /setup
+> /ccp:setup
 ```
 
+The `/ccp:setup` wizard scans your codebase, generates a tailored `CLAUDE.md`, detects your language, and activates the matching rule set.
+
 ## The Workflow
 
 ```
-npx claude-code-pilot            ← install (once)
-claude → /setup                         ← wizard scans codebase, generates CLAUDE.md
+npx claude-code-pilot              <- install (once)
+claude -> /ccp: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
+/ccp:discuss-phase 1               <- capture requirements
+/ccp:plan-phase 1                  <- atomic plans
+/ccp:checkpoint create "before"    <- snapshot
+/ccp:execute-phase 1               <- build with fresh contexts
+/ccp:verify                        <- build, types, lint, tests, security
+/ccp:verify-work 1                 <- does it match the spec?
+/ccp:save-session                  <- persist for next session
+/ccp:learn                         <- extract reusable patterns
 
 # Next session
-/resume-session                         ← ECC: load previous context
-/evolve                                 ← ECC: promote instincts → skills
-/kit:update                             ← update everything
+/ccp:resume-session                <- load previous context
+/ccp:evolve                        <- promote instincts to skills
+/ccp:update                        <- update everything
 ```
 
-## What's Included (254 files after install)
+## What's Included (~494 files after install)
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| `/ccp:` commands | 101 | Development lifecycle, quality gates, session management, learning |
+| Agents | 51 | Planning, execution, review, testing, security, documentation |
+| Skill packs | 87 | Continuous learning, verification, strategic compaction, and more |
+| Hooks | 15 | 14 event + 1 statusLine: safety guards, context management, notifications, session persistence |
+| Common rules | 10 | Always active (coding style, security, testing, performance, etc.) |
+| Chinese language rules | 11 | Always active (zh/ translations of common rules) |
+| Language-specific rule sets | 11 | Activated by `/ccp:setup` (see Language Rules below) |
+| Context modes | 3 | dev, research, review |
+| Reference examples | 6 | CLAUDE.md examples for different project types |
+
+### Command Highlights
 
-### 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 |
+| `/ccp:setup` | Wizard: scan codebase, generate CLAUDE.md, activate language rules |
+| `/ccp:discuss-phase N` | Capture requirements for a development phase |
+| `/ccp:plan-phase N` | Create atomic plans (max 3 tasks per subagent) |
+| `/ccp:execute-phase N` | Build in fresh 200k contexts, preventing context rot |
+| `/ccp:verify` | 6-phase quality check: build, types, lint, tests, security, diff |
+| `/ccp:checkpoint` | Git-backed snapshots with before/after comparison |
+| `/ccp:save-session` | Persist what worked, what didn't, exact next step |
+| `/ccp:resume-session` | Load previous session context |
+| `/ccp:learn` | Extract reusable patterns from session |
+| `/ccp:evolve` | Promote learned instincts into skills, commands, or agents |
+
+Run `/ccp:help` for the full list of all 101 commands.
+
+## Hooks (15 total)
+
+14 event hooks and 1 statusLine, all registered automatically during install.
+
+| Hook | Event | Description |
+|------|-------|-------------|
+| Command blocker | PreToolUse:Bash | Blocks dangerous commands (rm -rf, DROP TABLE, push --force) |
+| File protection | PreToolUse:Write/Edit | Protects .env, lock files, and other sensitive files |
+| Context monitor | PostToolUse | Tracks context window usage |
+| Update check | SessionStart | Checks npm for new CCP versions |
+| Session loader | SessionStart | Loads previous session context |
+| Session saver | Stop | Persists session state on exit |
+| Pre-compact save | PreCompact | Saves context before compaction |
+| Strategic compact | PreToolUse:Edit/Write | Manages context strategically |
+| Task completed | Stop | Desktop notification on task completion |
+| Idle prompt | Notification | Desktop alert when idle |
+| Permission needed | Notification | Desktop alert when permission required |
+| Auto-format | PostToolUse:Write/Edit | Formats code after writes |
+| Agent shield | PreToolUse | Agent safety guardrails |
+| Quality gate | Stop | Final quality verification |
+| Statusline | Always | Shows project status in Claude Code status bar |
 
 ## 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.
+10 common rules are always active. 11 language-specific rule sets are available in `available-rules/` and activated by the `/ccp:setup` wizard when it detects your project language.
 
-Available: TypeScript, Python, Go, Swift, Kotlin, PHP, Perl.
+Available language rule sets: TypeScript, Python, Go, Swift, Kotlin, PHP, Perl, Java, C++, C#, Rust.
 
 ## Self-Updating
 
-On every session start, the kit checks npm for new versions. When available, the agent sees: *"⬆️ Pilot update available. Run /kit:update."*
+On every session start, CCP checks npm for new versions. When available, the agent sees a notification prompting an update.
 
 ```bash
 # From Claude Code:
-/kit:update
+/ccp:update
 
 # From terminal:
 npx claude-code-pilot@latest --update
@@ -145,7 +122,9 @@ npx claude-code-pilot [options]
 
 ## Credits
 
-- **GSD** by [TÂCHES](https://github.com/glittercowboy/get-shit-done) (MIT)
-- **ECC** by [Affaan Mustafa](https://github.com/affaan-m/everything-claude-code) (MIT)
-- **find-skills** by [Vercel Labs](https://github.com/vercel-labs/skills)
-- **Context7** by [Upstash](https://github.com/upstash/context7)
+Built on the shoulders of:
+
+- **GSD** by [TACHES](https://github.com/glittercowboy/get-shit-done) (MIT) -- spec-driven development methodology
+- **ECC** by [Affaan Mustafa](https://github.com/affaan-m/everything-claude-code) (MIT) -- session persistence and learning toolbox
+- **find-skills** by [Vercel Labs](https://github.com/vercel-labs/skills) -- skill discovery
+- **Context7** by [Upstash](https://github.com/upstash/context7) -- documentation context