repo-cartographer

repo-cartographer is an agent for Claude Code from Ohswedd/praxis. It costs 55 tokens per session (416 once invoked), scanned A, original, MIT.

A read-only codebase mapper that examines an unfamiliar repository and describes its purpose, structure, commands, conventions, integrations, and risks.

In plain words
What is it for?
It is for finding real build, test, run, lint, and format commands; identifying subsystem boundaries; documenting external services and configuration; and preparing information for a project guide.
Why use it?
It gives a new developer or coding agent a grounded overview before they change the code.

Agent for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter; mentions CLAUDE.md.

Part of the praxis plugin — 15 skills, 8 commands, 13 agents, 5 hooks shipped together

Good fit It is for finding real build, test, run, lint, and format commands; identifying subsystem boundaries; documenting external services and configuration; and preparing information for a project guide.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/ohswedd/praxis/repo-cartographer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/Ohswedd/praxis

Made for: Claude Code.

Or install praxis, the plugin that ships this one along with the rest of its 15 skills, 8 commands, 13 agents, 5 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for repo-cartographer

README.md
[![agentmods](https://agentmods.dev/badge/agents/ohswedd/praxis/repo-cartographer/github.svg)](https://agentmods.dev/agents/ohswedd/praxis/repo-cartographer)
Your own site
<a href="https://agentmods.dev/agents/ohswedd/praxis/repo-cartographer"><img src="https://agentmods.dev/badge/agents/ohswedd/praxis/repo-cartographer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for repo-cartographer

Your own site · 80×15
<a href="https://agentmods.dev/agents/ohswedd/praxis/repo-cartographer"><img src="https://agentmods.dev/badge/agents/ohswedd/praxis/repo-cartographer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 55 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 416 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00055 $0.00416
Opus 5 $0.00028 $0.00208
Sonnet 5 $0.00011 $0.00083
Haiku 4.5 $0.00006 $0.00042

Measured 10d ago against content hash 44f52fa9aead, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

repo-cartographer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/praxis/agents/repo-cartographer.md · 37 lines

What it actually says

You are a codebase cartographer. Your job is to understand a repository well enough that a high-quality CLAUDE.md can be written from your output. You never modify anything.

Work from evidence in the repo, not assumptions, and stay language/framework agnostic: infer the stack from the files actually present.

Produce:

  1. Purpose: what this project is, in two or three sentences.
  2. Architecture: the top-level components and how they relate; the request/ data flow if applicable. Keep it to what matters for working in the code.
  3. Commands: the real build, test, run, lint, and format commands, derived from the actual build system (package manager, task runner, Makefile, CI config). Quote them exactly.
  4. Subsystem boundaries: which directories are cohesive enough to warrant their own nested CLAUDE.md, and the one-line responsibility of each.
  5. Conventions in force: formatting, naming, error handling, module layout, commit style; cite where you saw each.
  6. Integration points: external services, datastores, queues, APIs, and how they are configured (env vars, config files), without reading secrets.
  7. Risks / sharp edges: anything a newcomer (human or agent) would get wrong: generated files, non-obvious invariants, footguns.

Be concrete and cite file paths. Flag uncertainty explicitly rather than guessing. Output is structured notes, not prose filler.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 37 lines · 55 tokens per session scan A 44f52fa9aead

Subscribe to this mod's changes

repo-cartographer is an agent published in the GitHub repository Ohswedd/praxis (1 stars, last pushed 1mo ago), licensed MIT. It adds 55 tokens to every session and 416 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

test-guardian

Monitors test coverage gaps when testable code is added or modified — runs the project's test and coverage commands and reports untested code, suite failures, and structural barriers to testing. Does not write tests or change files — only flags what needs testing.

oprogramadorreal/optimus-claude · 54 tokens

code-simplifier

Simplifies and refines code for clarity, consistency, and maintainability while preserving all functionality. Applies safe local simplifications (local renames, dead code, unnecessary nesting) directly and proposes structural changes for approval. Focuses on recently modified code unless instructed otherwise; not for…

oprogramadorreal/optimus-claude · 66 tokens

mp-adversarial-reviewer

Adversarial second-opinion review of a completed masterplan task. The harness runs this agent on the routing policy's adversary lane (breaker role, frontier lane — panel adversarial for cross-vendor coverage) and it returns a severity-first findings digest (CD-10). Runs per done task during execution when the run…

rasatpetabit/masterplan · 87 tokens

mp-planner

Turns an approved spec into an executable masterplan plan — tasks with wave assignments, routing annotations, and verifycommands — and emits plan.index.json. The decomposition judgment runs on the routing policy's planned-execution class (judge role, frontier lane) — the orchestrator dispatches this agent on that…

rasatpetabit/masterplan · 82 tokens

mp-spec-decomposer

Decomposes an approved spec into the subsystem list that parallel planning fans out over — each subsystem a coherent, file-disjoint slice — and judges whether the spec is worth planning in parallel at all. The seam-finding judgment runs on the routing policy's planned-execution class (judge role, frontier lane) — the…

rasatpetabit/masterplan · 93 tokens

mp-subsystem-planner

Drafts the plan FRAGMENT for ONE subsystem of a build — a list of tasks with files, verifycommands, and dependency keys — for parallel planning. The drafting judgment runs on the routing policy's planned-execution class (judge role, frontier lane, writes:false) — the planning fan-out dispatches this agent natively on…

rasatpetabit/masterplan · 95 tokens