gsd-map-codebase

Maps codebases into structured reference documents using parallel mapper subagents.

Updated May 11, 2025
One-click install
npx skills add https://github.com/rogsme/dotfiles --skill gsd-map-codebase-rogsme
Or copy as Structured Prompt for Agent
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.