Our review
Automates the full test-driven development workflow by orchestrating parallel test execution and refinement loops.
Strengths
- Parallel execution of multiple TDD tasks for faster feedback
- Seamless integration with existing ticket and design documentation
- Automatic refinement loop to improve code and tests iteratively
- Comprehensive report generation summarizing results
Limitations
- Requires a pre-existing design.md file for the ticket
- Depends on external scripts and the Claude Code environment
- Overhead may be excessive for very simple or small tasks
Use when you have a well-defined ticket with a design document and need to implement and test multiple components concurrently with automatic refinement.
Avoid for trivial tasks where the orchestration overhead outweighs the benefit, or when the design is not yet documented.
Security analysis
CautionThe skill uses Bash to run scripts that manage dependencies and trigger hooks. This is a legitimate use but involves arbitrary command execution within the agent environment, warranting caution.
- •Executes bash commands to run internal Node scripts (resolve-task-dependencies.js and task-runner-hook.js). While these appear to be internal tools, their content is not reviewed, and misuse could lead to arbitrary code execution.
- •Uses the Bash tool extensively, which can modify files and interact with the system, posing a risk if the invoked scripts are compromised or malformed.
Examples
/tdd ticket=TICKET-123/tdd ticket=TICKET-456 iterations=5/tdd ticket=TICKET-789 iterations=10name: tdd description: "Executes complete TDD workflow: parallel TDD → refine-loop" user-invocable: true allowed-tools: Read, Write, Edit, Bash, Task, Skill, Glob, Grep, TaskList, TaskGet, TaskUpdate, TaskOutput hooks: Stop: - hooks: - type: command command: "bash -c 'node ~/.claude/scripts/task-runner-hook.js'"
/tdd
Orchestrator for TDD workflow with parallel execution.
Progress Checklist
- [ ] Step 1: Parse args and set variables
- [ ] Step 2: Invoke ticket-reader agent
- [ ] Step 3: Validate design exists
- [ ] Step 4: Invoke knowledge-reader agent
- [ ] Step 5: Execute TDD with parallel orchestration
- [ ] Step 6: Invoke /refine-loop (if no errors)
- [ ] Step 7: Generate report
Steps
-
Parse args and set variables:
ticket→ TICKET_ID (required, error if not provided)iterations→ MAX_ITERATIONS (default: 10)
-
Invoke ticket-reader agent:
- Task prompt:
OPERATION=get TICKET_ID=$TICKET_ID - If error → END
- Parse output → TICKET_PATH
- Task prompt:
-
Validate design exists:
- Check if <TICKET_PATH>/design.md exists
- If not → Error: "design.md not found. Run /design first.", END
-
Invoke knowledge-reader agent:
- Task prompt:
OPERATION=resolve TICKET_PATH=$TICKET_PATH WORKFLOW=/tdd - Parse output → KNOWLEDGE (empty array if error)
- Task prompt:
-
Execute TDD with parallel orchestration:
a. Get ready tasks:
- Run
node ~/.claude/scripts/resolve-task-dependencies.js --ticket=$TICKET_ID --filter="Implement:" - If no tasks → Error: "No implementation tasks found", END
b. For each ready task:
- TaskGet(task_id) to get task details
- TaskUpdate(task_id, status="in_progress")
- Launch tdd-runner with Task tool:
- subagent_type: tdd-runner
- run_in_background: true
- prompt includes: TASK_SUBJECT, TASK_DESCRIPTION, KNOWLEDGE, CWD
c. Monitor and iterate:
- Use TaskOutput to check completion
- On completion: TaskUpdate(task_id, status="completed")
- Refresh dependencies, launch newly ready tasks
- Repeat until all complete
d. Collect results: TDD_FILES, TDD_TEST_COUNT, TDD_PASSED_COUNT
- Run
-
Invoke /refine-loop (if no TDD errors):
- Args: "type=code-tests ticket={TICKET_PATH} scope=uncommitted iterations={MAX_ITERATIONS}"
-
Generate report:
- Write to <TICKET_PATH>/tdd-report.md
TDD Red-Green-Refactor
Testing
Skill that guides Claude through the complete TDD cycle.
Web Accessibility Audit
Testing
Performs a comprehensive web accessibility audit following WCAG standards.
UAT Test Case Generator
Testing
Generates structured and comprehensive user acceptance test cases.