10x-tdd

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

Updated Aug 26, 2026
One-click install
npx skills add https://github.com/michaail/hybrid-logs-analyzer --skill 10x-tdd-michaail
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-tdd
Source: https://github.com/michaail/hybrid-logs-analyzer/tree/main/.cursor/skills/10x-tdd
Command: npx skills add https://github.com/michaail/hybrid-logs-analyzer --skill 10x-tdd-michaail

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 disciplined test-first development, losing track of progress across phases or writing tests after the code already exists. This Skill drives a plan from context/changes/<change-id>/plan.md through red-green-refactor cycles, one phase at a time, while keeping execution state in the plan's Progress section. ## Core Features & Use Cases - Phase-by-phase TDD loop: For each eligible phase, writes a failing test first, implements the minimal code to pass, then refactors while staying green. - Eligibility gating: Detects phases where implementation already exists or where test-first does not fit (scaffolding, infra, visual polish) and redirects them to /10x-implement instead of forcing low-value tests. - Shared progress tracking: Mutates the same ## Progress section as /10x-implement, so phases can be interleaved between the two skills without losing state, with commit SHAs written back at phase end. - Use Case: A developer has an approved plan for adding OAuth login with four phases. They run /10x-tdd oauth-login phase 1, and the Skill writes failing tests for the token validation logic, implements it minimally, commits the phase, and hands off a resume command for the next phase. ## 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 from its Progress section.

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's Progress section, writes a failing test for the next behavior, implements minimal code to pass, refactors, and commits each phase with its SHA recorded.

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 prints the evidence found and hands off to /10x-implement with a clipboard-copied resume command for that phase.

Does this Skill set up a test runner like Vitest or pytest?

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 directs you to set one up or use /10x-implement instead.

Can I mix TDD phases with regular implementation phases?

Yes. This Skill and /10x-implement read and write the same Progress section identically, so you can TDD one phase, hand the next to /10x-implement, and return later without losing state. Non-TDD'able phases like scaffolding or infra wiring are redirected automatically.

When is test-first development not a good fit for a phase?

Phases involving pure scaffolding, CI or Docker wiring, visual polish without assertions, documentation, or exploratory spikes cannot be meaningfully driven by a failing test. The Skill flags these and offers to hand off, implement inline, or skip.