forge-tdd

Enforce a Red-Green-Refactor test-driven development workflow with configurable gates.

1|Updated Dec 20, 2025
One-click install
npx skills add https://github.com/martimramos/claude-forge --skill forge-tdd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forge-tdd
Source: https://github.com/martimramos/claude-forge/tree/main/skills/tdd
Command: npx skills add https://github.com/martimramos/claude-forge --skill forge-tdd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Enforces a test-driven development workflow for Claude Code. This Skill ensures that new work begins with failing tests and progresses through green and refactor stages before delivery.

Core Features & Use Cases

  • Red-Green-Refactor cycle with configurable gates to guide development.
  • Gate enforcement (soft and hard modes) to control commits and releases.
  • Validation and guidance scripts that verify tests before integration.

Quick Start

Run the validation and gate status checks locally:

  • ~/.claude/skills/tdd/scripts/check-tests.sh
  • ~/.claude/skills/tdd/scripts/gate-status.sh

Frequently Asked Questions about forge-tdd

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

FAQPage Schema
How do I enforce test-driven development with Claude Code?

You can enforce test-driven development with Claude Code using a Skill that specifies Red-Green-Refactor gates, ensuring new work starts with failing tests before implementation and refactor stages.

Can I configure gate strictness for TDD workflows?

Yes, gate enforcement supports both soft and hard modes to control commits and releases, allowing you to configure how strictly the test-driven development gates block integration.

How do I verify test status before committing code changes?

You can verify test status by running validation scripts like `check-tests.sh` and `gate-status.sh`, which check tests locally and ensure code quality before integration.

What is the Red-Green-Refactor cycle in test-driven development?

The Red-Green-Refactor cycle is a test-driven development process where you write failing tests first (Red), implement code to pass them (Green), and refactor the code while maintaining passing tests.

Does this TDD workflow require any external dependencies?

No, this test-driven development workflow has no external dependencies; it relies entirely on internal validation scripts and gate configuration to enforce code quality within Claude Code.