tdd-loop

Automate the red-green-refactor loop with pytest, vitest, or jest runners.

5|Updated May 12, 2026
One-click install
npx skills add https://github.com/ramboz/jig --skill tdd-loop-ramboz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tdd-loop
Source: https://github.com/ramboz/jig/tree/main/skills/tdd-loop
Command: npx skills add https://github.com/ramboz/jig --skill tdd-loop-ramboz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates and enforces the red-green-refactor loop for code changes.

Core Features & Use Cases

Works across Python (pytest) and JS/TS (vitest/jest) projects, auto-detecting runners and streaming results.

  • Deterministic exit codes and preflight checks help operators distinguish green tests from setup issues.
  • Integration with existing tooling to drive TDD-centered development cycles.

Quick Start

Run tdd.py detect to identify the test runner, then run tdd.py run against your target to drive the loop.

Frequently Asked Questions about tdd-loop

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

FAQPage Schema
How do I automate the red-green-refactor TDD loop for my code changes?

This Skill automates the TDD loop by enforcing the red-green-refactor cycle, auto-detecting test runners, and streaming results for Python and JS/TS projects. It executes the loop deterministically via tdd.py to drive code changes.

Can I use this TDD automation tool with both pytest and vitest?

Yes, this TDD automation tool works across Python and JS/TS projects by auto-detecting test runners like pytest, vitest, and jest. It seamlessly integrates with these frameworks to drive your testing cycles.

How do I start a deterministic test-driven development cycle using tdd.py?

To start a deterministic test-driven development cycle, run tdd.py detect to identify your test runner, then run tdd.py run against your target. This drives the loop and streams your test results automatically.

Why does my TDD setup report green tests when there are actually configuration issues?

Your TDD setup might confuse green tests with setup issues due to missing preflight checks. This Skill implements runner preflight checks and deterministic exit codes to help operators reliably distinguish actual test successes from environment configuration problems.

What is the best way to enforce a strict test-driven development workflow across multiple languages?

The best way to enforce a strict test-driven development workflow across multiple languages is using a customizable test-drive tool that provides deterministic exit codes and auto-detects runners for Python and JS/TS, ensuring consistent cycles.