10x-tdd

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

Updated May 24, 2026
One-click install
npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-tdd-devmachaj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-tdd
Source: https://github.com/DevMachaj/Projekt-certyfikacyjny/tree/main/.claude/skills/10x-tdd
Command: npx skills add https://github.com/DevMachaj/Projekt-certyfikacyjny --skill 10x-tdd-devmachaj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams with an approved technical plan often struggle to execute it with test-first discipline: tests get written after the code, phases lose track of progress, and non-testable work gets forced into a TDD mold. This Skill drives a plan from context/changes/<change-id>/plan.md to completion one phase at a time, enforcing the red-green-refactor loop and keeping execution state in the plan itself. ## Core Features & Use Cases - Phase-by-phase TDD execution: For each plan phase it writes a failing test, implements the minimal code to pass, refactors, and records progress in the plan's Progress section with commit SHAs. - TDD eligibility gating: Before each phase it checks whether implementation already exists and whether the phase is test-first-able, redirecting scaffolding or already-built phases to /10x-implement instead of writing retroactive tests. - Structured phase-end ritual: Runs the full test suite, pauses for manual verification, stages only touched files, and creates one Conventional-Commits commit per phase. - Use Case: A developer has an approved plan for adding rate limiting across three phases. They run the skill with the change-id, and it TDDs the validator logic in phase 1, redirects the CI wiring in phase 2 to /10x-implement, and resumes test-first for phase 3 without losing state. ## Quick Start Run /10x-tdd with a change-id such as /10x-tdd oauth-login phase 1 to start driving that approved 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 test-first with Claude Code?

Invoke /10x-tdd with a change-id or a path to the plan file, optionally specifying a phase number. The skill reads the plan, writes a failing test for each behavior, implements the minimal code to pass, refactors, and commits once per phase.

What test runners does this TDD workflow support?

It works with any existing runner such as Vitest, Jest, Playwright, or pytest. The skill discovers your project's test conventions and single-file run command during setup, but it does not install or configure a runner for you.

What happens if a phase already has implementation code?

The skill stops immediately and refuses to write retroactive tests, since TDD requires the failing test to lead the implementation. It directs you to run /10x-implement for that phase instead, and both skills share the same Progress section so state is preserved.

Can I use TDD for scaffolding or configuration phases?

No. Phases involving pure scaffolding, CI wiring, Dockerfiles, or visual polish are flagged as not TDD-able and redirected to /10x-implement. Mixed phases can be split so only the logic portion is driven test-first.

How is progress tracked across multiple sessions?

Progress lives in the plan's Progress section as checkboxes, with commit SHAs appended at each phase end. The first unchecked item is always the next step, so you can clear context and resume with /10x-tdd <change-id> phase N at any time.