TDD Workflow

Apply Test-Driven Development discipline with Red → Green → Refactor cycle, TDD commit convention, and compliance tracking.

What This Skill Provides

• TDD compliance checklist: Track TDD discipline throughout story
• TDD commit convention: 🔴🟢♻️ emoji pattern for Red → Green → Refactor
• Metrics gathering: Collect coverage, test counts, commit patterns
• Validation: Verify TDD compliance before merge
• AI-guided verification: Review TDD discipline and test quality

When to Use

• Starting story implementation (initialize checklist)
• Throughout development (track TDD discipline)
• Before merge (validate compliance)
• In code review (verify test-first approach)

Quick Start

1. Initialize TDD Checklist

```bash

From project root

./scripts/init-tdd-checklist.sh us-001
```

Creates:
```
specs/{feature}/stories/us-001/checklists/
└── tdd-compliance.md ← Track TDD discipline
```

2. Follow TDD Commit Convention

Red → Green → Refactor Cycle:

```bash

🔴 RED: Write failing test

git add backend/tests/users.test.ts
git commit -m "🔴 Test: POST /api/users validates email format"

�� GREEN: Implement to pass

git add backend/src/api/users.ts
git commit -m "🟢 Implement email validation in createUser"

♻️ REFACTOR: Improve code quality

git add backend/src/api/users.ts backend/src/utils/validation.ts
git commit -m "♻️ Extract email validation to reusable utility"
```

Emoji Guide:

• 🔴 `:red_circle:` - Failing test (Red phase)
• 🟢 `:green_circle:` - Passing implementation (Green phase)
• ♻️ `:recycle:` - Refactoring (Refactor phase)

3. Gather TDD Metrics

```bash
./scripts/gather-tdd-metrics.sh us-001
```

Collects:

• TDD commit counts (🔴🟢♻️)
• Test coverage (backend, frontend)
• Test-to-code ratio
• Test file counts

4. Validate Before Merge

```bash
./scripts/validate-tdd-compliance.sh us-001
```

Checks:

• All checklist items completed
• Coverage ≥ 80%
• TDD commit pattern detected (🔴→🟢)
• No skipped or commented tests

Exit code 0 = passed, 1 = failed.

TDD Commit Convention Details

See TDD discipline instructions for full details on commit convention enforcement.

Integration with Other Skills

• Task-delegation: TDD compliance tracked per delegation
• Feature-orchestration: TDD checklist in story checklists/ directory
• Retrospective-workflow: TDD metrics included in retro
• CLAUDE-framework: TDD is part of coding standards

Scripts

• `init-tdd-checklist.sh ` - Initialize TDD compliance checklist
• `gather-tdd-metrics.sh ` - Collect TDD metrics
• `validate-tdd-compliance.sh ` - Verify compliance (exit 0/1)

Prompts

• `verify-tdd-compliance` - AI-guided TDD verification workflow

Templates

• `tdd-compliance.checklist.md` - TDD discipline tracking