df:map-codebase

Coordinate parallel mapper agents to produce eight codebase documents and CLAUDE.md.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/AO-Cyber-Systems/devflow-claude --skill df-map-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: df:map-codebase
Source: https://github.com/AO-Cyber-Systems/devflow-claude/tree/main/skills/df-map-codebase
Command: npx skills add https://github.com/AO-Cyber-Systems/devflow-claude --skill df-map-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Analyze the repository to understand and document an existing codebase by coordinating parallel mapper agents that produce a complete codebase map and a CLAUDE.md, ready for loading into Claude Code.

Core Features & Use Cases

  • Automates codebase analysis and documentation by coordinating parallel df-codebase-mapper agents to produce eight structured documents and a CLAUDE.md.
  • Supports onboarding, architectural understanding, and planning for brownfield or evolving projects.
  • Produces a standardized .planning/codebase/ folder plus CLAUDE.md at the project root for consistent governance.

Quick Start

In Claude Code, run /df:map-codebase on the target project to generate the codebase map and CLAUDE.md.

Frequently Asked Questions about df:map-codebase

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

FAQPage Schema
How do I generate documentation for an existing codebase to use with Claude?

To generate codebase documentation for Claude, you can run the df:map-codebase command to automate analysis and produce a CLAUDE.md file at the project root. This coordinates parallel agents to create structured maps for onboarding and refactoring.

What is a CLAUDE.md file and how does it help with codebase mapping?

A CLAUDE.md file is a synthesized document placed at the project root that provides Claude with a comprehensive understanding of your codebase. It is generated alongside eight structured documents in a .planning/codebase/ directory to enable architectural analysis.

Can I use automated codebase analysis for ongoing brownfield projects?

Yes, automated codebase analysis targets brownfield codebases and ongoing projects. It validates eight structured documents and synthesizes a CLAUDE.md file to support onboarding, refactoring, and architectural understanding for evolving repositories.

What's the best way to document a large codebase architecture for onboarding?

The best way to document a large codebase for onboarding is coordinating parallel mapper agents to produce standardized architectural maps. This generates a .planning/codebase/ folder with eight structured documents and a root CLAUDE.md for consistent governance.

How do I create a standardized codebase map for refactoring?

You create a standardized codebase map for refactoring by running an automated analysis workflow that enforces strict document generation. This validates eight structured documents within a .planning/codebase/ directory and synthesizes a CLAUDE.md at the project root.

Do I need any dependencies to automate codebase documentation generation?

No dependencies are required to automate codebase documentation generation. The workflow independently coordinates parallel mapper agents to analyze your project and output the eight structured documents and final CLAUDE.md file without external tools.