How does it manage Claude's context window?

The skill uses parallel agents that write their findings directly to files. Only success confirmations are sent back to the main orchestrator, keeping the primary context window clean and efficient.

What documents does Kata Codebase Mapper generate?

It generates seven specialized markdown documents: STACK.md, INTEGRATIONS.md, ARCHITECTURE.md, STRUCTURE.md, CONVENTIONS.md, TESTING.md, and CONCERNS.md, all stored in the .planning/codebase/ directory.

Does it support specific programming languages?

Yes, the included code scanner identifies exports, imports, and naming patterns across various languages to build a structured JSON index of your entire codebase.

Can I use this on a brand new project with no code?

While it can be used on greenfield projects as they evolve, it is primarily designed for existing codebases. It automatically skips analysis for trivial repositories with fewer than 5 files.

Codebase Mapper

Name: Codebase Mapper
Author: gannonh

bygannonh

•

Learning & Documentation

Generates comprehensive codebase documentation and structural maps using parallel AI agents to accelerate project onboarding and analysis.

Kata Codebase Mapper is a high-performance analysis tool that deploys parallel mapper agents to scan and document existing brownfield or greenfield projects. By automatically generating structured documentation on tech stacks, architecture, quality conventions, and cross-cutting concerns, it creates a robust mental map within the .planning/ directory. This skill minimizes context usage for the orchestrator while providing deep insights into code structure, dependencies, and project conventions, making it essential for refactoring, onboarding, or initializing new project phases.

Key Features

01Source code scanning for detailed file-level exports and dependency tracking

02Creation of compressed agent-readable intel artifacts and JSON indices

03Automatic generation of 7 structured markdown documents covering architecture and tech stacks

04Minimal context overhead by writing documents directly to the filesystem

05Parallel agent analysis for rapid, multi-perspective codebase mapping

061 GitHub stars

Use Cases

01Refreshing codebase context after significant feature additions or structural shifts

02Onboarding developers to unfamiliar or legacy codebases quickly

03Documenting a project before major refactoring or architectural changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add gannonh/kata-marketplace kata-map-codebase

For use in Claude.ai and ChatGPT

Download Skill