Skip to content
Development
Command

/test

I'll intelligently run tests based on your current context and actively help fix failures.

From plugin
ccplugins
2.8k23 skills23 commands

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.md

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.

Read more
Ships withccplugins

Best Claude Code framework that actually save time. Built by a dev tired of typing "please act like a senior engineer" in every conversation.

Get the whole plugin
Stats
2,773
Stars
164
Forks
Maintained
Maintenance
Python
Language
MIT
License
1mo ago
Last commit
1y ago
Created

Repo: notlikeDev/CCPlugins