gsd-map-codebase

Maps codebases into structured reference documents using parallel mapper subagents.

Updated May 11, 2025

Search Tags:#parallel processing #document generation #codebase mapping #secret scanning #GSD

Ready to run

npx skills add https://github.com/rogsme/dotfiles --skill gsd-map-codebase-rogsme

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gsd-map-codebase
Source: https://github.com/rogsme/dotfiles/tree/main/.config/gsd/skills/gsd-map-codebase
Command: npx skills add https://github.com/rogsme/dotfiles --skill gsd-map-codebase-rogsme

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the mapping of a codebase into structured reference documents, streamlining the process for planners and executors in a GSD environment.

Core Features & Use Cases

Parallel Mappers: Utilizes four parallel mapper subagents to explore and document different focus areas.
Incremental Remap: Allows remapping of specific directories, reducing the scope for incremental updates.
Pre-Commit Scan: Performs a secret scan before committing to ensure no sensitive information is exposed.
Documentation Generation: Generates seven structured reference documents under .planning/codebase/.

Quick Start

To map your codebase, run: /gsd-map-codebase

Frequently Asked Questions about gsd-map-codebase

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

FAQPage Schema

How do I automate codebase mapping to generate structured documentation?▼

Automating codebase mapping generates structured reference documents under .planning/codebase/ using parallel mapper subagents. This streamlines the documentation process for planners and executors in a GSD environment.

How does parallel processing work for codebase documentation generation?▼

Parallel processing for codebase documentation utilizes four parallel mapper subagents to explore and document different focus areas simultaneously, generating seven structured reference documents for the mapped codebase.

Can I remap specific directories instead of the entire codebase for incremental updates?▼

Yes, incremental remap allows remapping of specific directories, reducing the scope for incremental updates. This avoids the need to remap the entire codebase when only parts change.

Do I need git to run codebase mapping and secret scanning?▼

Yes, git is required for codebase mapping. The skill performs a pre-commit secret scan before committing to ensure no sensitive information is exposed in the generated reference documents.

What's the best way to prevent secrets from leaking during codebase mapping?▼

The best way to prevent secret leaks during codebase mapping is the pre-commit scan feature, which scans for sensitive information before committing the generated structured reference documents.