tdd-skills

TDD Skills

Claude Code plugin for enforcing strict TDD workflows

v5.1.1: Agent Memory - Reviewers and advisors accumulate project-specific knowledge across sessions

Japanese

Why?

When letting AI write code, these problems often occur:

• Tests aren't written unless explicitly requested
• Quality checks require manual execution
• Context is lost when sessions end

tdd-skills solves these by "enforcing" TDD on Claude Code.

Getting Started

1. Install Plugin

claude

> /plugin marketplace add morodomi/tdd-skills
> /plugin install tdd-core@tdd-skills
> /plugin install tdd-php@tdd-skills  # Choose based on language

2. Project Setup

> TDD setup
# or "onboard"

# Automatically executes:
# - Framework detection
# - CLAUDE.md generation
# - docs/ structure creation

3. Start Development

> I want to add a login feature

# TDD cycle starts automatically:
# INIT -> PLAN -> RED -> GREEN -> REFACTOR -> REVIEW -> COMMIT

Installation

# Register marketplace
/plugin marketplace add morodomi/tdd-skills

# Install TDD workflow
/plugin install tdd-core@tdd-skills

# Language-specific quality tools (choose based on project)
/plugin install tdd-php@tdd-skills       # PHP
/plugin install tdd-laravel@tdd-skills   # Laravel
/plugin install tdd-wordpress@tdd-skills # WordPress / Bedrock
/plugin install tdd-python@tdd-skills    # Python
/plugin install tdd-flask@tdd-skills     # Flask
/plugin install tdd-ts@tdd-skills        # TypeScript
/plugin install tdd-js@tdd-skills        # JavaScript
/plugin install tdd-hugo@tdd-skills      # Hugo SSG
/plugin install tdd-flutter@tdd-skills   # Flutter / Dart

# Multi-language projects (e.g., Laravel + Alpine.js)
/plugin install tdd-php@tdd-skills
/plugin install tdd-js@tdd-skills

TDD Workflow

INIT -> PLAN -> RED -> GREEN -> REFACTOR -> REVIEW -> COMMIT

Phase	Skill	Description
INIT	tdd-init	Create cycle document, scope confirmation
PLAN	tdd-plan	Design & planning
RED	tdd-red	Create failing tests (parallel)
GREEN	tdd-green	Minimal implementation (parallel)
REFACTOR	tdd-refactor	Code improvement
REVIEW	tdd-review	Quality check
COMMIT	tdd-commit	Git commit

Agent Teams Integration (v4.3.0)

When CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS is enabled:

Feature	Without Agent Teams	With Agent Teams
quality-gate	6-agent parallel (subagent)	Debate mode (discuss & refute)
tdd-diagnose	Explore agent parallel investigation	Team debate investigation
tdd-parallel	Not available (sequential fallback)	Cross-layer parallel development

tdd-diagnose (Bug Investigation)

Bug report -> Hypothesis generation -> Parallel investigation -> Root cause
                                         |
                        Investigator 1: "Race condition in auth"
                        Investigator 2: "Cache invalidation issue"
                        Investigator 3: "DB connection timeout"
                                         |
                                    Debate & refute -> Root cause identified

tdd-parallel (Cross-Layer Development)

INIT -> PLAN -> [tdd-parallel] -> REVIEW -> COMMIT
                     |
          Teammate A: Backend  (RED->GREEN->REFACTOR)
          Teammate B: Frontend (RED->GREEN->REFACTOR)
          Teammate C: Database (RED->GREEN->REFACTOR)
                     |
              Integration test -> All green

PdM Delegation Model (v5.0)

Claude acts as a PdM (Product Manager), focusing on planning and decision-making while delegating implementation, testing, and review to specialist agents. This separates concerns and keeps the main context lightweight.

v4.3: Claude --- Read Skill --- Execute phases --- Some subagent parallelization

v5.0: Claude(PdM) --- Plan & Decide --- Delegate --- Autonomous judgment
                          |
                    +-----+-----+
                  architect  red/green  refactorer

3-Block Orchestration

Block	Phases	Description
Planning	INIT -> PLAN -> plan-review	PdM plans, architect agent designs
Implementation	RED -> GREEN -> REFACTOR -> quality-gate	Worker agents implement & review
Finalization	COMMIT	PdM commits with full context

Specialist Agents

Agent	Phase	Role
architect	PLAN	Design and test list creation via Skill(tdd-plan)
red-worker	RED	Test creation (parallel)
green-worker	GREEN	Minimal implementation (parallel)
refactorer	REFACTOR	Code quality improvement via Skill(tdd-refactor)

tdd-orchestrate