recon

Analyze git history and project metrics to generate a codebase health report.

Updated Mar 24, 2023

Search Tags:#codebase #reconnaissance #momentum #churn #bus-factor #bug-clustering

Ready to run

npx skills add https://github.com/j4hr3n/dotfiles --skill recon-j4hr3n

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: recon
Source: https://github.com/j4hr3n/dotfiles/tree/main/configs/claude-code/skills/recon
Command: npx skills add https://github.com/j4hr3n/dotfiles --skill recon-j4hr3n

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Codebase reconnaissance to provide a clear, honest health report before you start working on a project.

Core Features & Use Cases

Identify file churn hotspots, contributor bus-factor, bug clusters, project momentum, and firefighting patterns.
Great for onboarding to a new codebase, auditing a project, or planning refactors.
Use case: Provides a health briefing for a new repository to align on risks and priorities.

Quick Start

Tell me which repository to analyze or point me at a local path, and I'll generate a health report.

Frequently Asked Questions about recon

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

FAQPage Schema

How do I analyze codebase health and identify bug hotspots before a repo handover?▼

To analyze codebase health and identify bug hotspots before a repo handover, you can generate a reconnaissance report that leverages git history and commit messages to compute file churn, bus-factor risk, and bug clusters.

What is a bus-factor risk assessment and when do I need it for my project?▼

A bus-factor risk assessment evaluates contributor distribution within a codebase to identify dependencies on specific individuals. You need this project metric during onboarding, audits, or refactoring to align on operational risks.

How do I get a codebase health briefing for a local repository?▼

To get a codebase health briefing, point the analysis tool at your local repository path. It will process project metrics and deliver a structured, narrative report detailing firefighting patterns and file churn hotspots.

Does codebase reconnaissance work without external dependencies or components?▼

Yes, codebase reconnaissance works without external dependencies or components. It directly analyzes your repository's existing git history and commit messages to compute bug clusters and momentum.

What is the best way to measure file churn and project momentum during an audit?▼

The best way to measure file churn and project momentum during an audit is to compute git history metrics. This approach reveals health signals, bug hotspots, and firefighting patterns for a clear, actionable project view.