/test
I'll intelligently run tests based on your current context and actively help fix failures.
How it fires
How this command gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/test
Context preview
What this command does when you run it.
I'll intelligently run tests based on your current context and actively help fix failures.
Command definition
test.mdSmart Test Runner - Context Aware
I'll intelligently run tests based on your current context and actively help fix failures.
**Context Detection First:** Let me understand what context I'm in:
1. **Cold Start** (no previous context):
- Run full test suite with coverage
- Generate complete health report
- Identify chronic failures
2. **Active Session** (you're implementing features):
- Check git diff for modified files
- Read CLAUDE.md for session goals
- Test ONLY what you've been working on
- Incremental testing as you code
3. **Post-Command Context**:
- After `/scaffold`: Test the new component
- After `/fix-todos`: Test modified files
- After `/fix-imports`: Re-run previously failed tests
- After `/security-scan`: Security-focused tests
- After `/format`: Quick smoke tests only
4. **Debug Context** (previous test failures):
- Focus on failed tests with verbose output
- Add strategic debug logging
- Run in isolation mode
5. **Pre-Commit Context**:
- Full suite + lint + typecheck
- Coverage report for PR
- No skipped tests allowed
**Phase 1: Deep Project Analysis** Using native tools to understand your testing setup:
- **Glob** to find configuration files in project root
- **Read** test configurations and CI/CD workflows
- **Grep** test patterns to understand testing style
- **Read** documentation for test instructions
I'll detect:
- Test frameworks and runners
- Test file patterns and locations
- Coverage requirements
- Integration vs unit test separation
- CI/CD test commands
**Phase 2: Intelligent Test Execution** I'll run tests with appropriate flags for maximum insight based on your project's testing framework, using verbose output and fail-fast when available to quickly identify issues.
**Build & Compilation Check:**
- Verify project builds successfully before running tests
- Watch console output for compilation errors
- Capture and analyze build warnings that might affect tests
- Check for missing dependencies or version conflicts
**Real-time Monitoring:**
# Monitor test execution with timestamps
# Capture both stdout and stderr
# Watch for timeout patterns
# Track memory usage if tests hang
**Phase 3: Failure Analysis & Auto-Fix** When tests fail, I'll:
1. **Parse failure output** to understand exact issues 2. **Read failing test** to understand expectations 3. **Read implementation** to find the bug 4. **Analyze patterns** from similar tests that pass 5. **Apply fixes** when confident
**Common fixes I'll attempt:**
- Async/await timing issues
- Mock/stub configuration
- Import path problems
- Type mismatches
- Null/undefined handling
- Off-by-one errors
- Environment variable issues
**Phase 4: Advanced Diagnostics** For complex failures:
- Run single test in isolation
- Add debug logging strategically
- Check test dependencies and setup/teardown
- Verify test data and fixtures
- Analyze flaky test patterns
**Log Analysis:**
- **Read** test output logs for hidden errors
- **Grep** for common error patterns in console output
- Analyze stack traces to pinpoint exact failure location
- Check for environment-specific issues in logs
- Identify resource conflicts (ports, files, databases)
**Console Pattern Detection:**
- Memory leaks ("JavaScript heap out of memory")
- Port conflicts ("address already in use")
- Permission errors ("EACCES", "Permission denied")
- Timeout issues ("Timeout - Async callback")
- Module resolution failures
- Database connection issues
**Phase 5: Coverage & Quality** After fixing tests:
- Run coverage report if available
- Identify untested code paths
- Suggest critical missing tests
- Check for test anti-patterns
When I find multiple issues, I'll create a todo list to fix them systematically.
**Build Failure Recovery:** If build fails before tests:
- Analyze compilation errors in detail
- Check for missing dependencies
- Verify environment setup
- Suggest specific fixes based on error patterns
- Offer to install missing packages if detected
**Smart Context-Based Strategy:** Based on the detected context, I'll choose the optimal approach:
- **No Context**: Full test discovery and execution
- **Active Development**: Watch mode on changed files only
- **Post-Implementation**: Test coverage for new code
- **Debugging Mode**: Isolated test with maximum verbosity
- **Pre-Deploy**: Complete validation suite
**Intelligent Test Selection:**
# Context: After implementing UserService
# I'll run: UserService tests + integration tests that use it
# Context: After /scaffold user-auth
# I'll run: New user-auth tests + smoke tests
# Context: Fixing failing tests
# I'll run: Only the specific failing test with debug info
**Session Awareness:**
- Read session goals from CLAUDE.md
- Track all modified files during session
- Prioritize tests based on session objectives
- Generate session test report at the end
**Integration with other commands:**
- After `/test` failures → `/create-todos` to track fixes
- Complex failures → `/explain-like-senior` for deep analysis
- Test improvements → `/review` for quality check
- Session testing → `/session-end` includes test summary
**Important**: I will NEVER:
- Modify tests to pass incorrectly
- Remove failing tests without fixing
- Reduce test coverage
- Compromise test integrity
- Add "Co-authored-by" or any Claude signatures
- Include "Generated with Claude Code" or similar messages
- Modify git config or user credentials
- Add any AI/assistant attribution to the commit
This ensures your tests truly validate your code while maximizing development speed.
Read more
Smart Test Runner - Context Aware
I'll intelligently run tests based on your current context and actively help fix failures.
**Context Detection First:** Let me understand what context I'm in:
1. **Cold Start** (no previous context):
- Run full test suite with coverage
- Generate complete health report
- Identify chronic failures
2. **Active Session** (you're implementing features):
- Check git diff for modified files
- Read CLAUDE.md for session goals
- Test ONLY what you've been working on
- Incremental testing as you code
3. **Post-Command Context**:
- After `/scaffold`: Test the new component
- After `/fix-todos`: Test modified files
- After `/fix-imports`: Re-run previously failed tests
- After `/security-scan`: Security-focused tests
- After `/format`: Quick smoke tests only
4. **Debug Context** (previous test failures):
- Focus on failed tests with verbose output
- Add strategic debug logging
- Run in isolation mode
5. **Pre-Commit Context**:
- Full suite + lint + typecheck
- Coverage report for PR
- No skipped tests allowed
**Phase 1: Deep Project Analysis** Using native tools to understand your testing setup:
- **Glob** to find configuration files in project root
- **Read** test configurations and CI/CD workflows
- **Grep** test patterns to understand testing style
- **Read** documentation for test instructions
I'll detect:
- Test frameworks and runners
- Test file patterns and locations
- Coverage requirements
- Integration vs unit test separation
- CI/CD test commands
**Phase 2: Intelligent Test Execution** I'll run tests with appropriate flags for maximum insight based on your project's testing framework, using verbose output and fail-fast when available to quickly identify issues.
**Build & Compilation Check:**
- Verify project builds successfully before running tests
- Watch console output for compilation errors
- Capture and analyze build warnings that might affect tests
- Check for missing dependencies or version conflicts
**Real-time Monitoring:**
# Monitor test execution with timestamps # Capture both stdout and stderr # Watch for timeout patterns # Track memory usage if tests hang
**Phase 3: Failure Analysis & Auto-Fix** When tests fail, I'll:
1. **Parse failure output** to understand exact issues 2. **Read failing test** to understand expectations 3. **Read implementation** to find the bug 4. **Analyze patterns** from similar tests that pass 5. **Apply fixes** when confident
**Common fixes I'll attempt:**
- Async/await timing issues
- Mock/stub configuration
- Import path problems
- Type mismatches
- Null/undefined handling
- Off-by-one errors
- Environment variable issues
**Phase 4: Advanced Diagnostics** For complex failures:
- Run single test in isolation
- Add debug logging strategically
- Check test dependencies and setup/teardown
- Verify test data and fixtures
- Analyze flaky test patterns
**Log Analysis:**
- **Read** test output logs for hidden errors
- **Grep** for common error patterns in console output
- Analyze stack traces to pinpoint exact failure location
- Check for environment-specific issues in logs
- Identify resource conflicts (ports, files, databases)
**Console Pattern Detection:**
- Memory leaks ("JavaScript heap out of memory")
- Port conflicts ("address already in use")
- Permission errors ("EACCES", "Permission denied")
- Timeout issues ("Timeout - Async callback")
- Module resolution failures
- Database connection issues
**Phase 5: Coverage & Quality** After fixing tests:
- Run coverage report if available
- Identify untested code paths
- Suggest critical missing tests
- Check for test anti-patterns
When I find multiple issues, I'll create a todo list to fix them systematically.
**Build Failure Recovery:** If build fails before tests:
- Analyze compilation errors in detail
- Check for missing dependencies
- Verify environment setup
- Suggest specific fixes based on error patterns
- Offer to install missing packages if detected
**Smart Context-Based Strategy:** Based on the detected context, I'll choose the optimal approach:
- **No Context**: Full test discovery and execution
- **Active Development**: Watch mode on changed files only
- **Post-Implementation**: Test coverage for new code
- **Debugging Mode**: Isolated test with maximum verbosity
- **Pre-Deploy**: Complete validation suite
**Intelligent Test Selection:**
# Context: After implementing UserService # I'll run: UserService tests + integration tests that use it # Context: After /scaffold user-auth # I'll run: New user-auth tests + smoke tests # Context: Fixing failing tests # I'll run: Only the specific failing test with debug info
**Session Awareness:**
- Read session goals from CLAUDE.md
- Track all modified files during session
- Prioritize tests based on session objectives
- Generate session test report at the end
**Integration with other commands:**
- After `/test` failures → `/create-todos` to track fixes
- Complex failures → `/explain-like-senior` for deep analysis
- Test improvements → `/review` for quality check
- Session testing → `/session-end` includes test summary
**Important**: I will NEVER:
- Modify tests to pass incorrectly
- Remove failing tests without fixing
- Reduce test coverage
- Compromise test integrity
- Add "Co-authored-by" or any Claude signatures
- Include "Generated with Claude Code" or similar messages
- Modify git config or user credentials
- Add any AI/assistant attribution to the commit
This ensures your tests truly validate your code while maximizing development speed.
Best Claude Code framework that actually save time. Built by a dev tired of typing "please act like a senior engineer" in every conversation.
Repo: notlikeDev/CCPlugins
Other commands on ccplugins.
- /cleanproject
I'll help clean up development artifacts while preserving your working code.
Open command - /commit
I'll analyze your changes and create a meaningful commit message.
Open command - /create-todos
I'll analyze recent operations and create contextual TODO comments in your code.
Open command - /docs
I'll intelligently manage your project documentation by analyzing what actually happened and updating ALL relevant docs accordingly.
Open command - /explain-like-senior
I'll explain this code as a senior developer would, focusing on the why behind decisions.
Open command - /find-todos
I'll locate all TODO comments and unfinished work markers in your codebase.
Open command

