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.