---

name: cartographer description: Meta-skill plugin that generates /atlas skills for any repository, providing AI-optimized codebase navigation plus spec-driven development workflows. Use when the user needs to understand a codebase structure, generate navigation aids, create implementation specs, or review code against documented patterns.

Cartographer

Generate AI-optimized codebase navigation (atlas skills) plus spec-driven development workflows.

Quick Start

Copy# Generate atlas for current codebase
/cartographer:chart

# Use atlas for navigation (auto-invoked)
/atlas

# Spec-driven development
/navigator:plan <task>    # Create implementation spec
/navigator:build <spec>   # Execute spec with patterns
/navigator:review <spec>  # Review against patterns

Core Concepts

Atlas

An atlas is a generated skill (.claude/skills/atlas/) that provides:

• Domain mapping: Where different features/concerns live
• Pattern documentation: How code is structured (controllers, services, etc.)
• Anti-patterns: Codebase-specific mistakes to avoid
• File conventions: Naming and location patterns

Spec-Driven Development

Navigator commands use the atlas to:

1. Plan: Generate specs with relevant pattern context
2. Build: Implement following documented conventions
3. Review: Validate against patterns and anti-patterns

Commands

Cartographer Commands

Navigator Commands

Workflows

New Codebase Setup

Copy/cartographer:chart              # Generate atlas (interactive)
/cartographer:orient             # Add atlas awareness to CLAUDE.md

Feature Development

Copy/navigator:plan add user profiles    # Generate spec
/navigator:build specs/user-profiles.md    # Implement
/navigator:review specs/user-profiles.md   # Review

Atlas Maintenance

Copy/cartographer:health             # Check drift, structure, and quality
/cartographer:rechart            # Update stale areas
/cartographer:capture --pattern  # Add discovered patterns

Agents

The plugin uses specialized agents for complex tasks:

Analysis Agents

Review Agents

Files

Copycartographer/
├── SKILL.md                  # This file
├── .claude-plugin/
│   └── plugin.json           # Plugin metadata
├── commands/
│   ├── cartographer/         # Atlas management commands
│   └── navigator/            # Spec-driven workflow commands
├── agents/
│   ├── surveyor.md           # Codebase analysis
│   ├── auditor.md            # Atlas validation
│   ├── import-analyzer.md    # Import graph analysis
│   └── review/               # Code review agents
├── assets/
│   ├── atlas-templates/      # Generated atlas templates
│   └── embed-templates/      # Standalone command templates
└── references/
    └── atlas-format.md       # Atlas schema documentation

Plugin-Free Operation

Export commands for use without the plugin installed:

Copy/cartographer:embed --output .claude/commands/

This creates standalone command files that maintain full fidelity with plugin commands.

Troubleshooting