Skip to content

danpeg/bug-hunt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
image

/bug-hunt

Adversarial bug finding skill for Claude Code. Uses 3 isolated AI agents to find and verify real bugs with high fidelity.

How it works

Inspired by @systematicls's article on exploiting LLM sycophancy for better code review:

  1. Hunter - Scans your code and reports every possible bug (biased to over-report)
  2. Skeptic - Tries to disprove each bug (biased to dismiss false positives)
  3. Referee - Reads the code independently and makes final verdicts

Each agent runs in a completely isolated context — they can't see each other's reasoning, only structured findings. This prevents anchoring bias and produces high-fidelity results.

Install

git clone https://github.com/danpeg/bug-hunt.git ~/.claude/skills/bug-hunt

Claude Code auto-discovers skills in ~/.claude/skills/.

Usage

/bug-hunt                              # Scan entire project
/bug-hunt src/                         # Scan specific directory
/bug-hunt lib/auth.ts                  # Scan specific file
/bug-hunt -b feature-xyz              # Scan files changed in feature-xyz vs main
/bug-hunt -b feature-xyz --base dev   # Scan files changed in feature-xyz vs dev

Branch diff mode (-b) scans only files changed in a branch compared to a base branch (defaults to main). It reads the full file contents — not just the diff — so bug detection quality is preserved.

Update

cd ~/.claude/skills/bug-hunt && git pull

Uninstall

rm -rf ~/.claude/skills/bug-hunt

How the scoring works

The scoring incentives are load-bearing — they exploit each agent's desire to maximize its score:

  • Hunter: +1/+5/+10 for low/medium/critical bugs. Motivates thoroughness.
  • Skeptic: Earns points for disproving false positives, but pays 2x penalty for wrongly dismissing real bugs. Creates calibrated caution.
  • Referee: Symmetric +1/-1 scoring with "ground truth" framing. Makes it precise rather than biased.

Attribution

Based on the adversarial bug hunting technique described by @systematicls in "How To Be A World-Class Agentic Engineer."

Brand by Kitt at Curious Endeavor

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

License

License: MIT

MIT

About

Adversarial bug hunting skill for Claude Code. 3 isolated agents (Hunter, Skeptic, Referee) find and verify real bugs.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors