codebase-mapping

Map codebase architecture, conventions, and file structure into .codebase/ documentation.

20|3|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/DVNghiem/FlowDeck --skill codebase-mapping-dvnghiem
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-mapping
Source: https://github.com/DVNghiem/FlowDeck/tree/main/src/skills/codebase-mapping
Command: npx skills add https://github.com/DVNghiem/FlowDeck --skill codebase-mapping-dvnghiem

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Map architecture, conventions, and file structure of a codebase into .codebase/ to answer how the project works.

Core Features & Use Cases

  • Produces structured documentation of a codebase into .codebase/ including architecture, conventions, dependencies, and an index.
  • Documents entry points, top-level directories, and key configuration files to speed onboarding and feature planning.
  • Provides a repeatable mapping sequence: inspect manifests, read README, map entry points, document structure, and summarize conventions.

Quick Start

Activate the skill by running the /fd-map-codebase command to generate the .codebase/ documentation.

Frequently Asked Questions about codebase-mapping

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

FAQPage Schema
How do I map a codebase architecture for a new contributor?

To map codebase architecture, the skill reads package manifests, README, and entry points, outputting structured files like ARCHITECTURE.md and INDEX.md into a .codebase/ directory to explain how the project works.

What is the best way to document an unfamiliar repository's file structure?

Document an unfamiliar repository by running a stepwise mapping process that inspects manifests, maps entry points, and outputs documentation covering conventions, dependencies, and top-level directories.

How does generating architecture documentation speed up onboarding?

Generating architecture documentation speeds onboarding by providing new contributors with clear entry points, key configuration files, and project conventions, reducing the time needed to understand cross-module workflows.

Can I use this to map conventions and dependencies for cross-module work?

Yes, you can map conventions and dependencies for cross-module work. It generates DEPENDENCIES.md and CONVENTIONS.md to support feature planning and auditing across different parts of the codebase.

What files do I need to map a codebase successfully?

You need accessible package manifests, a README, and identifiable entry points within the repository. The mapping process reads these to generate the structured .codebase/ documentation output.