code-map

Regenerates a committed codebase router index with dependency edges and freshness checks.

Updated Mar 2, 2026
One-click install
npx skills add https://github.com/supermalang/ai-augmented-coding --skill code-map-supermalang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: code-map
Source: https://github.com/supermalang/ai-augmented-coding/tree/main/.claude/skills/code-map
Command: npx skills add https://github.com/supermalang/ai-augmented-coding --skill code-map-supermalang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill keeps large codebases navigable by regenerating a compact router index that answers where each area lives and what it depends on, so planning and locating work do not require repeated tree-wide grepping.

Core Features & Use Cases

  • Regenerates a committed code map: Produces a machine-generated overview of tracked code areas, key files, file counts, and dependency edges.
  • Supports stack-agnostic navigation: Works across JavaScript, TypeScript, Python, and other common languages by scanning imports, requires, and module references.
  • Detects when the map is stale: Uses a content stamp and check mode to tell you when the index needs regeneration after files are added, moved, or renamed.
  • Use Case: A planner agent can read the map before exploring the repository and quickly identify the right modules, entry points, and downstream dependencies.

Quick Start

Ask the skill to regenerate the code map for the repository and refresh it after structural file changes.

Frequently Asked Questions about code-map

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a code map for repository navigation without grepping the entire tree?

Generate a code map by regenerating the router index, which creates a compact overview of tracked files, key areas, and dependency edges. This allows agents to answer where code lives and what depends on what without tree-wide grepping.

Does this code map tool support stack-agnostic import scanning for languages like JavaScript, Python, and TypeScript?

Yes, the code map supports stack-agnostic navigation by scanning imports, requires, and module references. It works across JavaScript, TypeScript, Python, and other common languages to detect dependency edges.

Why does my dependency graph show stale file references after I moved or renamed code?

Your dependency graph is stale because the committed code map needs regeneration after structural changes. Use the content stamp and check mode to detect staleness and trigger a refresh of the router index.

When do I need to regenerate the codebase router index?

You need to regenerate the codebase router index whenever files are added, moved, or renamed. Regeneration applies deterministic generation from tracked files to keep repository navigation and dependency edges accurate.

Can I use this code map for planning workflows across large codebases?

Yes, you can use this code map for planning workflows across large codebases. A planner agent can read the generated map to quickly identify the right modules, entry points, and downstream dependencies before exploring.