df:map-codebase
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents and CLAUDE.md. Use when the user wants to understand, analyze, or map an existing codebase. Triggers on: "understand this codebase", "map the code", "analyze architecture", "what does this codebase look like?", "explore the code structure"
npx skills add majiayu000/claude-skill-registry --skill df-map-codebase --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
<objective> Analyze existing codebase using parallel df-codebase-mapper agents to produce structured codebase documents, then synthesize a prescriptive CLAUDE.md. Each mapper agent explores a focus area and **writes documents directly** to `.planning/codebase/`. The orchestrator only receives confirmations, then reads the 8 docs to generate CLAUDE.md with coding rules that Claude Code auto-loads every session. Output: .planning/codebase/ folder with 8 structured documents + CLAUDE.md at project root. </objective> <execution_context> @~/.claude/devflow/workflows/map-codebase.md </execution_context> <context> Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specific subsystem) **Load project state if exists:** Check for .planning/STATE.md - loads context if project already initialized **This command can run:** - Before /df:new-project (brownfield codebases) - creates codebase map first - After /df:new-project (greenfield codebases) - updates codebase map as code evolves - Anytime to refresh codebase understanding </context> <when_to_use> **Use map-codebase for:** - Brownfield projects before initialization (understand existing code first) - Refreshing codebase
What does the df:map-codebase skill do?
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents and CLAUDE.md. Use when the user wants to understand, analyze, or map an existing codebase. Triggers on: "understand this codebase", "map the code", "analyze architecture", "what does this codebase look like?", "explore the code structure"
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill df-map-codebase --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
