test-driven-development

Enforces red-green-refactor test-first workflow for implementing features and bugfixes.

Updated May 22, 2026
One-click install
npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill test-driven-development-viniciuscs84
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-driven-development
Source: https://github.com/viniciuscs84/sdd-toolkit/tree/main/skills/test-driven-development
Command: npx skills add https://github.com/viniciuscs84/sdd-toolkit --skill test-driven-development-viniciuscs84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Code written before tests often ships with unverified behavior, hidden bugs, and tests that pass immediately without proving anything. This Skill enforces a strict test-first discipline so every line of production code is backed by a test that was watched failing first. ## Core Features & Use Cases - Red-Green-Refactor Cycle: Guides writing a failing test, verifying the failure, writing minimal code to pass, and refactoring while staying green. - Anti-Rationalization Guardrails: Counters common excuses like "I'll test after" or "deleting code is wasteful" with concrete reasoning and red-flag checklists. - Testing Anti-Patterns Reference: Covers testing mock behavior, test-only methods in production classes, incomplete mocks, and mocking without understanding dependencies. - Use Case: When fixing a bug where empty emails are accepted, write a failing test asserting the rejection, watch it fail, implement the minimal validation, and confirm all tests pass before refactoring. ## Quick Start Ask the AI to implement the next feature or bugfix using strict test-driven development with a failing test written first.

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 to make it pass. Refactor only while all tests stay green, then repeat for the next behavior.

How do I fix a bug using TDD?

Write a failing test that reproduces the bug first, then implement the minimal fix until the test passes. This proves the fix works and creates a regression test that prevents the bug from returning.

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 rather than existing behavior or mocks.

When is it acceptable to skip test-driven development?

Exceptions are limited to throwaway prototypes, generated code, and configuration files, and should be confirmed with your human partner. Exploration is fine, but the exploratory code should be discarded and rewritten test-first.

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, creating incomplete mocks missing real API fields, and mocking methods whose side effects the test depends on.