Skip to content

Add bug-investigator agent - Evidence-based debugging#689

Draft
Canato wants to merge 1 commit intocnt/claudefrom
cnt/claude-bug-investigator
Draft

Add bug-investigator agent - Evidence-based debugging#689
Canato wants to merge 1 commit intocnt/claudefrom
cnt/claude-bug-investigator

Conversation

@Canato
Copy link
Copy Markdown
Member

@Canato Canato commented Apr 19, 2026

Bug Investigator Agent

This PR adds a READ-ONLY bug investigation agent with strict protocols.

Investigation Protocol

6-Step Process:

  1. Reproduce FIRST - Never investigate without reproduction
  2. Gather evidence in parallel - Grep/Read simultaneously
  3. Form hypothesis - Predict before reading code
  4. Verify with evidence - Test hypothesis
  5. Rank evidence quality - ⭐⭐⭐ Controlled > ⭐⭐ Observed > ⭐ Speculation
  6. Circuit breaker - Stop after 3 failures

Agent Configuration

  • Level: 3 (Complex analysis)
  • Model: Sonnet
  • disallowedTools: Write, Edit
  • Role: Investigates, never fixes

Report Template

Structured output with:

  • Summary and GitHub issue reference
  • Verified reproduction steps
  • Root cause with file:line evidence
  • Evidence quality ranking - Proposed solutions with trade-offs
  • Impact assessment
  • Testing strategy

Depends On


Wrote by Claude

- READ-ONLY agent with investigation protocol
- Reproduce FIRST (never investigate without reproduction)
- Evidence quality ranking (controlled > observed > speculation)
- 6-step investigation protocol with circuit breaker
- Structured report template with root cause analysis

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant