10x-tdd

Executes approved implementation plans phase by phase using red-green-refactor test-driven development.

Updated May 20, 2026
One-click install
npx skills add https://github.com/ZawilecxD/trAInR --skill 10x-tdd-zawilecxd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-tdd
Source: https://github.com/ZawilecxD/trAInR/tree/main/.cursor/skills/10x-tdd
Command: npx skills add https://github.com/ZawilecxD/trAInR --skill 10x-tdd-zawilecxd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Executing a multi-phase technical plan with test-first discipline is hard to sustain manually: tests get written after the code, phases blur together, and progress tracking drifts from reality. This Skill drives an approved plan from context/changes/<change-id>/plan.md through strict red-green-refactor cycles, one phase at a time, with enforced gates and per-phase commits. ## Core Features & Use Cases - Phase-by-phase TDD execution: Runs RED (failing test), GREEN (minimal implementation), REFACTOR (cleanup) loops per behavior, with 2-5 focused tests per phase. - Eligibility gating: Before each phase, checks that implementation is absent and the phase is genuinely TDD'able; redirects scaffolding, wiring, or already-implemented phases to /10x-implement. - Shared progress state: Mutates the same ## Progress section in plan.md as /10x-implement, so phases can be interleaved between the two skills without losing state. - Commit ritual: Enforces green-suite-only commits, explicit path staging, Conventional Commits messages, and SHA write-back into Progress rows. - Use Case: You have an approved plan for an OAuth login change with four phases. Invoke the skill with the change-id, and it writes a failing test for phase 1's token validation, implements the minimal code, refactors, commits, then gates phase 2 for TDD-ability before continuing. ## Quick Start Ask the AI to run /10x-tdd with your change-id, for example "/10x-tdd oauth-login phase 1", to start driving that plan test-first.

Frequently Asked Questions about 10x-tdd

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

FAQPage Schema
How do I run a plan with test-driven development phase by phase?

Invoke the skill with a change-id or plan path, such as /10x-tdd oauth-login phase 1. It reads the plan's Progress section, writes a failing test for the next behavior, implements minimal code to pass, refactors, and commits once per phase after the full suite is green.

What happens if a phase is not suitable for TDD?

The skill runs an eligibility gate before every phase. Pure scaffolding, CI wiring, styling, or documentation phases are redirected to /10x-implement, with the resume command copied to your clipboard so you can hand off and return for the next phase.

Can I use this skill if the implementation already exists?

No. TDD requires the failing test to precede production code, so the skill stops when it finds existing implementation for a phase. It directs you to /10x-implement to continue that phase instead of writing retroactive tests.

Does this skill set up a test runner like Vitest or Jest?

No. It assumes test infrastructure already exists and only discovers the runner, conventions, and single-file run command. If no runner or test config is found, it stops and tells you to set one up first.

How does progress tracking work across TDD and non-TDD phases?

Both this skill and /10x-implement mutate the same ## Progress section in plan.md, flipping checkboxes and appending commit SHAs at phase end. You can interleave the two skills freely without losing execution state.