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/mapping.json (all other data is preserved), so you can view them in the local UI.
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 writes .cartograph/mapping.json with all findings into your project root.
Start the bundled local UI from your project root:
npm --prefix ./agents/skills/cartograph/app install
npm --prefix ./agents/skills/cartograph/app start
The examples above assume the skill is installed at ./agents/skills/cartograph. If your agent installs skills somewhere else, replace ./agents/skills/cartograph/app with the actual skill path plus /app.
The install is a one-time setup for the skill-local runtime dependencies. The server binds to 127.0.0.1, opens the UI in your browser, watches .cartograph/mapping.json, and refreshes when /cartograph writes a new map. The UI and server are maintained as source under the skill’s app directory; there is no Vite build or generated server bundle to commit.
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