Claude Code Command Selection Guide
This skill helps you choose the most appropriate command, agent, or skill for different scenarios.
Quick Decision Flowchart
graph TD
A[User Request] --> B{Request Type?}
B -->|New Feature| C[/plan]
B -->|Bug Fix| D[/tdd or build-error-resolver]
B -->|Code Review| E[/code-review or code-reviewer agent]
B -->|Testing| F[/e2e or tdd-guide agent]
B -->|Context Too Long| G[/compact]
B -->|Documentation| H[/docs or docs-lookup agent]
B -->|Looping Task| I[/loop]
B -->|Security Review| J[security-reviewer agent]
C --> K[planner agent]
D --> L{Build Failed?}
L -->|Yes| M[build-error-resolver]
L -->|No| N[tdd-guide]
E --> O[code-reviewer]
F --> P[e2e-runner]
1. Built-in Slash Commands
Session Management Commands
| Command |
Use Case |
Example |
/compact |
Context too long (>150K tokens), slow response, task phase transition |
/compact or auto-trigger |
/clear |
Start fresh conversation, clear history |
/clear |
/loop |
Periodic task execution, automated looping work |
/loop 5m check build status |
/help |
View help, learn commands |
/help |
/fast |
Need faster response (Opus 4.6 only) |
/fast |
/model |
Switch model |
/model sonnet |
Development Workflow Commands
| Command |
Use Case |
Activation Timing |
/plan |
Start new feature, architecture refactor, complex tasks |
Enter Plan Mode |
/tdd |
Write tests, TDD development workflow |
When test guidance needed |
/e2e |
E2E testing, critical user flow verification |
When browser testing needed |
/code-review |
Code quality review |
After writing code |
/build-fix |
Build failure, type errors |
When build fails |
/learn |
Extract patterns from session, learning |
Before session ends |
/skill-create |
Create new skill from git history |
When repeating patterns found |
Documentation & Query Commands
| Command |
Use Case |
Example |
/docs |
Update project documentation |
/docs |
/update-codemaps |
Update code maps |
/update-codemaps |
/remember |
Save memory to memory system |
/remember user prefers concise output |
/tasks |
View task list |
/tasks |
2. Agents Selection
Development Workflow Agents
| Agent |
Trigger Condition |
Purpose |
planner |
Complex feature request, architectural decision |
Create implementation plan |
architect |
System design, tech stack selection |
Architecture analysis and decisions |
tdd-guide |
New feature, bug fix |
TDD workflow guidance |
code-reviewer |
Invoke immediately after writing code |
Code quality review |
security-reviewer |
Handling auth, API, sensitive data |
Security vulnerability detection |
Problem Solving Agents
| Agent |
Trigger Condition |
Purpose |
build-error-resolver |
Invoke immediately when build fails |
Fix build/type errors |
e2e-runner |
Critical user flows, before PR |
E2E test execution |
refactor-cleaner |
Code maintenance, dead code cleanup |
Dead code detection and cleanup |
doc-updater |
Update docs, codemaps |
Documentation sync |
Research & Exploration Agents
| Agent |
Trigger Condition |
Purpose |
Explore |
Codebase exploration, file finding |
Quick codebase exploration |
general-purpose |
Complex multi-step tasks |
General task handling |
docs-lookup |
Query library/framework docs |
Get latest API documentation |
3. Skills Selection
Workflow Skills
| Skill |
Trigger Timing |
Purpose |
tdd-workflow |
Developing new feature/fixing bug |
Complete TDD workflow guidance |
verification-loop |
After feature completion, before PR |
Comprehensive verification (build/test/lint/security) |
strategic-compact |
Long session, context pressure |
Guide when to manually /compact |
Architecture & Pattern Skills
| Skill |
Trigger Timing |
Purpose |
frontend-patterns |
Frontend development |
React/Next.js/Vue best practices |
backend-patterns |
Backend development |
API/service architecture patterns |
api-design |
API design |
RESTful/API design standards |
mcp-server-patterns |
MCP server development |
MCP configuration and patterns |
Testing Skills
| Skill |
Trigger Timing |
Purpose |
e2e-testing |
E2E testing needs |
Playwright test generation |
security-review |
Security review needs |
OWASP Top 10 detection |
Research Skills
| Skill |
Trigger Timing |
Purpose |
deep-research |
Need deep research |
Multi-round search and research |
exa-search |
Need web search |
Web content search |
documentation-lookup |
Query library docs |
Context7 documentation query |
4. Scenario Decision Matrix
By Task Phase
| Phase |
Recommended Tool Combination |
Reason |
| Requirements Analysis |
planner + Explore |
Plan first, explore later |
| Architecture Design |
architect + api-design skill |
Professional architecture guidance |
| Pre-Development |
tdd-guide + tdd-workflow skill |
Test first |
| During Development |
Direct edit + quick iteration |
Stay in flow |
| Post-Development |
code-reviewer + verification-loop |
Quality gate |
| Testing Phase |
e2e-runner + e2e-testing skill |
Complete test coverage |
| Before PR |
security-reviewer + verification-loop |
Final verification |
| Build Failure |
build-error-resolver |
Focused fix |
By Problem Type
| Problem |
Invoke Immediately |
Note |
| Build failure |
build-error-resolver |
Minimal changes, quick fix |
| Type error |
build-error-resolver |
TypeScript specialist |
| Bug fix |
tdd-guide |
Write test then fix |
| Security vulnerability |
security-reviewer |
OWASP detection |
| Poor code quality |
code-reviewer |
Immediate review |
| Missing documentation |
doc-updater |
Auto update |
| Dead code |
refactor-cleaner |
Safe cleanup |
By Development Type
| Development Type |
Skills Combination |
| Frontend feature |
frontend-patterns + tdd-workflow |
| Backend API |
backend-patterns + api-design + tdd-workflow |
| MCP server |
mcp-server-patterns + tdd-workflow |
| Database |
database-reviewer agent |
| Security feature |
security-reviewer + security-review skill |
5. Parallel Execution Strategy
Parallelizable Scenarios
Recommended: Launch multiple independent tasks simultaneously
Scenario: Preparing PR after code completion
- Agent 1: code-reviewer (code quality)
- Agent 2: security-reviewer (security review)
- Agent 3: e2e-runner (E2E tests)
Scenario: Large refactor analysis
- Agent 1: architect (architecture analysis)
- Agent 2: Explore (code exploration)
- Agent 3: refactor-cleaner (dead code detection)
Sequential Execution Required
Cannot parallelize: Dependencies exist
Scenario: Fixing build error
- Sequence: build-error-resolver -> test verification -> code-reviewer
Scenario: New feature development
- Sequence: planner -> tdd-guide (write tests) -> implementation -> code-reviewer
6. Auto-Trigger Rules
Invoke Without User Request
| Situation |
Auto Action |
| Code written/modified |
Immediately invoke code-reviewer |
| Build fails |
Immediately invoke build-error-resolver |
| Complex feature request |
Immediately invoke planner |
| Handling auth/sensitive data |
Immediately invoke security-reviewer |
| New feature/bug fix |
Immediately invoke tdd-guide |
| Architectural decision |
Immediately invoke architect |
7. Context Management Timing
| Indicator |
Trigger /compact |
| Token > 150K |
Immediately compact |
| Slow response |
Suggest compact |
| Task phase switch |
Compact at boundary |
| Major milestone completed |
Compact then continue |
| Debugging ends -> new task |
Clear debug traces |
Best Practices:
- Compact after research, before implementation (preserve plan)
- Compact after milestone completion (clear intermediate state)
- Don't compact mid-implementation (lose variables/paths)
8. Command Cheat Sheet
Development Workflow:
/plan -> Enter planning mode (complex tasks)
/tdd -> TDD workflow
/e2e -> E2E testing
/code-review -> Code review
/build-fix -> Fix build
Session Management:
/compact -> Compact context
/clear -> Clear session
/loop -> Looping task
/fast -> Fast mode
Documentation & Memory:
/docs -> Update docs
/remember -> Save memory
/tasks -> View tasks
Help:
/help -> View all commands
9. Usage Examples
Example 1: New Feature Development
User: Add user authentication feature
Workflow:
- /plan -> planner agent creates plan
- tdd-guide -> write tests
- Implementation -> edit code
- code-reviewer -> code review
- security-reviewer -> security review (auth sensitive)
- e2e-runner -> E2E tests
- /compact -> compact after milestone completion
Example 2: Build Failure
User: npm run build failed
Workflow:
- build-error-resolver -> analyze error, minimal fix
- Verify build success
- code-reviewer -> check fix quality
Example 3: Code Refactoring
User: Refactor authentication module
Workflow:
- architect -> architecture analysis
- planner -> implementation plan
- refactor-cleaner -> dead code detection
- tdd-guide -> ensure test coverage
- Implementation -> refactor code
- verification-loop -> comprehensive verification
Core Principles:
- Plan first, implement later - Use
/plan for complex tasks
- Test first - Use
tdd-guide for new features
- Review immediately after coding - Use
code-reviewer when code complete
- Fix build immediately when failed - Use
build-error-resolver
- Review sensitive code - Use
security-reviewer for auth/API
- Verify comprehensively before PR - Use
verification-loop
1---2name: command-guide3description: Claude Code Command Selection Guide - Automatically recommend and select the right commands, agents, and skills in Claude Code. Use when: (1) user is unsure which command or tool to use, (2) needs to decide which agent/skill best fits the current task, (3) querying usage scenarios for /plan, /tdd, /compact, /loop and other commands, (4) understanding when to invoke planner, code-reviewer, build-error-resolver and other agents, (5) needs command cheat sheet or decision flowchart. Triggers: "which command to use", "which agent", "command selection", "how to use /plan", "when to use /compact", "agent selection guide", "command cheat sheet", "skill recommendation".4---56# Claude Code Command Selection Guide78This skill helps you choose the most appropriate command, agent, or skill for different scenarios.910## Quick Decision Flowchart1112```mermaid13graph TD14 A[User Request] --> B{Request Type?}15 B -->|New Feature| C[/plan]16 B -->|Bug Fix| D[/tdd or build-error-resolver]17 B -->|Code Review| E[/code-review or code-reviewer agent]18 B -->|Testing| F[/e2e or tdd-guide agent]19 B -->|Context Too Long| G[/compact]20 B -->|Documentation| H[/docs or docs-lookup agent]21 B -->|Looping Task| I[/loop]22 B -->|Security Review| J[security-reviewer agent]2324 C --> K[planner agent]25 D --> L{Build Failed?}26 L -->|Yes| M[build-error-resolver]27 L -->|No| N[tdd-guide]28 E --> O[code-reviewer]29 F --> P[e2e-runner]30```3132## 1. Built-in Slash Commands3334### Session Management Commands3536| Command | Use Case | Example |37|---------|----------|---------|38| `/compact` | Context too long (>150K tokens), slow response, task phase transition | `/compact` or auto-trigger |39| `/clear` | Start fresh conversation, clear history | `/clear` |40| `/loop` | Periodic task execution, automated looping work | `/loop 5m check build status` |41| `/help` | View help, learn commands | `/help` |42| `/fast` | Need faster response (Opus 4.6 only) | `/fast` |43| `/model` | Switch model | `/model sonnet` |4445### Development Workflow Commands4647| Command | Use Case | Activation Timing |48|---------|----------|-------------------|49| `/plan` | Start new feature, architecture refactor, complex tasks | **Enter Plan Mode** |50| `/tdd` | Write tests, TDD development workflow | When test guidance needed |51| `/e2e` | E2E testing, critical user flow verification | When browser testing needed |52| `/code-review` | Code quality review | After writing code |53| `/build-fix` | Build failure, type errors | When build fails |54| `/learn` | Extract patterns from session, learning | Before session ends |55| `/skill-create` | Create new skill from git history | When repeating patterns found |5657### Documentation & Query Commands5859| Command | Use Case | Example |60|---------|----------|---------|61| `/docs` | Update project documentation | `/docs` |62| `/update-codemaps` | Update code maps | `/update-codemaps` |63| `/remember` | Save memory to memory system | `/remember user prefers concise output` |64| `/tasks` | View task list | `/tasks` |6566---6768## 2. Agents Selection6970### Development Workflow Agents7172| Agent | Trigger Condition | Purpose |73|-------|-------------------|---------|74| `planner` | Complex feature request, architectural decision | Create implementation plan |75| `architect` | System design, tech stack selection | Architecture analysis and decisions |76| `tdd-guide` | New feature, bug fix | TDD workflow guidance |77| `code-reviewer` | **Invoke immediately after writing code** | Code quality review |78| `security-reviewer` | Handling auth, API, sensitive data | Security vulnerability detection |7980### Problem Solving Agents8182| Agent | Trigger Condition | Purpose |83|-------|-------------------|---------|84| `build-error-resolver` | **Invoke immediately when build fails** | Fix build/type errors |85| `e2e-runner` | Critical user flows, before PR | E2E test execution |86| `refactor-cleaner` | Code maintenance, dead code cleanup | Dead code detection and cleanup |87| `doc-updater` | Update docs, codemaps | Documentation sync |8889### Research & Exploration Agents9091| Agent | Trigger Condition | Purpose |92|-------|-------------------|---------|93| `Explore` | Codebase exploration, file finding | Quick codebase exploration |94| `general-purpose` | Complex multi-step tasks | General task handling |95| `docs-lookup` | Query library/framework docs | Get latest API documentation |9697---9899## 3. Skills Selection100101### Workflow Skills102103| Skill | Trigger Timing | Purpose |104|-------|----------------|---------|105| `tdd-workflow` | Developing new feature/fixing bug | Complete TDD workflow guidance |106| `verification-loop` | After feature completion, before PR | Comprehensive verification (build/test/lint/security) |107| `strategic-compact` | Long session, context pressure | Guide when to manually `/compact` |108109### Architecture & Pattern Skills110111| Skill | Trigger Timing | Purpose |112|-------|----------------|---------|113| `frontend-patterns` | Frontend development | React/Next.js/Vue best practices |114| `backend-patterns` | Backend development | API/service architecture patterns |115| `api-design` | API design | RESTful/API design standards |116| `mcp-server-patterns` | MCP server development | MCP configuration and patterns |117118### Testing Skills119120| Skill | Trigger Timing | Purpose |121|-------|----------------|---------|122| `e2e-testing` | E2E testing needs | Playwright test generation |123| `security-review` | Security review needs | OWASP Top 10 detection |124125### Research Skills126127| Skill | Trigger Timing | Purpose |128|-------|----------------|---------|129| `deep-research` | Need deep research | Multi-round search and research |130| `exa-search` | Need web search | Web content search |131| `documentation-lookup` | Query library docs | Context7 documentation query |132133---134135## 4. Scenario Decision Matrix136137### By Task Phase138139| Phase | Recommended Tool Combination | Reason |140|-------|------------------------------|--------|141| **Requirements Analysis** | `planner` + `Explore` | Plan first, explore later |142| **Architecture Design** | `architect` + `api-design` skill | Professional architecture guidance |143| **Pre-Development** | `tdd-guide` + `tdd-workflow` skill | Test first |144| **During Development** | Direct edit + quick iteration | Stay in flow |145| **Post-Development** | `code-reviewer` + `verification-loop` | Quality gate |146| **Testing Phase** | `e2e-runner` + `e2e-testing` skill | Complete test coverage |147| **Before PR** | `security-reviewer` + `verification-loop` | Final verification |148| **Build Failure** | `build-error-resolver` | Focused fix |149150### By Problem Type151152| Problem | Invoke Immediately | Note |153|---------|--------------------|------|154| Build failure | `build-error-resolver` | Minimal changes, quick fix |155| Type error | `build-error-resolver` | TypeScript specialist |156| Bug fix | `tdd-guide` | Write test then fix |157| Security vulnerability | `security-reviewer` | OWASP detection |158| Poor code quality | `code-reviewer` | Immediate review |159| Missing documentation | `doc-updater` | Auto update |160| Dead code | `refactor-cleaner` | Safe cleanup |161162### By Development Type163164| Development Type | Skills Combination |165|------------------|--------------------|166| Frontend feature | `frontend-patterns` + `tdd-workflow` |167| Backend API | `backend-patterns` + `api-design` + `tdd-workflow` |168| MCP server | `mcp-server-patterns` + `tdd-workflow` |169| Database | `database-reviewer` agent |170| Security feature | `security-reviewer` + `security-review` skill |171172---173174## 5. Parallel Execution Strategy175176### Parallelizable Scenarios177178Recommended: Launch multiple independent tasks simultaneously179180Scenario: Preparing PR after code completion181- Agent 1: code-reviewer (code quality)182- Agent 2: security-reviewer (security review)183- Agent 3: e2e-runner (E2E tests)184185Scenario: Large refactor analysis186- Agent 1: architect (architecture analysis)187- Agent 2: Explore (code exploration)188- Agent 3: refactor-cleaner (dead code detection)189190### Sequential Execution Required191192Cannot parallelize: Dependencies exist193194Scenario: Fixing build error195- Sequence: build-error-resolver -> test verification -> code-reviewer196197Scenario: New feature development198- Sequence: planner -> tdd-guide (write tests) -> implementation -> code-reviewer199200---201202## 6. Auto-Trigger Rules203204### Invoke Without User Request205206| Situation | Auto Action |207|-----------|-------------|208| Code written/modified | **Immediately invoke** `code-reviewer` |209| Build fails | **Immediately invoke** `build-error-resolver` |210| Complex feature request | **Immediately invoke** `planner` |211| Handling auth/sensitive data | **Immediately invoke** `security-reviewer` |212| New feature/bug fix | **Immediately invoke** `tdd-guide` |213| Architectural decision | **Immediately invoke** `architect` |214215---216217## 7. Context Management Timing218219| Indicator | Trigger `/compact` |220|-----------|-------------------|221| Token > 150K | Immediately compact |222| Slow response | Suggest compact |223| Task phase switch | Compact at boundary |224| Major milestone completed | Compact then continue |225| Debugging ends -> new task | Clear debug traces |226227**Best Practices**:228- Compact after research, before implementation (preserve plan)229- Compact after milestone completion (clear intermediate state)230- Don't compact mid-implementation (lose variables/paths)231232---233234## 8. Command Cheat Sheet235236```237Development Workflow:238/plan -> Enter planning mode (complex tasks)239/tdd -> TDD workflow240/e2e -> E2E testing241/code-review -> Code review242/build-fix -> Fix build243244Session Management:245/compact -> Compact context246/clear -> Clear session247/loop -> Looping task248/fast -> Fast mode249250Documentation & Memory:251/docs -> Update docs252/remember -> Save memory253/tasks -> View tasks254255Help:256/help -> View all commands257```258259---260261## 9. Usage Examples262263### Example 1: New Feature Development264265User: Add user authentication feature266267Workflow:2681. /plan -> planner agent creates plan2692. tdd-guide -> write tests2703. Implementation -> edit code2714. code-reviewer -> code review2725. security-reviewer -> security review (auth sensitive)2736. e2e-runner -> E2E tests2747. /compact -> compact after milestone completion275276### Example 2: Build Failure277278User: npm run build failed279280Workflow:2811. build-error-resolver -> analyze error, minimal fix2822. Verify build success2833. code-reviewer -> check fix quality284285### Example 3: Code Refactoring286287User: Refactor authentication module288289Workflow:2901. architect -> architecture analysis2912. planner -> implementation plan2923. refactor-cleaner -> dead code detection2934. tdd-guide -> ensure test coverage2945. Implementation -> refactor code2956. verification-loop -> comprehensive verification296297---298299**Core Principles**:3001. **Plan first, implement later** - Use `/plan` for complex tasks3012. **Test first** - Use `tdd-guide` for new features3023. **Review immediately after coding** - Use `code-reviewer` when code complete3034. **Fix build immediately when failed** - Use `build-error-resolver`3045. **Review sensitive code** - Use `security-reviewer` for auth/API3056. **Verify comprehensively before PR** - Use `verification-loop`