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.