Orchestrates the complete bug-fixing workflow from Jira ticket to implementation. Coordinates multi-agent pipeline (fetch, research, RCA, planning, implementation). Use when starting to fix a bug, user mentions ticket key, managing bug pipeline, checking workflow progress, resuming incomplete bug fix, or coordinating specialized agents.
This skill provides workflow orchestration for the multi-agent bug-fixing pipeline.
+----------+ +----------+ +---------+ +---------+ +------------------+
| FETCH | --> | RESEARCH | --> | VERIFY | --> | RCA | --> | PLAN & IMPLEMENT |
| (Jira) | |(Codebase)| |(Research)| |(Analysis)| | (Fix Bug) |
+----------+ +----------+ +---------+ +---------+ +------------------+
| | | | |
v v v v v
bug-context.md research/ verified- rca-report.md impl-plan.md
*.md research.md + code changes
The coordinator delegates to these specialized agents:
| Agent | Phase | Purpose |
|---|---|---|
| Bug Researcher | 2 | Research codebase context |
| Research Verifier | 3 | Verify research accuracy |
| RCA Analyst | 4 | Root cause analysis |
| RCA Verifier | 5 | Verify RCA accuracy |
| Bug Planner | 6 | Create implementation plan |
| Bug Implementer | 7 | Execute the fix |
.context/active/bugs/{TICKET-ID}/
├── bug-context.md
├── research/
│ ├── hypothesis.md
│ ├── codebase-research.md
│ └── verified-research.md
├── rca-report.md
├── verified-rca.md
├── implementation-plan.md
└── fix-summary.md
@Bug Coordinator EMS-1234
@Bug Coordinator .context/active/bugs/EMS-1234/bug-context.md
/start-bug-workflow EMS-1234
VS Code Setting Enabled:
"chat.customAgentInSubagent.enabled": true
Atlassian MCP Connected (for Jira integration)
All Bug-Fixing Agents Installed:
After Phase 7 completes successfully (fix deployed and validated), automatically trigger archival:
Handoff to Context Lifecycle Manager:
@context-lifecycle-manager archive {TICKET-ID}
What gets archived:
.context/active/bugs/{TICKET-ID}/ directoryResult:
.context/archive/bugs/implemented/Manual override: If automatic handoff doesn't trigger:
User: "Archive the completed bug {TICKET-ID}"
Agent: Executes lifecycle archival for {TICKET-ID}
The workflow requires human approval at critical phases:
These checkpoints ensure the analysis is correct before investing in fix development.
See the Bug Coordinator agent for detailed error handling patterns for: