What documentation files does the Codebase Mapper generate?

It generates seven focused files: STACK.md, INTEGRATIONS.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, and CONCERNS.md.

Where is the generated mapping stored?

All documentation is saved in the .planning/codebase/ directory of your project, making it easily accessible for Claude's memory tools.

Does this skill work with existing documentation?

Yes, it detects legacy CODEBASE.md files and uses them as seed context to preserve manual edits and domain knowledge during the migration to granular files.

How does the skill minimize token consumption?

It utilizes a decision matrix to skip unnecessary mapping and offers a '--refresh-stale' flag to update only documents where significant changes are detected.

Codebase Mapper

Name: Codebase Mapper
Author: cinjoff

bycinjoff

•

学习与文档

Automates the discovery and documentation of codebase architecture, tech stacks, and conventions.

The Codebase Mapper skill leverages parallel agents to perform a deep-dive analysis of your repository, generating seven focused markdown files that document everything from the technology stack and external integrations to architectural patterns and fragile code areas. By splitting documentation into task-specific modules, it ensures Claude can retrieve the exact context needed for UI work, API development, or risk assessment without unnecessary token bloat. It supports incremental updates and legacy document migration to keep your technical documentation perfectly in sync with your source code.

主要功能

011 GitHub stars

02Static analysis integration for complexity and duplication metrics

03Parallel multi-agent exploration for rapid analysis

04Generates 7 task-specific documentation files (Architecture, Stack, etc.)

05Incremental updates via --refresh-stale to minimize token usage

06Automated migration of legacy consolidated documentation

使用场景

01Rapidly onboarding developers to large or unfamiliar repositories

02Maintaining up-to-date architectural and convention documentation

03Performing health audits to identify complexity hotspots and technical debt

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cinjoff/fhhs-skills map-codebase

For use in Claude.ai and ChatGPT