nw-hotspot

Analyze git change frequency to rank the most-changed files.

Updated Mar 18, 2024
One-click install
npx skills add https://github.com/v1bh0r/precise-ledger-pro --skill nw-hotspot-v1bh0r
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nw-hotspot
Source: https://github.com/v1bh0r/precise-ledger-pro/tree/main/nWave/skills/nw-hotspot
Command: npx skills add https://github.com/v1bh0r/precise-ledger-pro --skill nw-hotspot-v1bh0r

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies the most-changed files in a codebase by analyzing git change frequency to guide maintenance focus and reviews.

Core Features & Use Cases

  • Analyze git churn to surface hotspots that indicate high change activity.
  • Rank findings by change frequency and provide inline results or JSON export for tooling integration.
  • Modes include Analyze (default), Rank (post-filter), Detail (deep-dive), and JSON export for downstream automation.
  • Use as a pre-filter to scope downstream analyses or as a post-filter to prioritize existing findings.

Quick Start

Run nw-hotspot to display the top hotspot files in your repository.

Frequently Asked Questions about nw-hotspot

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

FAQPage Schema
How do I find the most frequently changed files in a git repository?

To find the most frequently changed files in a git repository, analyze git change frequency using git log --name-only to count commits per file. This process excludes deleted files and outputs a ranked list of code hotspots to guide maintenance focus and reviews.

What is a git churn analysis and when should I use it?

Git churn analysis is a technique to identify code hotspots by measuring file change frequency. You should use it to guide maintenance focus, prioritize code reviews, or surface files with high change activity that may indicate technical debt or instability.

Can I use git change frequency ranking to filter existing code analysis findings?

Yes, you can use git change frequency ranking as a post-filter to prioritize existing findings. By ranking findings based on file change frequency, you can focus your review efforts on the most actively modified files across your codebases.

How do I export git hotspot analysis results for downstream automation?

You can export git hotspot analysis results for downstream automation using the JSON export mode. This mode outputs the ranked change frequency data as JSON, allowing seamless integration with other tooling and automated maintenance workflows.

Does git churn hotspot analysis require any external dependencies or tools?

Git churn hotspot analysis requires no external dependencies or tools. It operates independently by parsing git log output to count commits per file, excluding deleted files, and generating a ranked result without needing additional software components.

How do I scope downstream codebase analyses using a pre-filter?

To scope downstream codebase analyses using a pre-filter, run a git hotspot analysis to identify high-change-frequency files first. You then use this ranked output to limit subsequent analysis targets, focusing only on the most volatile areas of the codebase.