map-codebase

Generate a Mermaid diagram, module list, and dependency matrix for codebases.

14|1|Updated May 6, 2026
One-click install
npx skills add https://github.com/wzyxdwll/ccgx-workflow --skill map-codebase-wzyxdwll
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-codebase
Source: https://github.com/wzyxdwll/ccgx-workflow/tree/main/templates/skills/tools/map-codebase
Command: npx skills add https://github.com/wzyxdwll/ccgx-workflow --skill map-codebase-wzyxdwll

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Visualize unfamiliar codebases by generating a structured codebase map and module inventory.

Core Features & Use Cases

  • Mermaid diagram of module dependencies to visualize architecture.
  • Module inventory with entry points and responsibilities.
  • Dependency matrix highlighting cross-module interactions.
  • Writes output to .context/codebase-map.md for /ccg:init workflows and pre-reading materials.
  • Ideal for onboarding, brownfield projects, and codebase risk assessment.

Quick Start

Run /ccg:map-codebase to generate a complete codebase map and module inventory for the current project.

Frequently Asked Questions about map-codebase

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

FAQPage Schema
How do I visualize an unfamiliar codebase and its module dependencies?▼

You can visualize an unfamiliar codebase by generating a structured codebase map that identifies modules, entry points, and dependencies, producing a Mermaid diagram and a module inventory to document the architecture.

What is the best way to map a large monorepo architecture?▼

Mapping a large monorepo is best done by generating a module inventory and a Mermaid dependency diagram that highlights cross-module interactions and core technologies, writing the structured results into a markdown file.

How do I generate a Mermaid diagram for my project's codebase?▼

Generating a Mermaid diagram for your codebase involves running a mapping command that analyzes your project structure, identifies dependencies, and outputs a visual module dependency graph alongside a detailed dependency matrix.

Does codebase mapping work for brownfield project onboarding?▼

Codebase mapping works effectively for brownfield project onboarding and risk assessment by generating pre-reading materials like a module inventory and dependency matrix to help developers quickly understand existing architecture.

Where are the codebase map and module inventory results stored?▼

The codebase map and module inventory results are written to a specific context directory as a markdown file, ensuring the architectural diagrams and dependency matrices integrate seamlessly into pre-reading and initialization workflows.