cartographer

Maintain a persistent codebase map across agent sessions using structured markdown files.

10|2|Updated Feb 23, 2026
One-click install
npx skills add https://github.com/raddue/crucible --skill cartographer-raddue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cartographer
Source: https://github.com/raddue/crucible/tree/main/skills/cartographer-skill
Command: npx skills add https://github.com/raddue/crucible --skill cartographer-raddue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill prevents agents from wasting time re-discovering codebase structure and details in every session, by maintaining a persistent, living map of the project.

Core Features & Use Cases

  • Persistent Knowledge: Accumulates and stores information about modules, conventions, and potential pitfalls across sessions.
  • Contextual Awareness: Provides relevant module-specific context to subagents, preventing incorrect assumptions and improving efficiency.
  • Three Modes: Operates in 'Record' mode to capture new discoveries, 'Consult' mode to provide high-level structure before tasks, and 'Load' mode to inject detailed module context into subagents.
  • Use Case: Before starting a new feature implementation, consult the codebase map to understand existing module dependencies and responsibilities, ensuring the new code integrates smoothly.

Quick Start

Use the cartographer skill to record what you learned about the new authentication module.

Frequently Asked Questions about cartographer

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

FAQPage Schema
How do I maintain persistent memory of codebase structure across agent sessions?

You can maintain persistent codebase memory by recording module details, conventions, and landmines into structured markdown files, allowing agents to consult or load this context in future sessions without redundant discovery.

What is the best way to provide module-specific context to subagents?

The best way to provide module-specific context is to inject detailed module knowledge from a persistent map into subagents, ensuring they have the correct structural awareness and preventing incorrect assumptions during task execution.

How do I map a codebase to prevent agents from re-discovering module dependencies?

To map a codebase and prevent redundant discovery, use a record mode to capture new findings and a consult mode to surface high-level structure, storing everything in structured markdown for continuous contextual awareness.

Can I use codebase mapping to document project conventions and landmines?

Yes, you can use codebase mapping to document project conventions and landmines by accumulating information across sessions into structured markdown files, preventing agents from repeating past mistakes or violating established standards.

Does persistent codebase memory work without external dependencies?

Yes, persistent codebase memory works without external dependencies by utilizing structured markdown files to store the map, conventions, landmines, and per-module details directly within the project environment.

When do I need a living map of a codebase for developer productivity?

You need a living map of a codebase for developer productivity when starting new feature implementations, allowing you to consult existing module dependencies and responsibilities to ensure new code integrates smoothly without wasting time.