Skip to content

README.md

Latest commit

 

History

History
71 lines (44 loc) · 2.64 KB

README.md

File metadata and controls

71 lines (44 loc) · 2.64 KB
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