mcpField
T
tdd

tdd

github.com/owainlewisTesting & quality422371 installsUpdated 2w ago
Repository

About tdd

A test-driven development skill that guides coding agents through a failing test, the smallest passing implementation, and refinement. It is intended for behavior changes and bug fixes, with explicit exceptions for documentation, formatting, and non-behavioral scaffolding.

Key features

  1. 01Read request, sources, and relevant code
  2. 02Prove failure with a focused test
  3. 03Implement the minimum passing change
  4. 04Refine while keeping tests passing
  5. 05Run relevant checks and report results

Use cases

  1. 01Add behavior covered by a new test
  2. 02Reproduce and fix a bug
  3. 03Validate failure paths for a change

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/owainlewis/blueprint --skill tdd

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

Details

From the project README

TDD

  1. Read the request, its sources, and the relevant code. Ask before writing tests only when a missing decision would change behavior, interfaces, or checks.
  2. Red: write the smallest failing test that proves the behavior or reproduces the bug. Run it and confirm it fails for the expected reason.
  3. Green: write the minimum implementation that passes. Don't change existing interfaces or user-visible behavior unless the task requires it. Add failure-path tests where they matter.
  4. Refine: simplify code and tests while they keep passing. Run focused checks, then wider ones.
  5. Report the test that failed before, passes after, and final checks.

Rules

  • No implementation code before a failing test for the behavior.
  • State low-risk assumptions and keep moving.
  • Tests describe behavior, not implementation details.
  • Prefer real boundaries over mocks when practical.
  • Skip TDD for docs, formatting, or non-behavioral scaffolding.

Comments

Markdown supported