codebase-explorer

Map codebase structure, dependencies, tests, and debt through five sequential sweeps.

1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/brianmontero18/astral --skill codebase-explorer-brianmontero18
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-explorer
Source: https://github.com/brianmontero18/astral/tree/main/.claude/skills/codebase-explorer
Command: npx skills add https://github.com/brianmontero18/astral --skill codebase-explorer-brianmontero18

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Exhaustive and recursive codebase exploration provides a complete, dependency-aware understanding of a targeted area.

Core Features & Use Cases

  • Five sequential sweeps: structure → patterns → dependencies → tests → debt, with recursive discovery of transitive relations.
  • Architecture mapping: generates directory layout, entry points, and boundary annotations, plus dependency graphs and debt hotspots.
  • Use Case: quickly onboard a new module, assess risk before refactors, and plan integration with minimal surprises.

Quick Start

Provide an entry point (file or folder) and run the explorer in deep mode to begin the five-sweep analysis.

Frequently Asked Questions about codebase-explorer

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

FAQPage Schema
How do I analyze a codebase structure and map dependencies before refactoring?

You can map codebase dependencies by running a deep exploration that recursively discovers transitive relations, generating a dependency graph and structured output suitable for agent workflows during refactoring.

What is recursive dependency discovery for codebase architecture mapping?

Recursive dependency discovery is the process of tracing transitive relations across modules to generate a complete dependency graph, enabling teams to understand architecture and assess integration risk before changes.

How do I assess technical debt hotspots and test coverage in a large codebase?

Assess technical debt and test coverage through a sequential sweep that analyzes tests and identifies debt hotspots, providing an exhaustive understanding of risk areas across any sizable module with a clear entry point.

Does the codebase exploration support onboarding to new modules with minimal setup?

Yes, codebase exploration supports new module onboarding by requiring only a clear entry point file or folder, then executing five sequential sweeps to map architecture, patterns, dependencies, tests, and debt automatically.

Can I integrate codebase architecture mapping output with external scripts and agent workflows?

Yes, codebase architecture mapping produces structured output suitable for agent workflows, with optional integration to scripts, references, and assets as needed for downstream automation and analysis.