test-driven-development

Enforces red-green-refactor loops with executable acceptance-criteria tests before production code changes.

27|6|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/heimeshoff/Agentheim --skill test-driven-development-heimeshoff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-driven-development
Source: https://github.com/heimeshoff/Agentheim/tree/main/skills/test-driven-development
Command: npx skills add https://github.com/heimeshoff/Agentheim --skill test-driven-development-heimeshoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enforces a test-driven discipline so completion is driven by verifiable, observable behavior rather than guesswork, reducing regressions and misinterpretation of requirements.

Core Features & Use Cases

  • Test-driven loop: For each acceptance criterion, write a failing test, implement the minimum code, and refactor while keeping tests green.
  • Explicit criteria coverage: Tests map to the project's ubiquitous language and acceptance criteria, ensuring traceability.
  • Verification integration: Outputs are designed for the verifier to validate test results before completion.

Quick Start

Write a failing test for the first acceptance criterion, then implement the minimum code to pass it.

Frequently Asked Questions about test-driven-development

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

FAQPage Schema
How do I enforce test-driven development for code changes and bug fixes?

Test-driven development enforces discipline by guiding you through a red-green-refactor loop, ensuring observable behavior is validated by executable tests before any production work is completed. This reduces regressions by driving completion through verifiable results.

What is the red-green-refactor loop in software testing?

The red-green-refactor loop is a test-driven cycle where you write a failing test for an acceptance criterion, implement the minimum code to pass it, and then refactor while keeping tests green. It ensures traceability between tests and project requirements.

How do I verify acceptance criteria with executable tests during refactoring?

You verify acceptance criteria by mapping explicit executable tests to the project's ubiquitous language for each requirement. The verification gate then attests test results before completion, ensuring every refactored code change meets the defined observable behavior.

Can I use test-driven development for refactoring existing code without changing behavior?

Yes, test-driven development applies to refactors by maintaining a green test suite while you improve code structure. It requires a verifiable test suite mapped to acceptance criteria, ensuring observable behavior remains validated throughout the refactoring process.

Do I need a verifiable test suite to start test-driven development?

Yes, you need a verifiable test suite and explicit executable tests per acceptance criterion. The verification integration requires attesting test results before completion, so a verifiable suite is a prerequisite to enforce the test-driven discipline effectively.

Why does test-driven development reduce misinterpretation of software requirements?

Test-driven development reduces misinterpretation by enforcing explicit criteria coverage, where tests map directly to the project's ubiquitous language and acceptance criteria. This ensures completion is driven by verifiable, observable behavior rather than guesswork.