tdd
Guide Test-Driven Development using Kent Beck's Red-Green-Refactor cycle. Use when writing tests, implementing features via TDD, or following plan.md test instructions.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
INSTRUCTIONS
Follow Kent Beck's TDD and Tidy First principles using the three-phase workflow:
-
RED -
/tdd:red- Write ONE small failing test -
GREEN -
/tdd:green- Make it pass with minimal code, then commit -
REFACTOR -
/tdd:refactor- Improve structure without changing behavior, commit each step
Workflow Pattern
/tdd:red → write failing test → /tdd:green → pass test → /git:commit
↓
← next feature ← /tdd:red ← satisfied? ← /tdd:refactor (repeat as needed)
Core Principles
- One test at a time: Each RED adds exactly ONE failing test
- Minimal code: GREEN phase writes just enough to pass
- Never skip REFACTOR: Every TDD cycle must complete all three phases
- Tidy First: Separate structural changes (refactor) from behavioral changes (feat/fix)
- Small commits: Commit after GREEN, commit after EACH refactor step
Strategy Selection (GREEN Phase)
| Confidence | Strategy | Use When |
|---|---|---|
| Low | Fake It | Return constant, generalize later |
| High | Obvious Implementation | Solution is clear |
| Generalizing | Triangulation | Add test to break a fake |
Quality Standards
- Eliminate duplication between test and production code
- Express intent through clear naming
- Keep methods small and focused
- Run ALL tests after EVERY change
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!