tdd

Guides test-driven development through red-green cycles with seam-based test design.

Updated Sep 8, 2026
One-click install
npx skills add https://github.com/salomepoulain/makery-stations --skill tdd-salomepoulain
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd
Source: https://github.com/salomepoulain/makery-stations/tree/main/stations/claude/workbench/pantry/skills/tdd
Command: npx skills add https://github.com/salomepoulain/makery-stations --skill tdd-salomepoulain

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing tests after code often produces brittle, implementation-coupled tests that break on refactors and fail to verify real behavior. This Skill enforces a disciplined red-green TDD loop so tests verify behavior through public interfaces and survive refactoring. ## Core Features & Use Cases - Red-Green Loop Rules: Enforces writing a failing test first, then only enough code to pass it, one vertical slice at a time. - Seam-Based Test Design: Requires agreeing on public interface seams with the user before any test is written, focusing effort on critical paths. - Anti-Pattern Detection: Identifies implementation-coupled, tautological, and horizontally-sliced tests, with mocking guidelines for system boundaries only. - Use Case: When adding a checkout feature, use this Skill to define the public seams, write one failing behavior test ("user can checkout with valid cart"), implement the minimal code to pass, and repeat slice by slice. ## Quick Start Use the tdd skill to build this feature test-first, starting by agreeing on the public seams we should test.

Frequently Asked Questions about tdd

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I practice test-driven development with the red-green loop?

Write one failing test against a public interface first, then write only enough code to make it pass, and repeat one slice at a time. Do not write all tests up front or add speculative features beyond the current failing test.

What is a seam in test-driven development?

A seam is the public boundary where you observe behavior without reaching inside the code. Tests live at seams, never against internals, and the seams under test should be agreed with the user before any test is written.

When should I mock dependencies in unit tests?

Mock only at system boundaries such as external APIs, time, randomness, and sometimes databases or the file system. Never mock your own classes or internal collaborators, and prefer dependency injection and SDK-style interfaces to make boundaries mockable.

Why do my tests break every time I refactor code?

Tests break on refactoring when they are coupled to implementation details, such as mocking internal collaborators, testing private methods, or asserting on call counts. Tests should verify behavior through public interfaces so internal structure can change freely.

What is a tautological test and why is it bad?

A tautological test recomputes the expected value the same way the implementation does, so it passes by construction and can never catch a bug. Expected values must come from an independent source such as a known literal, a worked example, or the specification.