map-codebase
SkillDocs & knowledgeLets your agent analyze a codebase and write planning documents describing how it's organized.
Use map-codebase in Claude, ChatGPT or Ahel Desktop
Free. Sign in, add map-codebase and connect your AI. About a minute.
Also: Claude Code · Cursor · Codex
Then ask your AI: use the map-codebase skill
Details
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; Ahel provides instructions and does not run this skill.
No other account needed.
Add Ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
About this skill
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
What this skill tells your AI
The instructions your AI receives, as published by buildomator/buildomator in skills/map-codebase/SKILL.md and read by Ahel’s review.
Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
<execution_context> @${CLAUDE_PLUGIN_ROOT}/workflows/map-codebase.md </execution_context>
Load project state if exists: Check for .planning/STATE.md - loads context if project already initialized
This command can run:
- Before /gsd:new-project (brownfield codebases) - creates codebase map first
- After /gsd:new-project (greenfield codebases) - updates codebase map as code evolves
- Anytime to refresh codebase understanding
<when_to_use> Use map-codebase for:
- Brownfield projects before initialization (understand existing code first)
- Refreshing codebase map after significant changes
- Onboarding to an unfamiliar codebase
- Before major refactoring (understand current state)
- When STATE.md references outdated codebase info
Skip map-codebase for:
- Greenfield projects with no code yet (nothing to map)
- Trivial codebases (<5 files) </when_to_use>
<success_criteria>
- .planning/codebase/ directory created
- All 7 codebase documents written by mapper agents
- Documents follow template structure
- Parallel agents completed without errors
- User knows next steps </success_criteria>
Signals
- GitHub stars
- 91
- Forks
- 12
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
map-codebase- Source
- github.com/buildomator/buildomator
github.com/buildomator/buildomator
Related picks
Skill · affaan-m
Does the same job in other wordscodebase-knowledge-builder
Skill · othmanadi
Does the same job in other wordsgsd-codebase-mapper
Skill · allgpt-co
Does the same job in other wordslark-markdown
Skill · larksuite
The pick for Markdownmarkdown-formatter
Skill · nvidia
The pick for Markdownhandoff
Skill · mattpocock
More in Docs & knowledge