bug-hunt

Ranks code chunks by git bug-fix rates and churn to identify root causes.

11|3|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill bug-hunt-artk0de
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-hunt
Source: https://github.com/artk0de/TeaRAGs-MCP/tree/main/.claude-plugin/tea-rags/skills/bug-hunt
Command: npx skills add https://github.com/artk0de/TeaRAGs-MCP --skill bug-hunt-artk0de

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of identifying the true source of software bugs by moving beyond simple text search to analyze historical git signals like bug-fix rates and churn.

Core Features & Use Cases

  • Signal-Driven Investigation: Ranks code chunks by historical stability and bug-fix frequency to identify prime suspects.
  • Causal Chain Analysis: Uses codegraph integration to trace the danger-ranked path from entry points to the suspected failure site.
  • Use Case: When a test fails or a stack trace appears, use this Skill to identify whether the issue lies in a historically unstable module or a coupling point that propagates bugs from upstream.

Quick Start

Use the bug-hunt skill to investigate the root cause of the recent test failure in the authentication service.

Frequently Asked Questions about bug-hunt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of a regression using git history?

Use git history signals like bug-fix rates and relative churn to rank code chunks by historical stability, identifying prime suspects in complex codebases during debugging sessions.

What is git signal-driven debugging and how does it work?

Git signal-driven debugging identifies software failure sources by ranking code chunks using historical git metadata like bug-fix rates and churn rather than relying on simple text search.

How do I trace a fault chain from an entry point to a failure site?

Trace fault chains from entry points to failure sites using codegraph structural analysis to map danger-ranked paths, revealing whether bugs propagate from upstream coupling points.

Do I need a TeaRAGs-MCP server to perform code analysis for bug hunting?

Yes, bug hunting requires TeaRAGs-MCP server integration to access the git-enriched code metadata and codegraph structural analysis needed for root cause identification.

When should I use git history analysis instead of standard debugging?

Use git history analysis instead of standard debugging when tests fail or stack traces appear and you need to determine if issues lie in historically unstable modules or upstream coupling points.

Can I identify unstable modules using bug-fix frequency in my codebase?

Yes, you can identify historically unstable modules by ranking code chunks based on bug-fix frequency and relative churn signals extracted from git history metadata.