gsd-map-codebase

Coordinate parallel mapper agents to generate seven codebase documents under .planning/codebase/.

Updated Mar 14, 2026
One-click install
npx skills add https://github.com/novatech2210-cmd/ImidusApp --skill gsd-map-codebase-novatech2210-cmd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-map-codebase
Source: https://github.com/novatech2210-cmd/ImidusApp/tree/main/.codex/skills/gsd-map-codebase
Command: npx skills add https://github.com/novatech2210-cmd/ImidusApp --skill gsd-map-codebase-novatech2210-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly and comprehensively understand an existing codebase by generating a structured map through parallel mapper agents, helping teams understand architecture and state.

Core Features & Use Cases

  • Parallel mapper agents explore distinct focus areas (tech, architecture, quality, concerns) and write structured planning documents.
  • Generates a full codebase map stored in .planning/codebase/ with seven documents, enabling quick onboarding and future audits.
  • Works with existing or evolving projects to refresh understanding after changes.

Quick Start

Run the gsd-map-codebase workflow to initialize or refresh the project codebase map and verify the seven target documents.

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 quickly?

Mapping an unfamiliar codebase is done by coordinating parallel mapper agents that explore tech, architecture, and quality focus areas to generate seven structured planning documents for quick onboarding.

What is the best way to document an unfamiliar codebase before refactoring?

Documenting an unfamiliar codebase before refactoring is best handled by running parallel mapper agents that assess project state and generate seven structured documents under .planning/codebase/ for comprehensive pre-refactoring analysis.

Can I use parallel agents to analyze codebase quality and concerns?

Yes, you can analyze codebase quality and concerns by deploying parallel mapper agents that independently explore these distinct focus areas and write structured planning documents to capture the current project state.

How do I refresh codebase documentation after significant project changes?

To refresh codebase documentation after changes, run the mapping workflow on your evolving project to regenerate the seven structured documents under .planning/codebase/, updating your understanding of the current architecture.

Does codebase mapping require agent orchestration and post-run verification?

Yes, codebase mapping requires agent orchestration for parallel execution and post-run verification to confirm the existence and successful generation of all seven target planning documents.