mcpField
T
tdd

tdd

github.com/yeachan-heoTesting & quality33.7k103 installsUpdated 1d ago
Repository

About tdd

tdd is a hard-deprecated TDD skill that must not be invoked or routed. It describes a test-first cycle, while directing users to keep that discipline within the active implementation workflow.

Key features

  1. 01Marked as hard-deprecated
  2. 02Must not be invoked or routed
  3. 03Describes the Red-Green-Refactor cycle
  4. 04Calls for tests after each change

Use cases

  1. 01Recognize and avoid the deprecated skill
  2. 02Keep test-first discipline in the active workflow
  3. 03Organize work around failing tests, implementation, and refactoring

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yeachan-heo/oh-my-codex --skill tdd

After installing, type/tddin Claude Code to confirm it loaded.

Details

From the project README

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

If You SeeAction
Code written before testSTOP. Delete code. Write test first.
Test passes on first runTest is wrong. Fix it to fail first.
Multiple features in one cycleSTOP. One test, one feature.
Skipping refactorGo back. Clean up before next feature.

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.

Comments

Markdown supported