codebase-analysis

Analyzes task-scoped code paths and produces a cited analysis.md report.

1|1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/growmax/growmax-skills --skill codebase-analysis-growmax
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: codebase-analysis
Source: https://github.com/growmax/growmax-skills/tree/main/gmax/skills/codebase-analysis
Command: npx skills add https://github.com/growmax/growmax-skills --skill codebase-analysis-growmax

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before fixing a bug or designing a feature, engineers need facts about what the existing code actually does, what it shares, and who depends on it. This Skill performs a task-scoped recon of a codebase and writes an evidence-cited analysis document, replacing guesswork with verified findings. ## Core Features & Use Cases - Task-Scoped Tracing: Follows the call path from the entry point to the behavior in question, citing every hop as path:line, without auditing unrelated code. - Root-Cause Chain for Bugs: Walks Expected Flow, Actual Flow, Failure Point, Root Cause, and Corrected Flow in order, labeling unproven causes as hypotheses with confirming evidence. - Shared-Code and Contract Mapping: Builds a mandatory table of shared symbols with their consumers, marked Structural or Behavioral, and lists external contracts flagged UNVERIFIED when not confirmed. - Use Case: Before modifying a checkout validation function, run this Skill to produce void/<task-slug>/analysis.md showing the flow, every consumer of the shared validation logic, and the API contracts it relies on. ## Quick Start Ask the assistant to analyze the code path behind a specific bug or planned change and write the findings to void/<task-slug>/analysis.md.

Frequently Asked Questions about codebase-analysis

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

FAQPage Schema
How do I analyze a codebase before fixing a bug?▼

Trace the call path from the entry point to the failing behavior, then walk the root-cause chain in order: Expected Flow, Actual Flow, Failure Point, Root Cause, Corrected Flow. Cite every claim with path:line and label unproven causes as hypotheses.

How to find all consumers of a shared function in a codebase?▼

Search imports and references for the shared symbol across the repository and record each consumer path. Mark the symbol Structural (clients, types, utils) or Behavioral (validation, business rules), since behavioral sharing needs deeper scrutiny before changes.

What should a codebase analysis report include before a feature change?▼

Include a plain-words walkthrough of the current flow with path:line citations, the change point or root cause, a mandatory table of shared code and its consumers, external contracts relied on, and open questions the code cannot answer.

When should I mark something UNVERIFIED in code analysis?▼

Mark a claim UNVERIFIED whenever you cannot confirm it directly from the code, such as an external API behavior or schema. An honest gap is safer than presenting a guess as fact, since wrong facts mislead downstream design decisions.

What are the limitations of task-scoped codebase analysis?▼

It deliberately does not audit the whole codebase, so issues outside the traced path are not covered. It also cannot answer questions the code itself does not resolve; those are recorded as open questions for a human.