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