From ai-dev-flow
Generate codebase specs (semantic) for comprehensive project documentation
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai-dev-flow:codemap-creatorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Generate **semantic** codebase specs documentation for a codebase using parallel agents.
Generate semantic codebase specs documentation for a codebase using parallel agents.
docs/codebase/STACK.md - Languages, frameworks, runtime, build toolsINTEGRATIONS.md - External APIs, databases, third-party servicesARCHITECTURE.md - Layers, patterns, data flow, key abstractionsSTRUCTURE.md - Directory organization, file naming, module boundariesCONVENTIONS.md - Naming, imports, error handling, code styleTESTING.md - Test framework, patterns, coverage requirementsCONCERNS.md - Technical debt, fragile areas, known risksGenerate codebase specs from scratch:
/codemap-creator
/codemap-creator src/
Update existing codebase specs with changed files:
/codemap-creator --update
/codemap-creator --update --diff
/codemap-creator --update --pr 456
/codemap-creator src/ → analyzes from src//codemap-creator → analyzes entire projectgit diff to find changed files (default when --update is used)The user invoked this skill with arguments: $ARGUMENTS
Update Mode (if --update present):
--diff or --pr <id>, default to --diff).)Create Mode (default):
.)# For --diff (default)
git diff --name-only && git diff --staged --name-only
# For --pr <id>
gh pr diff <id> --name-only
Launch 4 agents in parallel using a single message with multiple Task tool calls:
# Agent 1: Tech codebase specs (STACK.md, INTEGRATIONS.md)
Task(
subagent_type: "codebase-mapper-tech",
run_in_background: true,
prompt: "Root: <root_dir>"
)
# Agent 2: Architecture codebase specs (ARCHITECTURE.md, STRUCTURE.md)
Task(
subagent_type: "codebase-mapper-arch",
run_in_background: true,
prompt: "Root: <root_dir>"
)
# Agent 3: Quality codebase specs (CONVENTIONS.md, TESTING.md)
Task(
subagent_type: "codebase-mapper-quality",
run_in_background: true,
prompt: "Root: <root_dir>"
)
# Agent 4: Concerns spec (CONCERNS.md)
Task(
subagent_type: "codebase-mapper-concerns",
run_in_background: true,
prompt: "Root: <root_dir>"
)
Output status message and end your turn. The system wakes you when agents finish.
Create Mode:
## Codebase Specs Created
**Location**: docs/codebase/
| File | Content |
|------|---------|
| STACK.md | Languages, frameworks, runtime |
| INTEGRATIONS.md | External services, APIs |
| ARCHITECTURE.md | Layers, patterns, data flow |
| STRUCTURE.md | Directory organization |
| CONVENTIONS.md | Code style, naming, patterns |
| TESTING.md | Test framework, strategies |
| CONCERNS.md | Tech debt, risks |
**Next**: Planning agents will automatically use this documentation.
Update Mode:
## Codebase Specs Updated
**Source**: git diff | PR #X
**Location**: docs/codebase/
| File | Status |
|------|--------|
| STACK.md | Updated |
| INTEGRATIONS.md | Updated |
| ARCHITECTURE.md | Updated |
| STRUCTURE.md | Updated |
| CONVENTIONS.md | Updated |
| TESTING.md | Updated |
| CONCERNS.md | Updated |
| Scenario | Action |
|---|---|
| Root directory not found | Report error, suggest valid paths |
| No files in tree | Report empty, suggest different root |
| Agent fails | Report which agent failed, others continue |
| gh not installed | Report error for PR mode |
# Full specs documentation (project root)
/codemap-creator
# Specs for a subdirectory
/codemap-creator src/
# Update after changes
/codemap-creator --update
/codemap-creator --update --pr 456
npx claudepluginhub dethon/ai-dev-flow --plugin ai-dev-flowAnalyzes codebase structure and updates README.md and docs/ directories to reflect current code state, including changes since last doc update. Triggers on 'update docs' or staleness checks.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.