tdd

Guide Red-Green-Refactor cycles for Python, TypeScript, and Go projects.

141|6|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/mfranzon/tdd --skill tdd-mfranzon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd
Source: https://github.com/mfranzon/tdd/tree/main
Command: npx skills add https://github.com/mfranzon/tdd --skill tdd-mfranzon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

The skill keeps feature development focused on failing tests and prevents drift by orchestrating every Red-Green-Refactor step directly inside your repository. It removes the guesswork around language detection, increment decomposition, and runner selection so you always validate behavior incrementally.

Core Features & Use Cases

  • Plan parsing and feature understanding: Reads a markdown plan or inline description, identifies the language and framework (Python, TypeScript, or Go), and breaks the work into small, testable increments for your approval.
  • Strict Red-Green-Refactor loop: Writes failing tests, confirms they fail, adds minimal code, reruns the full suite, and applies refactors while pausing only when you need to review or when something goes wrong.
  • Progress tracking and wrap-up: Creates and updates tasks for each increment, summarizes what was built, and highlights remaining edge cases or documentation after completion.

Quick Start

Invoke /tdd with a markdown plan or an inline feature description to start the guided Red-Green-Refactor workflow.

Frequently Asked Questions about tdd

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

FAQPage Schema
How do I guide feature builds with strict TDD cycles in Python or TypeScript?

You can guide feature builds with strict TDD cycles by invoking /tdd with a markdown plan to decompose work into testable increments and execute disciplined Red-Green-Refactor steps directly in your repository.

What is the Red-Green-Refactor loop for test-driven development?

The Red-Green-Refactor loop for test-driven development involves writing a failing test, adding minimal code to pass it, and refactoring while running the full test suite after each phase to validate behavior incrementally.

Can I use this TDD workflow with Go projects?

Yes, you can use this TDD workflow with Go projects, as the skill automatically detects language and framework support for Python, TypeScript, and Go to select the appropriate test runner.

How do I break a markdown plan into testable increments?

To break a markdown plan into testable increments, the skill parses your feature description, identifies the target framework, and proposes small increments for your approval before writing tests and production code to real files.

Does test-driven development automation handle progress tracking and wrap-up?

Yes, test-driven development automation handles progress tracking by creating and updating tasks for each increment, summarizing built features, and highlighting remaining edge cases or documentation upon completion.

When should I not use automated TDD cycles for feature development?

You should not use automated TDD cycles when your project lacks a configured test runner or when your feature description cannot be decomposed into small, testable increments requiring failing tests.