test-driven-development

Enforces red-green-refactor test-driven development workflow before writing implementation code.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/kxnzee/multi-repo-specs --skill test-driven-development-kxnzee
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: test-driven-development
Source: https://github.com/kxnzee/multi-repo-specs/tree/main/extensions/superpowers/skills/test-driven-development
Command: npx skills add https://github.com/kxnzee/multi-repo-specs --skill test-driven-development-kxnzee

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers often write production code first and add tests afterward, which produces tests that pass immediately and prove nothing about correctness. This Skill enforces a strict test-first discipline so every feature and bugfix is backed by a test that was watched failing before implementation. ## Core Features & Use Cases - Red-Green-Refactor Cycle: Guides the AI through writing a failing test, verifying the failure, writing minimal code to pass, and refactoring while staying green. - Rationalization Detection: Lists common excuses for skipping TDD ("too simple to test", "I'll test after") and counters each with concrete reasoning. - Testing Anti-Patterns Reference: Ships a companion reference covering mock-behavior testing, test-only production methods, incomplete mocks, and over-mocking. - Use Case: When asked to fix a bug where an empty email is accepted, the Skill first writes a failing test reproducing the bug, verifies it fails for the right reason, then implements the minimal validation fix. ## Quick Start Use the test-driven-development skill to implement this feature by writing a failing test first, then the minimal code to make it pass.

Frequently Asked Questions about test-driven-development

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

FAQPage Schema
How do I practice test-driven development on a new feature?▼

Write one minimal failing test describing the desired behavior, run it to confirm it fails for the right reason, then write the simplest code that makes it pass. Refactor only while all tests stay green, then repeat the cycle for the next behavior.

How do I write a failing test for a bug fix?▼

Write a test that reproduces the bug, such as asserting that an empty email returns an error, and run it to watch it fail. Then implement the minimal fix and confirm the test passes along with the rest of the suite.

Why should tests be written before implementation code?▼

Tests written after code pass immediately, which proves nothing about whether they test the right behavior. Watching a test fail first confirms it actually exercises the missing feature and catches the intended bug.

When is it acceptable to skip test-driven development?▼

Exceptions are limited to throwaway prototypes, generated code, and configuration files, and only with explicit approval from your human partner. Exploration is allowed, but the exploratory code must be discarded before restarting with TDD.

What are common mocking mistakes in unit tests?▼

Common mistakes include asserting on mock elements instead of real behavior, adding test-only methods to production classes, mocking methods whose side effects the test depends on, and creating incomplete mocks missing fields downstream code uses.