gsd-map-codebase
FeaturedAnalyze codebase with parallel mapper agents to produce .planning/codebase/ documents
AI & Automation 7,258 stars
494 forks Updated today MIT
Install
Quality Score: 94/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
<objective>
Analyze existing codebase using parallel gsd-codebase-mapper agents to produce structured codebase documents.
Each mapper agent explores a focus area and **writes documents directly** to `.planning/codebase/`. The orchestrator only receives confirmations, keeping context usage minimal.
Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
</objective>
<execution_context>
@~/.claude/gsd-core/workflows/map-codebase.md
</execution_context>
<flags>
- **--fast**: Lightweight scan mode — spawns one mapper agent instead of four. Accepts an optional `--focus` value: `tech`, `arch`, `quality`, `concerns`, or `tech+arch` (default). Faster and lower-context than the full map.
- **--query**: Codebase intelligence query mode. Sub-commands: `query <term>`, `status`, `diff`, `refresh`. Requires intel to be enabled in config (`intel.enabled: true`). Runs inline for query/status/diff; spawns an agent for refresh.
- **(no flag)**: Full parallel map — spawns 4 mapper agents to produce all 7 codebase documents.
</flags>
<context>
Arguments: $ARGUMENTS
Parse the first token of $ARGUMENTS:
- If it is `--fast`: strip the flag, run the scan workflow (passing remaining args including optional --focus).
- If it is `--query`: strip the flag, run the intel workflow (passing remaining args as the subcommand).
- Otherwise: pass all of $ARGUMENTS as focus area to the map-codebase workflow.
**Load project state if exists:**
Check for .planning/STATE.md -...
Details
- Author
- open-gsd
- Repository
- open-gsd/gsd-core
- Created
- 2 months ago
- Last Updated
- today
- Language
- JavaScript
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Solid
gsd-map-codebase
Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
6 Updated today
friday-ai-codes AI & Automation Featured
gsd-onboard
Guide existing codebase onboarding through mapping, doc ingest, and planning setup
7,258 Updated today
open-gsd AI & Automation Featured
gsd-ns-context
codebase intel | map graphify docs learnings mempalace
7,258 Updated today
open-gsd