tdd-green-phase
Guide experienced developers through GREEN phase of TDD cycle - writing minimal implementation to pass failing tests
When & Why to Use This Skill
This Claude skill streamlines the Test-Driven Development (TDD) workflow by guiding developers through the Green phase. It focuses on writing the absolute minimum code necessary to pass failing tests, helping teams maintain high code quality, adhere to YAGNI principles, and prevent over-engineering during the implementation cycle.
Use Cases
- Implementing the simplest logic required to resolve a failing unit test in a TDD workflow.
- Applying 'Fake It' or 'Hard-Code First' strategies to quickly validate test suite expectations.
- Ensuring new feature implementations remain minimal and focused, avoiding premature abstraction or optimization.
- Guiding junior or experienced developers through disciplined TDD cycles to improve software reliability and maintainability.
| name | tdd-green-phase |
|---|---|
| description | Guide experienced developers through GREEN phase of TDD cycle - writing minimal implementation to pass failing tests |
| license | Complete terms in LICENSE.txt |
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.mdresources/minimal-implementation-guide.mdresources/triangulation-examples.md
End of TDD GREEN Phase Skill