bug-hunt-swarm
Bug Hunt Swarm deploys four read-only sub-agents in parallel to investigate bugs, regressions, and crashes from different angles—reproduction scope, code paths, recent changes, and proof strategies. The main agent then synthesizes findings into ranked hypotheses with supporting evidence and the fastest path to confirm or disprove each theory, all without making code edits.
Bug Hunt Swarm investigates root causes through parallel read-only analysis, ranking likely culprits and fastest proof paths.
AI-generated summary based on this skill's SKILL.md
Install
Dimillian/Skills/bug-hunt-swarm · repository language: Shell
git clone https://github.com/Dimillian/Skills
cp -r Skills/bug-hunt-swarm ~/.claude/skills/bug-hunt-swarmnpx skillfed install Dimillian/Skills/bug-hunt-swarmFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is Bug Hunt Swarm and how does it find root cause of crashes?
Bug Hunt Swarm is an MIT-licensed investigation framework that deploys four read-only sub-agents in parallel to diagnose bugs, regressions, and crashes from different angles. Each agent examines reproduction scope, code paths, recent changes, and proof strategies independently. The main agent then synthesizes their findings into ranked hypotheses with supporting evidence, helping you identify the root cause without editing code.
Can Bug Hunt Swarm trace a regression to its source using read-only investigation?
Yes. Bug Hunt Swarm traces regressions to their source through read-only investigation. The framework's parallel agents examine code history, recent changes, and execution paths to pinpoint what broke. Findings are ranked by evidence strength, and you get the fastest proof path to confirm or disprove each hypothesis—all without modifying your codebase.
How does Bug Hunt Swarm investigate flaky or intermittent test failures?
Bug Hunt Swarm investigates flaky failures by running multiple agents in parallel, each probing different aspects: reproduction conditions, code paths, timing dependencies, and proof strategies. This multi-angle approach surfaces intermittent patterns and race conditions that single-threaded debugging often misses, then ranks likely causes by evidence.
Why is my code broken and how can Bug Hunt Swarm help diagnose it?
Bug Hunt Swarm diagnoses unexpected behavior and breakage by deploying four read-only agents that examine your code from reproduction scope, path analysis, change history, and proof strategy angles. The framework ranks likely bug causes by evidence strength and provides the fastest confirmation path for each hypothesis, so you understand what broke and why.
Does Bug Hunt Swarm rank bug causes by evidence and proof path?
Yes. Bug Hunt Swarm ranks likely bug causes by evidence and delivers the fastest proof path for each theory. After parallel agents investigate from multiple angles, the main agent synthesizes findings into prioritized hypotheses with supporting evidence, letting you confirm or disprove the most probable causes first.
Can I use Bug Hunt Swarm for production issue debugging without editing code?
Yes. Bug Hunt Swarm is designed for read-only investigation of production issues, crashes, and regressions. The framework deploys parallel agents to analyze reproduction scope, code paths, recent changes, and proof strategies without making edits. You get ranked hypotheses with evidence and the fastest path to root cause, ideal for production diagnostics.
SKILL.md
rendered from the published skill — quoted content, verbatim
Bug Hunt Swarm
Investigate a bug with four read-only sub-agents in parallel, then have the main agent rank the likely causes and recommend the fastest path to prove or fix the issue. This skill is diagnosis-first: do not edit files or implement fixes as part of this workflow.
Step 1: Build the Bug Packet
Start by collecting the smallest useful investigation packet:
- Symptom
- Expected behavior
- Actual behavior
- Reproduction steps, if known
- Scope of impact
- Relevant evidence, such as logs, stack traces, failing tests, screenshots, recent diffs, or environment details
Prefer this source order:
- Direct user description
- Explicit files, stack traces, logs, tests, or screenshots provided by the user
- Current git changes or recent repo history when the bug appears regression-like
- The
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
bug-hunt-swarm/SKILL.md
bug-hunt-swarm/agents/openai.yaml