Back to Skills

swe-workflow-debug-tdd

verified

Test-driven debugging for failing tests or bugs

View on GitHub

Marketplace

EarthmanWeb

EarthmanWeb/serena-workflow-engine

Plugin

swe

Repository

EarthmanWeb/serena-workflow-engine

skills/swe-workflow-debug-tdd/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
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-tdd

Installation paths:

Claude
.claude/skills/swe-workflow-debug-tdd/
Powered by add-skill CLI

Instructions

## ⚠️ 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`

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1201 chars