cartographer

Generates CODEBASE_MAP.md and updates CLAUDE.md summaries via Sonnet subagents.

2|Updated Jan 16, 2026
One-click install
npx skills add https://github.com/olegakbarov/ispo-code --skill cartographer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cartographer
Source: https://github.com/olegakbarov/ispo-code/tree/main/.claude/skills/cartographer
Command: npx skills add https://github.com/olegakbarov/ispo-code --skill cartographer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires tiktoken, and includes scripts (resource) components.

What problem does it solve?

Maps and documents codebases of any size by orchestrating parallel Sonnet subagents to produce a comprehensive CODEBASE_MAP.md with architecture, file purposes, dependencies, and navigation guides, while updating CLAUDE.md with a concise summary.

Core Features & Use Cases

  • Parallel Subagent Mapping: coordinates Sonnet subagents to read and analyze large codebases in parallel, generating centralized documentation and architecture maps.
  • Documentation Synthesis: synthesizes reports into docs/CODEBASE_MAP.md and updates CLAUDE.md with a summary to aid onboarding and maintenance.
  • Change-aware Updates: detects existing maps and updates only changed sections to minimize churn and keep maps current.

Quick Start

Run Cartographer to scan the repository, generate docs/CODEBASE_MAP.md, and update CLAUDE.md with a concise summary.

Frequently Asked Questions about cartographer

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

FAQPage Schema
How do I generate architecture documentation for a large codebase?

Codebase mapping works by deploying parallel Sonnet subagents to read large project files simultaneously, synthesizing their reports into docs/CODEBASE_MAP.md and updating CLAUDE.md with concise summaries for onboarding and navigation.

What is the best way to document an existing codebase for onboarding?

The best way to document an existing codebase is to apply change-aware mapping that detects existing maps and updates only changed sections, minimizing churn while keeping architecture documentation current for onboarding.

Do I need Opus to map a large project with parallel agents?

Yes, codebase mapping requires Opus to plan the work, Sonnet subagents to read files in parallel, and a synthesis step to create the CODEBASE_MAP.md and update CLAUDE.md.

How do I update codebase documentation without rewriting the entire map?

Change-aware codebase mapping detects existing maps and updates only changed sections to minimize churn and keep architecture documentation current.

Does the codebase mapping workflow work with the tiktoken dependency?

Yes, the codebase mapping workflow operates with the tiktoken dependency to orchestrate parallel Sonnet subagents and synthesize documentation for large projects.