solo-tdd

Guides test-driven development through RED, GREEN, and REFACTOR cycles across language test runners.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/cjrain-12505614/solo-forge-marketplace --skill solo-tdd-cjrain-12505614
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: solo-tdd
Source: https://github.com/cjrain-12505614/solo-forge-marketplace/tree/main/solo-forge-v0.6.0/skills/solo-tdd
Command: npx skills add https://github.com/cjrain-12505614/solo-forge-marketplace --skill solo-tdd-cjrain-12505614

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing production code before tests often leads to untested logic and regressions. This Skill enforces a disciplined test-driven development loop where failing tests are written first, minimal code makes them pass, and refactoring happens only while tests stay green. ## Core Features & Use Cases - RED-GREEN-REFACTOR Cycle: Structures work into three phases—write a failing test, make it pass with minimal code, then refactor without adding features. - Automatic Test Runner Detection: Identifies the correct test command from project markers such as pyproject.toml (pytest), package.json (npm test), go.mod (go test), Cargo.toml (cargo test), and build.gradle or pom.xml. - Naming Conventions: Provides should_X_when_Y style test naming examples for pytest, Jest/Vitest, and Go. - Use Case: When asked to implement a bulk status-change API, the Skill first writes a failing test asserting the expected behavior, verifies the failure is a genuine assertion failure, then implements the smallest passing change and refactors safely. ## Quick Start Ask the AI to build a feature test-first by saying: use TDD to implement the bulk status change API, starting with a failing test.

Frequently Asked Questions about solo-tdd

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

FAQPage Schema
How do I practice test-driven development with pytest or Jest?▼

Test-driven development follows three phases: write a failing test for the expected behavior (RED), write the minimal code to pass it (GREEN), then refactor while keeping tests green (REFACTOR). The Skill detects pytest from pyproject.toml and Jest from package.json automatically.

What is the RED GREEN REFACTOR cycle in TDD?▼

RED means writing a test that fails because the feature does not exist yet. GREEN means writing the simplest code that makes the test pass. REFACTOR means improving structure and naming without adding features, while confirming tests still pass.

Does this TDD workflow support Go, Rust, and Java projects?▼

Yes, the workflow is language-agnostic. It detects go.mod for go test, Cargo.toml for cargo test, and build.gradle or pom.xml for Gradle/Maven test commands, applying the same RED-GREEN-REFACTOR cycle in each.

Why must the first test fail in test-driven development?▼

The initial failure proves the test actually exercises the missing behavior rather than passing trivially. The failure must be a genuine assertion failure, not a typo or compile error, confirming the test targets the right expectation.

When should I not add features during TDD refactoring?▼

Never add features during the REFACTOR phase. That phase is limited to removing duplication, improving naming, and cleaning structure while tests stay green; new behavior requires returning to the RED phase with a new failing test.