Tdd

TDD deprecated

Hard-deprecated. Do not invoke or route this skill. Keep test-first discipline inside the active implementation workflow and verify with the project test suite.

The Iron Law

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST

Write code before test? DELETE IT. Start over. No exceptions.

Red-Green-Refactor Cycle

1. RED: Write Failing Test

• Write test for the NEXT piece of functionality
• Run test - MUST FAIL
• If it passes, your test is wrong

2. GREEN: Minimal Implementation

• Write ONLY enough code to pass the test
• No extras. No "while I'm here."
• Run test - MUST PASS

3. REFACTOR: Clean Up

• Improve code quality
• Run tests after EVERY change
• Must stay green

4. REPEAT

• Next failing test
• Continue cycle

Enforcement Rules

Commands

Before each implementation:

# Run the project's test command - should have ONE new failure

After implementation:

# Run the project's test command - new test should pass, all others still pass

Output Format

When guiding TDD:

## TDD Cycle: [Feature Name]

### RED Phase
Test: [test code]
Expected failure: [what error you expect]
Actual: [run result showing failure]

### GREEN Phase
Implementation: [minimal code]
Result: [run result showing pass]

### REFACTOR Phase
Changes: [what was cleaned up]
Result: [tests still pass]

External Model Consultation (Preferred)

The tdd-guide agent SHOULD consult Codex for test strategy validation.

Protocol

1. Form your OWN test strategy FIRST - Design tests independently 2. Consult for validation - Cross-check test coverage strategy 3. Critically evaluate - Never blindly adopt external suggestions 4. Graceful fallback - Never block if tools unavailable

When to Consult

• Complex domain logic requiring comprehensive test coverage
• Edge case identification for critical paths
• Test architecture for large features
• Unfamiliar testing patterns

When to Skip

• Simple unit tests
• Well-understood testing patterns
• Time-critical TDD cycles
• Small, isolated functionality

Tool Usage

Prefer native test-engineer consultation or CLI-backed ask surfaces when available. Optional MCP compatibility ask tools may be used only when already enabled. If consultation tools are unavailable, fall back to the test-engineer agent.

Remember: The discipline IS the value. Shortcuts destroy the benefit.