harness-hotspot-detector

Analyze Git history and churn data to rank structural risk hotspots.

18|11|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/Intense-Visions/harness-engineering --skill harness-hotspot-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-hotspot-detector
Source: https://github.com/Intense-Visions/harness-engineering/tree/main/agents/skills/claude-code/harness-hotspot-detector
Command: npx skills add https://github.com/Intense-Visions/harness-engineering --skill harness-hotspot-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams identify and prioritize structural risk hotspots in a codebase by analyzing change history, co-change patterns, and churn metrics, enabling proactive architectural decisions.

Core Features & Use Cases

  • CO-CHANGE analysis from Git history to surface files that frequently change together, including distant co-change pairs.
  • CHURN ranking to identify high-velocity files and modules that drive risk.
  • COUPLING validation to detect hidden dependencies by comparing logical and structural relationships, with graph-supported and git-log fallbacks.
  • GENERATE a ranked hotspot report that can guide refactoring and architectural improvements.

Quick Start

Run the hotspot detector on your repository to generate the initial hotspot report.

Frequently Asked Questions about harness-hotspot-detector

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

FAQPage Schema
How do I identify code hotspots using Git history and churn metrics?

Code hotspot detection analyzes Git history, co-change patterns, and churn metrics to rank structural risk areas. It surfaces high-velocity files, distant co-changes, and hidden dependencies, producing a structured report with actionable architectural recommendations.

What is co-change analysis and how does it reveal hidden dependencies?

Co-change analysis identifies files that frequently change together in Git history. By comparing logical and structural relationships, it exposes hidden dependencies and distant co-change pairs that indicate architectural risk across modules.

Can I run hotspot detection on specific modules or on an on-demand basis?

Hotspot detection can be applied to weekly or on-demand analyses across modules. It collects graph or Git history data to compute churn and co-change metrics, generating a ranked hotspot report tailored to your selected scope.

Do I need a graph database to analyze code churn and co-change patterns?

A graph database is not required. The analysis supports graph-enabled data collection but includes a git-log fallback, allowing you to compute churn, co-change, and coupling metrics directly from standard Git history.

What is the best way to prioritize refactoring based on architectural risk?

Prioritize refactoring by generating a ranked hotspot report based on churn and co-change metrics. This identifies high-velocity files and hidden dependencies, providing actionable recommendations to guide proactive architectural improvements.

Why does distant co-change indicate architecture risk in a codebase?

Distant co-change indicates architecture risk because files changing together despite lacking structural connections reveal hidden dependencies. These unexpected coupling patterns surface during Git history analysis and highlight areas needing architectural realignment.