When an issue is labeled 'bug', investigate the codebase, trace the reported behavior to its likely root cause, and post an analysis comment with a suggested fix and a confidence rating.
- Identifier
auto-root-cause-analysis- Version
- 1.1.1
- Steps
- 4
- Triggers
- 1
- issues
- debugging
- analysis
- automated
When it runs
issue.labeled- Settle delay
- 10s after the event
Only when all hold
- issue.addedLabel equals bug
- actor.username not contains [bot]
The pipeline
The graph below is the one the workflow opens with in the builder — same steps, same layout, drawn on the same canvas. The run playing through it is a simulation; the branches and conditions are real.
- 01Issue Labeled bug
triggerThe event that starts the run.
- 02Clone Repository
git.cloneShallow-clones the repository at the right ref.
- 03Analyze Root Cause
agent.runOne agent works the task with its toolkit.
- 04Publish Root Cause Analysis
report.publishPosts or updates a deduplicated report comment.
The agent
Root Cause Analyst
- Base type
- Senior Developer
- Temperature
- 0.2
- Max iterations
- 35
- Tools
- 7
Filesystem · 2
read_fileRead File · readlist_dirList Directory · read
Git provider · 2
list_issuesList Issues · readadd_labelsAdd Labels · write
Code search · 1
code_searchCode Search · read
Terminal · 1
run_terminal_cmdRun Terminal Command · write
Status · 1
update_statusUpdate Status · write
Related playbooks
Duplicate Issue Detector
Compares new issues against existing open ones and links likely duplicates.
Issue Triage
Labels new issues as bug, feature, question, docs, or task and checks for missing info.
Stale Issue Reaper
Weekly sweep that classifies quiet issues by reason, nudges them, and flags the oldest for closure.