10x-tdd

Executes approved implementation plans phase by phase through the red-green-refactor test-first cycle.

Updated May 23, 2026
One-click install
npx skills add https://github.com/BMS-kmusial/bms-stream-monitor --skill 10x-tdd-bms-kmusial
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-tdd
Source: https://github.com/BMS-kmusial/bms-stream-monitor/tree/main/.claude/skills/10x-tdd
Command: npx skills add https://github.com/BMS-kmusial/bms-stream-monitor --skill 10x-tdd-bms-kmusial

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Executing a multi-phase implementation plan while keeping tests ahead of code is hard to do consistently — developers often write code first and retrofit tests, losing the design benefits of TDD. This Skill drives an approved plan from context/changes/<change-id>/plan.md to completion one phase at a time, enforcing the failing-test-first discipline and tracking progress in a single source of truth. ## Core Features & Use Cases - Red-Green-Refactor Loop: For each phase, writes a failing test (RED), implements the minimal code to pass (GREEN), then refactors while keeping the suite green. - TDD Eligibility Gate: Before each phase, checks whether implementation already exists (stops and redirects to /10x-implement) and whether the phase is meaningfully test-driven (redirects scaffolding, config, or visual phases). - Progress Tracking & Commit Ritual: Mutates the plan's canonical ## Progress section, runs a manual verification gate, and creates one Conventional-Commits commit per phase with SHA write-back. - Use Case: You have an approved plan for a new API feature with 4 phases. Run /10x-tdd my-feature and each phase is driven test-first, with per-phase commits and checkpoints, while non-TDD'able phases are handed off to /10x-implement. ## Quick Start Ask the assistant to run /10x-tdd with your change-id, for example "drive the oauth-login plan test-first starting at phase 1".

Frequently Asked Questions about 10x-tdd

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

FAQPage Schema
How do I implement a plan test-first with TDD?

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 each behavior, makes it pass with minimal code, 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 a TDD-ability gate before every phase. Scaffolding, config, CI wiring, or visual polish phases are redirected to /10x-implement via a clipboard-copied command, or implemented inline without test-first if you choose that option.

Can I use TDD if the implementation already exists?

No. The skill stops when it detects existing implementation for a phase, because a failing test cannot lead code that is already written. It prints the evidence and redirects you to /10x-implement for 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 suggests setting one up first or using /10x-test-plan.

How is progress tracked across phases and sessions?

The plan's ## Progress section is the single source of truth. Steps flip from [ ] to [x] as they complete, and each phase-end commit's short SHA is appended to the rows that flipped, so you can resume in a fresh context at any time.