TDD Cycle Helper

Guide through red-green-refactor with explicit test tracking.

Usage

`/tdd-check [test-path]`

Run test and guide next step based on result.

TDD Cycle

0. Test List (planning phase)

Before writing any code, create a test list in the increment file:

markdown

## Implementation Plan

### Phase 1: Basic setup
- [ ] test health endpoint returns 200
- [ ] test create room generates 4-digit code
- [ ] test join room adds participant

### Phase 2: Core features
- [ ] test get movies returns static list
- [ ] test submit vote records like/dislike
- [ ] test match found when both like same movie

Rules:

•Write test list BEFORE any implementation
•Tests should be small and focused
•Each test drives one piece of behavior
•Check off tests as you complete them (red-green-refactor)

1. Red (write failing test)

code

/tdd-check tests/test_feature.py
→ Running: pytest tests/test_feature.py -v
→ ✗ FAILED (expected - we're in red phase)
→ Next: Write minimal code to make it pass

2. Green (make it pass)

code

/tdd-check tests/test_feature.py
→ Running: pytest tests/test_feature.py -v
→ ✓ PASSED
→ Next: Refactor while keeping tests green
→ Mark test done in increment file? [Y/n]

3. Refactor

code

/tdd-check tests/test_feature.py
→ Running: pytest tests/test_feature.py -v
→ ✓ PASSED (still green after refactor)
→ Good to go. Next test?

Increment File Integration

When test passes, offer to check off in increment file:

code

Found increment file: docs/backlog/in-progress/00043-feature.md
Mark "- [ ] test feature" as done? [Y/n]
→ Updating file...
→ - [x] test feature

Commands

`/tdd-check [path]`

Run specific test file.

`/tdd-check --red`

Expect failure (red phase). Warns if test passes unexpectedly.

`/tdd-check --green`

Expect pass (green phase). Error if fails.

`/tdd-check --watch`

Run in watch mode: re-run on file changes.

Test List from Increment

Parse Implementation Plan section for test items:

markdown

## Implementation Plan
- [ ] test auth middleware rejects invalid tokens
- [ ] test auth middleware accepts valid tokens
- [ ] test auth middleware sets user context

Suggest next test:

code

Next unimplemented test: "test auth middleware rejects invalid tokens"
Run? [Y/n/specific test]

Errors

•No test path provided, no increment file found → "Error: Provide test path or be in an in-progress increment"
•--green but test fails → "Error: Test should pass in green phase. Fix implementation."
•--red but test passes → "Warning: Test already passes. Did you already implement it?"