diagnosing-root-causes
Installation
SKILL.md
Diagnosing Root Causes
Use this skill to diagnose a reported problem from supplied resources and deliver an evidence-backed RCA report. The orchestrator classifies the issue, manages clarification and conditional approval gates, routes work to specialist subagents, and keeps conclusions traceable. Raw artifacts stay in subagent contexts; the orchestrator retains only bounded summaries, verdicts, approvals, and drafts.
Execution is a finite state machine. Canonical tables: state-machine.md.
Inputs
| Input | Required | Example |
|---|---|---|
ISSUE |
Yes | "Deploy job fails after dependency update" |
RESOURCES |
Yes | logs/build-42.txt, repo paths, CI URL, commit range |
ISSUE_SOURCE |
No | runtime, CI/CD, or user-report |
REPRODUCTION |
No | npm test -- auth.spec.ts fails locally |
ENVIRONMENT |
No | macOS, Node 22, branch, commit, affected version |
APPROVED_ACTIONS |
No | Handoff-packaging context only (default none). Never permission to execute Tier C. |