10x-tdd

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

Updated Jul 4, 2026
One-click install
npx skills add https://github.com/Assamir/ai-toolkit --skill 10x-tdd-assamir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-tdd
Source: https://github.com/Assamir/ai-toolkit/tree/main/.cursor/skills/10x-tdd
Command: npx skills add https://github.com/Assamir/ai-toolkit --skill 10x-tdd-assamir

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Executing a multi-phase implementation plan with test-first discipline is hard to sustain manually: tests get written after the code, progress tracking drifts, and commits mix unrelated changes. 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 progress tracking and per-phase commits. ## Core Features & Use Cases - Phase-by-phase TDD execution: For each plan phase, writes a failing test first, then minimal production code to pass it, then refactors while staying green. - Eligibility gating: Before each phase, checks that the implementation is absent and the phase is genuinely testable; redirects scaffolding, config, 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: Runs the full suite, gates on manual verification, stages only touched files, and writes the commit SHA back into completed progress rows. - Use Case: You have an approved plan for an OAuth login feature with four phases. Run /10x-tdd oauth-login to implement each phase test-first, with a clean Conventional-Commits commit per phase. ## Quick Start Ask the assistant 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 /10x-tdd with a change-id or plan path, such as /10x-tdd oauth-login phase 1. The skill reads the plan, confirms test infrastructure exists, then runs red-green-refactor loops per behavior and commits once per phase.

What is the difference between 10x-tdd and 10x-implement?

10x-tdd writes the failing test before production code, while 10x-implement builds directly from the plan. Both read the same plan and mutate the same Progress section, so phases can be interleaved between them without losing state.

Can I use TDD if the phase implementation already exists?

No. The skill stops when it detects existing implementation, because a failing test cannot lead code that is already written. It redirects you to /10x-implement for that phase instead of writing retroactive tests.

What happens if a phase is not testable, like config or scaffolding?

The TDD-ability gate flags non-testable phases such as scaffolding, CI wiring, or visual polish. You can hand the phase off to /10x-implement, implement it inline without test-first, or skip it if already done.

Does 10x-tdd set up a test runner for my project?

No. It assumes a runner like Vitest, Jest, Playwright, or pytest already exists and only discovers existing conventions. If no runner is found, it stops and points you to set one up first.

Why does the skill refuse to commit while tests are failing?

A hard invariant requires the full suite to be green before any commit is proposed. The red state is only a transient checkpoint shown to the user, never a commit boundary, so broken code never enters history.