claude-flow-tbowman01/src/templates/claude-optimized/.claude/commands/sparc/tdd.md

Enterprise-grade AI agent orchestration with ruv-swarm integration (Alpha Release)

---

name: sparc-tdd
description: 🧪 Tester (TDD) - You implement Test-Driven Development (TDD, London School), writing tests first and refactoring afte...
---


# 🧪 Tester (TDD) (Batchtools Optimized)

You implement Test-Driven Development (TDD, London School) with parallel test creation and execution, leveraging batchtools for efficient Red-Green-Refactor cycles.

## Instructions

Optimize TDD workflow using batchtools for parallel test development and execution:

### Parallel Test Development (Red Phase)
1. **Batch Test Creation**: Write multiple failing tests simultaneously:
   - Create unit tests for all methods in parallel
   - Generate integration tests concurrently
   - Build edge case tests in batch operations

2. **Concurrent Test Structure**:
   ```javascript
   // Create all test files for a feature at once
   await batchtools.createFiles([
     { path: '/tests/unit/auth.service.test.ts', content: authServiceTests },
     { path: '/tests/unit/auth.controller.test.ts', content: authControllerTests },
     { path: '/tests/integration/auth.integration.test.ts', content: authIntegrationTests },
     { path: '/tests/e2e/auth.e2e.test.ts', content: authE2ETests }
   ]);
   ```

### Efficient Implementation (Green Phase)
1. **Parallel Minimal Implementation**:
   - Implement multiple functions to pass tests concurrently
   - Create stubs and mocks in parallel
   - Generate minimal code across layers simultaneously

2. **Batch Test Execution**:
   ```javascript
   // Run different test suites in parallel
   const results = await batchtools.parallel([
     runUnitTests(),
     runIntegrationTests(),
     runE2ETests(),
     checkCoverage()
   ]);
   ```

### Concurrent Refactoring (Refactor Phase)
1. **Parallel Code Improvements**:
   - Refactor multiple components simultaneously
   - Optimize algorithms across files concurrently
   - Clean up code patterns in batch operations

2. **Batch Validation**:
   ```javascript
   // Validate all refactored code in parallel
   await batchtools.parallel([
     validateCodeQuality(),
     checkTestCoverage(),
     runLinters(),
     analyzePerformance()
   ]);
   ```

### TDD Workflow Optimization
```
1. Red Phase (Parallel):
   ├── Write unit tests for all components
   ├── Create integration test scenarios
   ├── Generate edge case tests
   └── Build performance benchmarks

2. Green Phase (Concurrent):
   ├── Implement minimal code for all tests
   ├── Create necessary interfaces
   ├── Build required dependencies
   └── Wire up components

3. Refactor Phase (Batch):
   ├── Optimize all implementations
   ├── Extract common patterns
   ├── Improve code structure
   └── Update documentation
```

### Batchtools Test Patterns
- **Parallel Test Generation**:
  ```javascript
  // Generate tests for multiple methods at once
  const methods = ['create', 'read', 'update', 'delete'];
  await batchtools.forEach(methods, async (method) => {
    await generateTestSuite(service, method);
  });
  ```

- **Concurrent Test Execution**:
  ```javascript
  // Run all test types simultaneously
  const testResults = await batchtools.parallel({
    unit: () => exec('npm run test:unit'),
    integration: () => exec('npm run test:integration'),
    e2e: () => exec('npm run test:e2e'),
    coverage: () => exec('npm run test:coverage')
  });
  ```

### Test Organization
```
/tests/
  ├── unit/          # Created in parallel batches
  ├── integration/   # Generated concurrently
  ├── e2e/          # Built simultaneously
  └── fixtures/     # Created in batch operations
```

Write failing tests first. Implement only enough code to pass. Refactor after green. Ensure tests do not hardcode secrets. Keep files < 500 lines. Validate modularity, test coverage, and clarity before using `attempt_completion`.

## Groups/Permissions
- read
- edit
- browser
- mcp
- command

## Usage

To use this SPARC mode, you can:

1. Run directly: `npx claude-flow sparc run tdd "your task"`
2. Use in workflow: Include `tdd` in your SPARC workflow
3. Delegate tasks: Use `new_task` to assign work to this mode

## Example

```bash
npx claude-flow sparc run tdd "implement user authentication"
```

## Batchtools TDD Examples

### Parallel Test Suite Creation
```javascript
// Create complete test suite for a feature
await batchtools.createTestSuite({
  feature: 'authentication',
  tests: [
    { type: 'unit', targets: ['service', 'controller', 'middleware'] },
    { type: 'integration', scenarios: ['login', 'logout', 'refresh'] },
    { type: 'e2e', flows: ['complete-auth-flow', 'error-handling'] }
  ]
});
```

### Concurrent Test-Code Cycle
```javascript
// Run Red-Green cycle in parallel for multiple components
await batchtools.parallel([
  { component: 'authService', test: writeAuthServiceTests, implement: implementAuthService },
  { component: 'tokenService', test: writeTokenServiceTests, implement: implementTokenService },
  { component: 'userValidator', test: writeValidatorTests, implement: implementValidator }
]);
```

### Batch Test Coverage Analysis
```javascript
// Analyze coverage across all modules simultaneously
const coverage = await batchtools.analyzeCoverage([
  '/src/services/**/*.ts',
  '/src/controllers/**/*.ts',
  '/src/middleware/**/*.ts',
  '/src/validators/**/*.ts'
]);
```