AGF Code Map (Deeply Understand)

Orchestrates the codemap CLI to build a persistent SQLite code graph, run reverse-BFS change impact analysis, and produce project understanding maps.

Dev & CodingIntermediate★ 412⑂ 14AI score 8/10Last updated: Jul 19, 2026

What it does

This skill teaches Claude when and how to drive the codemap CLI in tools/codemap/.

build/update: build the full code graph into .agf/code-map.db (SQLite), then update incrementally via git diff + dual fingerprints
diff: reverse import BFS over your changes to compute blast radius and a risk score (feeds a reviewer checklist)
explain / onboard / understand: deep node explanation, project overview with complexity hotspots and high fan-in modules, and directory-level understanding maps
search / embed / context: FTS5 keyword search by default, semantic cosine search auto-enabled after embed (three-state graceful degradation), plus subgraph extraction for agent context
dashboard: static cytoscape HTML graph you can open in a browser
Discipline: .agf/* output is a gitignored derived cache; the skill never edits specs, ADRs, or OpenAPI contracts, and never votes a review verdict.

Coverage is 7 languages (Python/TS/JS/SQL/YAML/JSON/Java) with Swift and WXML flagged as honest gaps.

Who it's for

Engineers inheriting a legacy codebase who need Day-1 orientation
Reviewers and tech leads who want evidence-backed PR impact analysis
Architects capturing the current state before writing a PRD or ADR
Requires the AppGenesisForge repo's codemap CLI and a uv environment.

Example uses

Legacy handover: "I just inherited this repo" → codemap build → onboard → dashboard to surface complexity hotspots and dependency hubs.
PR impact review: "What does this change affect versus main?" → codemap diff --base main --hop 2 for reverse dependency paths and risk scores.
Unfamiliar code: "What does OrderService.settle do?" → codemap explain returns neighbors plus relevant source snippets.

· · · 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/pcliangx/AppGenesisForge/HEAD/.claude/skills/agf-code-map/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.

↓ Download 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 .claude/skills/agf-code-map folder from the GitHub repo pcliangx/AppGenesisForge into my ~/.claude/skills/agf-code-map/.
When it's done, tell me in one line what this skill can do.

Install with a command instead

git clone https://github.com/pcliangx/AppGenesisForge.git && mkdir -p ~/.claude/skills && cp -r AppGenesisForge/.claude/skills/agf-code-map ~/.claude/skills/

⚠ This is a third-party skill. Check the source repository before installing.

Open a terminal and clone the repo: git clone https://github.com/pcliangx/AppGenesisForge.git
Create the skills folder: mkdir -p ~/.claude/skills
Copy the skill: cp -r AppGenesisForge/.claude/skills/agf-code-map ~/.claude/skills/
Set up the CLI: install uv, then run cd AppGenesisForge/tools/codemap && uv sync
(Optional) For semantic search: uv sync --extra semantic, then uv run codemap embed (first run downloads ~90MB model plus torch).
From the project you want to analyze, run uv run codemap build ., restart Claude Code, and ask something like "help me understand this project's structure" to trigger the skill.
Add .agf/ to .gitignore since it's a rebuildable cache.

View source on GitHub ↗License: MIT