gsd-map-codebase

Analyze codebases with parallel mapper agents and generate structured documents.

Updated May 28, 2026
One-click install
npx skills add https://github.com/SensLiao/Claude-code-setting --skill gsd-map-codebase-sensliao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-map-codebase
Source: https://github.com/SensLiao/Claude-code-setting/tree/main/skills/gsd-map-codebase
Command: npx skills add https://github.com/SensLiao/Claude-code-setting --skill gsd-map-codebase-sensliao

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the analysis of codebases and generates structured documents to provide a comprehensive overview of the codebase state.

Core Features & Use Cases

  • Parallel Code Analysis: Utilizes multiple mapper agents to explore different focus areas of the codebase simultaneously.
  • Document Generation: Produces structured documents directly in the .planning/codebase/ directory.
  • Query Capabilities: Offers the ability to query codebase intelligence with sub-commands like query, status, diff, and refresh.
  • Use Case: For example, when onboarding to a new codebase, you can use the gsd-map-codebase Skill to quickly understand its structure and identify areas for improvement.

Quick Start

Analyze your codebase with the 'gsd-map-codebase' Skill and generate a comprehensive codebase map using the command: 'gsd-map-codebase --focus tech+arch+quality+concerns'.

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 analysis and generate structured documentation?

To automate codebase analysis, you can use parallel mapper agents to explore your codebase simultaneously and generate structured documents directly in the `.planning/codebase/` directory. This provides a comprehensive overview of the codebase state.

What is the best way to map a brownfield codebase for onboarding?

Mapping a brownfield codebase for onboarding is best done by running parallel mapper agents across different focus areas. This quickly generates structured codebase documents, helping you understand the structure and identify areas for improvement.

Can I query codebase intelligence after generating a codebase map?

Yes, you can query codebase intelligence using sub-commands like `query`, `status`, `diff`, and `refresh`. These commands allow you to check the codebase mapping status or refresh the map after significant changes.

How do I focus codebase mapping on specific areas like architecture and quality?

To focus codebase mapping on specific areas, execute the Skill with a focus parameter such as `--focus tech+arch+quality+concerns`. This directs the parallel mapper agents to analyze those particular aspects of the codebase.

When should I refresh my codebase map?

You should refresh your codebase map after significant changes to the codebase. Using the `refresh` sub-command updates the structured documents, ensuring your codebase intelligence accurately reflects the current state.