tdd

Automates test-driven development with a YAML-driven SKILL.md workflow.

Updated Mar 6, 2026
One-click install
npx skills add https://github.com/v36372/pi-stuff --skill tdd-v36372
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd
Source: https://github.com/v36372/pi-stuff/tree/main/skills/tdd
Command: npx skills add https://github.com/v36372/pi-stuff --skill tdd-v36372

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The TDD skill helps teams build features and fix bugs by emphasizing test-first development, ensuring interfaces remain stable as code evolves.

Core Features & Use Cases

  • Vertical slices through one test per implementation, focusing on observable behavior over internal structure.
  • Integration-style tests that exercise the public API to verify end-to-end behavior.
  • Structured workflow guiding planning, tracer bullets, incremental loops, and disciplined refactoring.

Quick Start

Write one end-to-end test that describes a user-visible behavior, then implement only enough code to pass that test.

Frequently Asked Questions about tdd

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

FAQPage Schema
How do I start test-driven development for a new software feature?

To start test-driven development, write one end-to-end integration test describing a user-visible behavior, then implement only enough code to pass that test before refactoring.

What is the red-green-refactor cycle in software development?

The red-green-refactor cycle is a test-driven development workflow where you write a failing test, implement code to make it pass, and then refactor while keeping the test green.

How does integration testing keep public APIs stable during refactoring?

Integration testing exercises the public API to verify end-to-end behavior, ensuring interfaces remain stable as code evolves by focusing on observable outcomes over internal structure.

Can I use test-driven development for both building features and fixing bugs?

Yes, test-driven development applies to software teams delivering new features or fixing bugs, ensuring reliable integration tests and stable public interfaces throughout the process.

What's the best way to structure a TDD workflow with tracer bullets?

Structure a TDD workflow by planning vertical slices, writing tracer bullets to establish end-to-end connectivity, and looping through incremental test-first implementation and refactoring steps.

Do I need a specific format for the TDD workflow configuration file?

You need a SKILL.md file with YAML frontmatter containing a name and description, followed by a well-structured markdown body outlining planning, tracer bullets, and workflow steps.