cartography

Generate repository codemaps with file and folder hashes.

Updated Jan 24, 2026

Search Tags:#automation #codebase #repository #map #codemap #change-detection

Ready to run

npx skills add https://github.com/ApexSigma-Solutions/Soma --skill cartography

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: cartography
Source: https://github.com/ApexSigma-Solutions/Soma/tree/main/.claude/Skills/cartography
Command: npx skills add https://github.com/ApexSigma-Solutions/Soma --skill cartography

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Cartography helps orchestrators map and understand codebases by generating hierarchical codemaps and change-tracking state.

Core Features & Use Cases

Initialize mapping state and compute file/folder hashes to track changes over time.
Auto-create empty codemap.md templates in relevant folders for explorers to fill in.
Detect changes and update internal state, delegating exploration tasks to agents.

Quick Start

Initialize mapping: python3 cartographer.py init --root /repo --include "src//*.ts" --exclude "node_modules/" Check changes: python3 cartographer.py changes --root /repo Update state: python3 cartographer.py update --root /repo

Frequently Asked Questions about cartography

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

FAQPage Schema

How do I generate a hierarchical codemap for an unfamiliar repository?▼

To generate a hierarchical codemap, initialize the mapping state to compute file and folder hashes, which then produces per-folder codemap.md templates for explorers to document the repository structure.

How can I track codebase changes over time using file and folder hashes?▼

You can track codebase changes by running the update command to recalculate file and folder hashes, detecting modifications against the persisted state in .slim/cartography.json and delegating exploration to agents.

Does the codebase mapping tool respect .gitignore and custom include/exclude patterns?▼

Yes, the codebase mapping tool natively respects .gitignore rules and supports custom include/exclude pattern handling, ensuring reproducible repository maps filtered to relevant source files.

What is the best way to onboard engineers onto a large, unfamiliar codebase?▼

The best way to onboard engineers is by generating hierarchical codemaps that outline folder structures and tracking state changes, enabling quick comprehension of unfamiliar codebases for audits and maintenance.

Can I use this codebase mapping script for repository audits and maintenance tasks?▼

Yes, you can use the script for repository audits and maintenance tasks, as it records file and folder hashes to detect structural changes and generates per-folder codemaps for comprehensive codebase analysis.