tdd-workflow
Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle.
Best for Development teams adopting…Works with GitHubLow risk
⌘source
- author
@sickn33- language
- Python
★34kstars
5.6kforks
Apr 18, 2026
✦overview.md
Key Features
- ·Follows the RED-GREEN-REFACTOR cycle
- ·Enforces writing tests before production code
- ·Promotes minimal code to pass tests
- ·Includes refactoring for code quality
- ·Based on the Three Laws of TDD
- ·Provides principles for each phase
Use Cases
- →Implementing new features with a test-first approach
- →Refactoring existing code with confidence from tests
- →Training developers on TDD methodology
- →Maintaining code quality through incremental improvement
Best for
- ✓Development teams adopting TDD
- ✓Projects requiring high test coverage
- ✓Agile development environments
Not ideal for
- !Projects without a testing framework
- !One-off scripts or prototypes
- !Situations requiring rapid proof-of-concept without tests
FAQs
name
tdd-workflow
description
Test-Driven Development workflow principles. RED-GREEN-REFACTOR cycle.
risk:unknown
source:community
date_added:2026-02-27
TDD Workflow
Write tests first, code second.
1. The TDD Cycle
🔴 RED → Write failing test
↓
🟢 GREEN → Write minimal code to pass
↓
🔵 REFACTOR → Improve code quality
↓
Repeat...
2. The Three Laws of TDD
- Write production code only to make a failing test pass
- Write only enough test to demonstrate failure
- Write only enough code to make the test pass
3. RED Phase Principles
What to Write
| Focus | Example |
|---|---|
| Behavior | "should add two numbers" |
| Edge cases | "should handle empty input" |
| Error states | "should throw for invalid data" |
RED Phase Rules
- Test must fail first
- Test name describes expected behavior
- One assertion per test (ideally)
4. GREEN Phase Principles
Minimum Code
| Principle | Meaning |
|---|---|
| YAGNI | You Aren't Gonna Need It |
| Simplest thing | Write the minimum to pass |
| No optimization | Just make it work |
GREEN Phase Rules
- Don't write unneeded code
- Don't optimize yet
- Pass the test, nothing more
5. REFACTOR Phase Principles
What to Improve
| Area | Action |
|---|
$install
1-click copynpx skills add sickn33/antigravity-awesome-skills --skill tdd-workflowSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
3/ 5
mediumPartially actionable with several concrete steps, but still missing important details.