What are the L0-L3 mapping levels?

L0 represents the high-level system architecture, L1 covers specific domains, L2 details individual modules, and L3 maps directly to source code symbols.

How do AI agents use these maps?

Agents follow a bootstrap pattern by reading the README and architecture docs first, then drilling down into specific domain maps based on their assigned task.

Can I use this for existing projects?

Yes, the skill includes a 'generate' command that scans your source directory to create a 1:1 map skeleton in Markdown, which you can then fill with descriptions.

How does the skill handle documentation that grows too large?

The skill enforces strict line limits (e.g., 500 lines for L0) to maintain abstraction; if a document exceeds its limit, it is automatically split into the next level down.

Hierarchical Code Mapping

Name: Hierarchical Code Mapping
Author: durandom

bydurandom

0•

학습 및 문서화

Generates and manages multi-level hierarchical code maps to improve codebase navigation and architectural understanding for AI agents and humans.

This skill provides a structured framework for documenting and exploring complex codebases through a hierarchical mapping system ranging from high-level architecture (L0) to specific source code (L3). By enforcing strict size limits and utilizing searchable anchors, it ensures that documentation remains high-level and navigable without overwhelming the user. It is particularly effective for bootstrapping AI agents into new projects, maintaining documentation integrity through automated validation scripts, and creating a reliable navigation layer that synchronizes architectural intent with actual source code implementation.

주요 기능

010 GitHub stars

02Built-in validation for link integrity, anchor uniqueness, and size limits

03Agent-optimized workflows for codebase exploration and mapping

04Automated skeleton generation from source directories with placeholder management

05Hierarchical mapping structure (L0-L3) for tiered codebase orientation

06Grep-friendly anchor system for fast command-line navigation

사용 사례

01Onboarding AI agents or new developers to large, unfamiliar repositories

02Auditing codebase structure and identifying orphaned or undocumented modules

03Maintaining living architectural documentation that stays in sync with code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add durandom/skills code-mapping

For use in Claude.ai and ChatGPT

Download Skill