Test-driven debugging for failing tests or bugs
View on GitHubEarthmanWeb/serena-workflow-engine
swe
skills/swe-workflow-debug-tdd/SKILL.md
January 25, 2026
Select agents to install to:
npx add-skill https://github.com/EarthmanWeb/serena-workflow-engine/blob/main/skills/swe-workflow-debug-tdd/SKILL.md -a claude-code --skill swe-workflow-debug-tddInstallation paths:
.claude/skills/swe-workflow-debug-tdd/## ⚠️ WORKFLOW INITIALIZATION
**If starting a new session**, first read workflow initialization:
```
mcp__plugin_swe_serena__read_memory("WF_INIT")
```
Follow WF_INIT instructions before executing this skill.
---
# Workflow Debug TDD Skill
Test-driven debugging workflow for rapid iteration.
## Purpose
- Reproduce failing tests/bugs
- Identify root cause
- Implement fix
- Verify fix works
## TDD Cycle
1. **RED** - Confirm test fails / bug reproduces
2. **Analyze** - Identify root cause
3. **GREEN** - Implement minimal fix
4. **Verify** - Confirm test passes / bug fixed
5. **Refactor** - Clean up if needed
## Actions
1. **Run failing test** - Confirm reproduction
2. **Read error output** - Understand failure
3. **Trace to source** - Find root cause
4. **Implement fix** - Minimal change
5. **Re-run test** - Verify fix
## Skill Return Format
```markdown
## Skill Return
- **Skill**: swe-workflow-debug-tdd
- **Status**: [success|needs_clarification|blocked]
- **Findings Summary**: [bug description and fix applied]
- **Artifacts**: [files changed, tests affected]
- **Next Step Hint**: WF_EXECUTE
```
## Exit
`> **Skill /swe-workflow-debug-tdd complete** - bug fixed, returning to WF_EXECUTE`