map-codebase

Analyze software codebase structure and documentation using parallel agents.

1|2|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/cinjoff/fhhs-skills --skill map-codebase-cinjoff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: map-codebase
Source: https://github.com/cinjoff/fhhs-skills/tree/main/.claude/skills/map-codebase
Command: npx skills add https://github.com/cinjoff/fhhs-skills --skill map-codebase-cinjoff

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the comprehensive analysis and documentation of a software codebase, providing a clear, structured overview of its architecture, technologies, and conventions.

Core Features & Use Cases

  • Automated Codebase Mapping: Generates detailed documentation covering tech stack, architecture, directory structure, coding conventions, testing practices, integrations, and technical debt.
  • Parallel Agent Execution: Utilizes multiple specialized agents to analyze different aspects of the codebase concurrently for efficiency.
  • Use Case: When onboarding a new developer or starting a new feature, use this Skill to quickly generate up-to-date documentation that explains the project's layout, key technologies, and potential areas of concern.

Quick Start

Use the map-codebase skill to analyze the current project's codebase.

Frequently Asked Questions about map-codebase

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

FAQPage Schema
How do I automatically generate documentation for my project architecture?

To generate project architecture documentation automatically, this Skill analyzes your codebase structure using parallel agents to produce structured documents covering tech stack, directory layout, and coding conventions. It writes the comprehensive documentation directly to disk for immediate review.

What is the best way to analyze a codebase for technical debt before a project review?

Analyzing a codebase for technical debt before a project review involves evaluating directory structure, coding conventions, and testing practices. This Skill automates that process using specialized parallel agents to identify potential areas of concern and document them comprehensively.

How do I document coding conventions and tech stack for new developers?

Documenting coding conventions and tech stack for new developers requires extracting project architecture details and structural layouts. This Skill automates onboarding documentation by running parallel agents to analyze the codebase and write structured documents directly to disk.

Can I use parallel agents to map out a codebase directory structure?

Yes, you can use parallel agents to map out a codebase directory structure. This Skill utilizes multiple specialized agents running concurrently to analyze different aspects of your project architecture and write the resulting structured documentation directly to disk.

Does codebase analysis require any specific dependencies or environment setup?

Codebase analysis requires specialized gsd-codebase-mapper agents to write directly to disk, but has no external dependencies listed. You only need the current project's codebase available for the parallel agents to analyze and document.

Why use automated codebase mapping instead of manual documentation?

Automated codebase mapping replaces manual documentation by using parallel agents to concurrently analyze tech stack, architecture, and technical debt. This ensures comprehensive, up-to-date structured documents are written to disk efficiently, reducing human error during developer onboarding.