TDD Workflow
Implements Test-Driven Development workflow for feature implementation.
Quick Start
Run TDD Cycle
from scripts.tdd_workflow import TDDWorkflow
workflow = TDDWorkflow(project_dir)
result = await workflow.implement_feature(
feature_id="auth-001",
acceptance_criteria=criteria
)
if result.passed:
print("Feature implemented and verified!")
Individual Phases
# Red: Write failing test
test_path = await workflow.write_test(feature_id)
# Green: Implement to pass
await workflow.implement_code(feature_id)
# Refactor: Clean up
await workflow.refactor(feature_id)
TDD Cycle
┌─────────────────────────────────────────────────────────────┐
│ TDD CYCLE │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 1. RED │ │
│ │ Write failing test │ │
│ │ Test must fail │ │
│ │ │ │
│ └───────────────────┬─────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 2. GREEN │ │
│ │ Write minimal code │ │
│ │ to pass test │ │
│ │ │ │
│ └───────────────────┬─────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 3. REFACTOR │ │
│ │ Improve code quality │ │
│ │ Keep tests passing │ │
│ │ │ │
│ └───────────────────┬─────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ │ │
│ │ 4. VERIFY (E2E) │ │
│ │ Run acceptance tests │ │
│ │ Confirm feature works │ │
│ │ │ │
│ └─────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘
TDD Principles
| Principle |
Description |
| Tests First |
Always write tests before implementation |
| Minimal Code |
Write only enough code to pass tests |
| Small Steps |
Make incremental changes |
| Fast Feedback |
Run tests frequently |
| Refactor Often |
Keep code clean |
Test Types
| Type |
Purpose |
When to Write |
| Unit |
Test individual functions |
RED phase |
| Integration |
Test component interaction |
After GREEN |
| E2E |
Test full feature flow |
VERIFY phase |
Integration Points
- coding-agent: Executes TDD workflow
- browser-e2e-tester: Runs E2E tests
- error-recoverer: Handle test failures
- progress-tracker: Track test metrics
References
references/TDD-BEST-PRACTICES.md - Best practicesreferences/TEST-PATTERNS.md - Common patterns
Scripts
scripts/tdd_workflow.py - Main workflowscripts/test_writer.py - Generate testsscripts/test_runner.py - Run testsscripts/refactor_helper.py - Refactoring tools
