tdd-green-phase
Guide experienced developers through GREEN phase of TDD cycle - writing minimal implementation to pass failing tests
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
TDD GREEN Phase
Version: {{VERSION}}
When to Use
- RED phase test has been verified as failing
- Proceeding autonomously from RED phase
- Implementing feature to pass test
GREEN Phase Objective
Write the minimum code to make the test pass.
Workflow
Step 1: Understand Test Requirements
- What behavior is expected?
- What inputs does test provide?
- What output/result does test expect?
Step 2: Plan Minimal Implementation
Include:
- Minimum logic needed
- Required data structures
- Expected return values
Avoid:
- Features not in test
- Abstractions not yet needed
- Premature optimization
Step 3: Implement to Pass Test
Provide single code block:
TASK: [Brief description]
STEP 1: [Open implementation file]
STEP 2: [Navigate to location]
STEP 3: [Add implementation code]
STEP 4: [Explanation]
STEP 5: [Save file]
STEP 6: [Run test command]
STEP 7: [Verify test PASSES]
STEP 8: [Report back: Did test pass?]
Step 4: Verify and Proceed
If test passes: Proceed to REFACTOR phase If test fails: Revise implementation, repeat If other tests fail: Fix regressions first
Best Practices
YAGNI (You Aren't Gonna Need It)
Good: Implements exactly what test requires Poor: Implements untested features "just in case"
Simplest Thing That Works
Test: Function should return sum of two numbers
WRONG: Generic calculation engine with plugins
RIGHT: Function returns a + b
Hard-Code First, Generalize Later
Test expects result: 5
Implementation: return 5
Next test expects different result
-> Now implement real logic
Common Mistakes
- Over-Implementation - Adding features not required
- Premature Abstraction - Creating abstractions before needed
- Ignoring Test Failure Details - Not reading expectations
- Breaking Existing Tests - Run full suite
Implementation Strategies
| Strategy | When | Example |
|---|---|---|
| Fake It | Simple test | return 5 |
| Obvious | Clear solution | return a + b |
| Triangulation | Unsure how to generalize | Multiple tests force generalization |
Checklist Before REFACTOR Phase
- Target test PASSES
- Implementation is minimal
- No existing tests broke
- Code is understandable
- No untested features added
Resources
-
resources/green-phase-checklist.md -
resources/minimal-implementation-guide.md -
resources/triangulation-examples.md
End of TDD GREEN Phase Skill
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!