gsd-map-codebase

Map a codebase into seven structured .planning/codebase/ documents using parallel agents.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-map-codebase-trucol270
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-map-codebase
Source: https://github.com/TruCol270/salty-pickle/tree/main/.claude-skills/gsd-map-codebase
Command: npx skills add https://github.com/TruCol270/salty-pickle --skill gsd-map-codebase-trucol270

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill coordinates multiple parallel gsd-codebase-mapper agents to automatically produce a structured set of planning documents describing the current codebase state.

Core Features & Use Cases

  • Parallel mapper agents explore a focus area of the project and write .planning/codebase/ documents for the chosen focus.
  • The orchestrator aggregates confirmations and preserves context isolation, avoiding heavy prompt usage.
  • Output consists of 7 structured documents detailing architecture, structure, conventions, tests, and concerns within the .planning/codebase/ directory.

Quick Start

Run the gsd-map-codebase skill to map the current repository into .planning/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 automatically generate codebase documentation for an existing project?

You can automatically generate codebase documentation by running a workflow that spawns parallel agents to explore the repository and write structured documents covering architecture, structure, conventions, tests, and concerns into the .planning/codebase/ directory.

What is parallel agent orchestration for mapping a codebase?

Parallel agent orchestration for mapping a codebase is a process where an orchestrator spawns multiple agents simultaneously to explore different focus areas, aggregate confirmations, and produce structured documentation while preserving context isolation to avoid heavy prompt usage.

How do I map codebase architecture and structure into planning documents?

You can map codebase architecture and structure into planning documents by executing a mapping workflow that generates seven structured files within the .planning/codebase/ directory, capturing the current state of the repository for brownfield projects and ongoing code evolution.

Can I use parallel agents to document a brownfield codebase?

Yes, you can use parallel agents to document a brownfield codebase. The mapping workflow supports existing projects by generating seven structured documents that detail the architecture, structure, conventions, testing setup, and current concerns within the .planning/codebase/ directory.

What is the best way to document code conventions and testing setup automatically?

The best way to document code conventions and testing setup automatically is using a parallel agent workflow that explores the repository focus areas and outputs structured documentation files detailing conventions, tests, and architectural concerns into .planning/codebase/.

Why does mapping a large codebase require context isolation and parallel agents?

Mapping a large codebase requires context isolation and parallel agents to avoid heavy prompt usage. The orchestrator coordinates four parallel agents to explore focus areas independently, guaranteeing end-to-end mapping while aggregating confirmations efficiently.