run-tdd

Coordinate TDD stages F RED, G GREEN, and H REFACTOR for VibeFlow.

8|Updated Sep 22, 2025
One-click install
npx skills add https://github.com/hardness1020/VibeFlow --skill run-tdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-tdd
Source: https://github.com/hardness1020/VibeFlow/tree/main/.claude/skills/run-tdd
Command: npx skills add https://github.com/hardness1020/VibeFlow --skill run-tdd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamlines the end-to-end TDD lifecycle for the VibeFlow docs-first workflow, ensuring teams start with failing tests, implement minimal code, and perform structured refactoring with quality validation across stages F–H.

Core Features & Use Cases

  • Stage F (RED): Create implementation stubs and write failing unit tests to validate the red phase.
  • Stage G (GREEN): Implement minimal functional code to pass tests and identify contract changes via Stage G.1 protocol.
  • Stage H (REFACTOR): Add integration tests, refactor code while tests remain green, and complete quality validation per H.4.

Quick Start

Initiate the TDD cycle with /run-tdd start to guide you through Stage F RED, Stage G GREEN, and Stage H REFACTOR.

Frequently Asked Questions about run-tdd

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

FAQPage Schema
How do I run a red-green-refactor TDD cycle from start to finish?

To run a red-green-refactor TDD cycle, you start by creating implementation stubs and writing failing unit tests for Stage F RED, implement minimal code to pass tests for Stage G GREEN, and finish by refactoring with integration tests for Stage H REFACTOR.

What is the docs-first TDD workflow and when do I need it?

The docs-first TDD workflow is a structured testing lifecycle that ensures teams start with failing tests, implement minimal functional code, and perform quality validation. You need it to streamline end-to-end test-driven development across RED, GREEN, and REFACTOR stages.

How do I handle contract changes during the GREEN phase of TDD?

To handle contract changes during the GREEN phase of TDD, you follow the Stage G.1 protocol after implementing minimal functional code to pass tests. This protocol identifies and manages contract changes to maintain integration readiness across the workflow.

How do I perform quality validation during code refactoring?

To perform quality validation during code refactoring, you add integration tests and refactor the code while keeping tests green, then complete the structured quality validation process defined in Stage H.4 to ensure software integrity.

Can I enforce test categorization and integration readiness with a TDD workflow?

Yes, you can enforce test categorization and integration readiness by coordinating a structured TDD workflow across stages. This approach enforces specific test categorization protocols and provides guidance on stubs and validation scripts to ensure readiness.

What's the best way to start a TDD cycle with stubs and failing tests?

The best way to start a TDD cycle is to initiate the process to guide you through Stage F RED, where you create implementation stubs and write failing unit tests to validate the red phase before moving to minimal code implementation.