tdd-workflow
Test-Driven Development workflow for autonomous coding. Use when implementing features with TDD, writing tests first, following red-green-refactor, or ensuring test coverage.
60
Quality
70%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
View guide
Securityby
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/tdd-workflow/SKILL.mdTDD 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
- Repository
- fernandezbaptiste/Skrillz
- Commit
93ed392
- Last updated
- First committed
Also appears in
fernandezbaptiste/Skrillz
In sync
since Sep 12, 2026
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.