Vibe coding lets you ship fast. But the codebase grows faster than your understanding.
At some point you notice: your agent doesn’t understand your requests as clearly anymore. It makes more mistakes. One change silently breaks three others. You’ve lost track of what’s in the codebase — which pages exist, how features connect, what the data model looks like. The whole thing became a black box, and you’re flying blind.
Cartograph scans your entire codebase and maps it out — every page, feature, user flow, data model, and file. It gives you a bird’s-eye view of your product, scores your code health, defines invariants that should never break, and generates copy-pasteable prompts so your agent has full context without you re-explaining every time.
It’s an open-source agent skill. Runs locally. Your code never leaves your machine.
Learn More · Skills Marketplace · Discord · Issues
See everything that exists in your codebase at a glance:
Cartograph scores your codebase across multiple dimensions and highlights what needs fixing:
Define the rules your product should never violate:
When you or your agent make changes, verify invariants still hold. Catch regressions before they ship.
Tell the cartograph skill what should always be true, in plain language:
/cartograph add this invariant: "credits are always refunded on failed generations"
The agent will:
cartograph-invariants.md at your repo rootInvariants are stored in cartograph-invariants.md using this format:
## Invariant Display Name
---
id: unique-kebab-case-id
severity: critical
enabled: true
tags: [money, credits]
---
**Assertion:** One-sentence claim that must always be true.
**Verification steps:**
1. Concrete step referencing specific files/patterns...
**Pass criteria:** What "passing" looks like.
**Known scope:** Relevant file paths and directories.
**Verification prompt:**
> Self-contained prompt for re-verification by any agent...
Severity levels: critical (money, security, data integrity), high (core product logic), low (conventions). Set enabled: false to pause an invariant. Delete the ## section to remove it permanently.
Run just the invariant verification step without a full scan:
/cartograph verify invariants
This reads cartograph-invariants.md, checks each enabled invariant against your codebase, and prints a pass/fail summary. Results are also written to the invariants key in cartograph.json (all other data is preserved), so you can view them in the visualizer.
Every finding comes with a structured prompt you can paste directly into your agent. Fix code health issues, implement features that integrate correctly with existing code, or consolidate duplicates — all with full codebase context already baked in.
No more re-explaining your product’s architecture every time you prompt. Better context in, better code out.
npx skills add NoodleFlowLabs/cartograph --skill cartograph
/cartograph
Works in Claude Code, Codex, or any agent that supports skills. This scans your entire codebase and outputs cartograph.json with all findings into your project root.
Open the bundled visualizer (assets/visualizer.html) in your browser, or use the hosted copy:
open https://tools.cartograph.sh/visualizer
Drag-drop cartograph.json into the visualizer and explore every dimension.
Use the generated prompts to fix issues and improve health. Run /cartograph again. Repeat until your codebase is healthier, better structured, and your agent performs like it should.
MIT