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