claudemap-architect

claudemap-architect is an agent for Claude Code from QuinnAho/claudemap. It costs 38 tokens per session (2,070 once invoked), scanned A, original, MIT.

An architecture-mapping agent that turns a repository snapshot or ClaudeMap graph into a compact, navigable picture of the codebase.

In plain words
What is it for?
Use it to organize major system areas and produce a graph with useful zoom levels for navigating unfamiliar repositories.
Why use it?
It helps developers find where requests enter, where feature logic lives, where data and external services are handled, and which parts are risky or oversized.

Agent for Claude Code

Written for Claude Code: effort in frontmatter. Also seen: model in frontmatter.

Good fit Use it to organize major system areas and produce a graph with useful zoom levels for navigating unfamiliar repositories.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/quinnaho/claudemap/claudemap-architect
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/QuinnAho/claudemap

Made for: Claude Code.

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 claudemap-architect

README.md
[![agentmods](https://agentmods.dev/badge/agents/quinnaho/claudemap/claudemap-architect/github.svg)](https://agentmods.dev/agents/quinnaho/claudemap/claudemap-architect)
Your own site
<a href="https://agentmods.dev/agents/quinnaho/claudemap/claudemap-architect"><img src="https://agentmods.dev/badge/agents/quinnaho/claudemap/claudemap-architect/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 claudemap-architect

Your own site · 80×15
<a href="https://agentmods.dev/agents/quinnaho/claudemap/claudemap-architect"><img src="https://agentmods.dev/badge/agents/quinnaho/claudemap/claudemap-architect.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 38 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,070 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.00038 $0.02070
Opus 5 $0.00019 $0.01035
Sonnet 5 $0.00008 $0.00414
Haiku 4.5 $0.00004 $0.00207

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

Security

Grade A, and why

claudemap-architect 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.

agents/claudemap-architect.md · 149 lines

How it starts

The opening of the file, as written. The whole thing — 149 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You are the ClaudeMap architect. You turn a repository snapshot into a navigable architecture graph that another Claude session can use to find code without searching.

Your only output is the JSON object defined by the enrichment contract. No prose, no markdown, no code fences, no commentary. If you have nothing to say, say nothing.

Primary objective

Produce the smallest graph that lets a reader answer these four questions in one hop from the system level:

  1. Where do requests, commands, or events enter the codebase?
  2. Where does the domain logic for each major feature live?
  3. Where is persistence, external I/O, or infrastructure?
  4. What is risky, oversized, or structurally load-bearing?

A node that does not help answer one of those questions is weight the reader has to carry. Cut it.

Token budget is a constraint

Your output is paid for in tokens. Every node, every field, every character of summary text has a cost. You are not rewarded for emitting more. You are rewarded for emitting the right nodes and nothing else.

Rules:

  • Do not echo snapshot data. The runtime already has lineCount and filePath from the snapshot for every file — you must still include them in file nodes because the schema requires it, but do not comment on them in summary.
  • Summaries are hard-capped. Systems: ≤ 60 chars. Files: ≤ 50 chars. Functions: ≤ 40 chars. Shorter is better. Omit the summary entirely if you cannot say anything useful in that budget.
  • Omit healthReason when health is green. Only include healthReason on yellow or red nodes, and keep the reason under 60 chars.
  • For system nodes with no single representative directory, emit filePath: "". Do not invent paths.
  • Edge type is cosmetic. Default every edge to "imports". Only use extends or uses when the distinction is structural and obvious. Never agonize over it.

Prefer nested systems — this is important

The overview map collapses all edges to top-level systems and hides edges that live entirely inside a subtree, so nested systems are cheap structurally and valuable for navigation. Use them.

Read the full file on GitHub · 149 lines

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 · 149 lines · 38 tokens per session scan A 267aa6eda1ec

Subscribe to this mod's changes

claudemap-architect is an agent published in the GitHub repository QuinnAho/claudemap (290 stars, last pushed 4mo ago), licensed MIT. It adds 38 tokens to every session and 2,070 once invoked, about $0.0002 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-30.

Related

Other agents, from other repositories

plan-implementer

Implement code based on a specific plan or task description. This agent is designed for focused, incremental implementation work where there is a clear specification or plan to execute. Use when there are well-defined implementation tasks from a feature plan.

mhattingpete/claude-skills-marketplace · 50 tokens

shipkit-architect

Engineering Manager — designs HOW to build through engineering definitions, architecture, plans, and technical contracts. Owns engineering-level goals, prompt architecture, and QA. Use when defining mechanisms, designing architecture, creating plans, defining data contracts, auditing prompts, or evaluating technical…

stefan-stepzero/shipkit · 59 tokens

shipkit-reviewer-direction

Direction judgment worker — assesses strategic artifact coherence. Reads why, vision, stage, and goals to verify internal consistency. Writes structured assessment for the direction orchestrator.

stefan-stepzero/shipkit · 38 tokens

shipkit-reviewer-planning

Planning judgment worker — assesses alignment between product definitions, engineering definitions, and specs. Writes structured assessment for the planning orchestrator.

stefan-stepzero/shipkit · 32 tokens

shipkit-reviewer-shipping

Shipping judgment worker — verifies implementation quality across security, functionality, and code quality dimensions. Can dispatch QA sub-skills (ux-audit, semantic-qa, qa-visual). Writes structured verification report for the shipping orchestrator.

stefan-stepzero/shipkit · 53 tokens

shipkit-product-owner

Product Manager — defines WHAT to build through product definitions, specs, and user research. Owns product-level goals. Use when defining features, writing specs, or processing feedback.

stefan-stepzero/shipkit · 40 tokens