gsd-map-codebase

Generate a .planning/codebase-map.md detailing structure, dependencies, and integration points.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/giovannimnz/gsd-caveman-hermes --skill gsd-map-codebase-giovannimnz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-map-codebase
Source: https://github.com/giovannimnz/gsd-caveman-hermes/tree/main/skills/gsd-map-codebase
Command: npx skills add https://github.com/giovannimnz/gsd-caveman-hermes --skill gsd-map-codebase-giovannimnz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Map existing codebases to quickly understand architecture, structure, and entry points.

Core Features & Use Cases

  • Structure Discovery: identify language(s)/frameworks, package manager, directory layout, and entry points.
  • Generate Map: produce a .planning/codebase-map.md detailing overview, tech stack, structure, and dependencies.
  • Integration Points: identify external APIs, databases, services, and authentication mechanisms.

Quick Start

Run the skill in the current project directory to generate a codebase map at .planning/codebase-map.md.

Frequently Asked Questions about gsd-map-codebase

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

FAQPage Schema
How do I map an existing codebase to understand its architecture?

Mapping a codebase involves analyzing the project directory to reveal its architecture, structure, tech stack, and entry points. This Skill generates a markdown file detailing the overview, dependencies, and integration points.

What is the best way to discover entry points and integration points in a brownfield project?

Discovering entry points and integration points in a brownfield project requires scanning the directory layout to identify external APIs, databases, services, and authentication mechanisms. The resulting map documents these connections.

How can I generate a codebase map for new team members onboarding?

Generating a codebase map for onboarding new team members involves running the Skill in the current project directory. It produces a markdown file containing the tech stack, structure, and dependencies to accelerate understanding.

Does the codebase mapping process work without external dependencies?

The codebase mapping process works without external dependencies. It analyzes the existing codebase structure directly to identify languages, frameworks, package managers, and integration points natively.

What file format is used to document the codebase structure and tech stack?

The codebase structure and tech stack are documented using a markdown file format. The Skill creates a specific file at `.planning/codebase-map.md` containing the overview, dependencies, and integration points.