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.