ClaudeMap Runtime (Repo Architecture Map)
Turns any repository into a live, human-legible architecture graph and drives that map during code walkthroughs.
Dev & CodingIntermediate★ 285⑂ 16AI score 9/10Last updated: Apr 20, 2026
What it does
- Snapshots the target project root into raw JSON via the bundled
snapshot.js. - Hands the snapshot to the
@claudemap-architectsubagent, which returns a detailed graph JSON grouped into intuitive systems. - Renders the graph in the bundled ClaudeMap Vite UI and keeps it in sync with code changes through
/refresh. - Supports scoped subsystem maps (
/create-map), guided walkthroughs (/explain), and presentation control such as highlight/focus/flows (/show). - Enforces strict failure handling: if the architect pass fails, it stops instead of silently rendering a heuristic graph that would pollute the cache.
Who it's for
- Developers inheriting an unfamiliar or legacy codebase who need the big picture fast.
- Tech leads running onboarding sessions or architecture reviews who want a visual to point at.
- Architects comparing system boundaries before and after a refactor.
Examples
/setup-claudemap ~/work/my-api— build the map for that repo and launch the UI./create-map just the auth subsystem— filter the root graph to auth files and get a richer internal breakdown (2–6 internal subsystems)./refreshthen/explain— diff the repo, preserve untouched architect-authored scoped maps, then walk the request flow step by step on the live map.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/QuinnAho/claudemap/HEAD/skill/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the skill folder from the GitHub repo QuinnAho/claudemap into my ~/.claude/skills/claudemap-runtime/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/QuinnAho/claudemap.git ~/.claude/skills/claudemap⚠ This is a third-party skill. Check the source repository before installing.
- Confirm Node.js is installed (
node -v); Node 18+ is recommended since the bundled UI uses Vite. - Create the skills folder:
mkdir -p ~/.claude/skills - Clone the whole repository (not just the markdown):
git clone https://github.com/QuinnAho/claudemap.git ~/.claude/skills/claudemapskill/commands/*.js,skill/prompts/*, and theapp/directory are all required.
- Also install the packaged
.claude/agents/claudemap-architect.mdsubagent and the.claude/commands/*.mdslash commands as described in the repo README. - Install dependencies:
cd ~/.claude/skills/claudemap && npm install - Restart Claude Code, open the project you want to analyze, and run
/setup-claudemap. - When the map renders, answer the follow-up prompt to request refinements instead of rebuilding from scratch.
View source on GitHub ↗License: MIT