codebase-mapper

Generate CODEBASE.md architecture maps and index artifacts for the Legion workflow.

1|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/9thLevelSoftware/legion-ascended --skill codebase-mapper-9thlevelsoftware
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-mapper
Source: https://github.com/9thLevelSoftware/legion-ascended/tree/main/skills/codebase-mapper
Command: npx skills add https://github.com/9thLevelSoftware/legion-ascended --skill codebase-mapper-9thlevelsoftware

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The codebase-mapper Skill unit provides a comprehensive understanding of your existing codebase by generating an architecture map, enabling easier management, analysis, and planning of software projects.

Core Features & Use Cases

  • Codebase Analysis: Analyze the architecture, functionality, ownership, and more.
  • Generate Codebase Map: Create a CODEBASE.md file for human-readable architecture context.
  • Dataset for legion Commands: Provide index artifacts consumed by legion start, plan, build, review, and status commands.
  • Use Case: Onboarding new developers, reviewing the current architecture, or understanding dependencies.

Quick Start

Map your codebase using the codebase-mapper skill by running: /legion:map

Frequently Asked Questions about codebase-mapper

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

FAQPage Schema
How do I generate an architecture map for my codebase without using AST or LSP analysis?

Generate a codebase architecture map by analyzing source code files to create structured data and metadata artifacts. This approach focuses on human-readable and machine-readable outputs without requiring AST or LSP analysis.

What is the best way to onboard new developers to an existing software project structure?

Onboard developers by generating a CODEBASE.md file that provides human-readable architecture context. This map details the project's architecture, functionality, and ownership for easier understanding and project planning.

Can I use codebase mapping artifacts with legion commands like start, plan, and build?

Yes, codebase mapping provides index artifacts specifically consumed by legion start, plan, build, review, and status commands. These artifacts integrate the architecture map directly into the Legion workflow toolchain.

Does codebase analysis require any specific dependencies or environment setup?

Codebase analysis requires no external dependencies to generate architecture maps. It operates independently using internal scripts and references to analyze source code files and produce structured project metadata.

What is the difference between codebase mapping and deep syntax tree analysis for project planning?

Codebase mapping focuses on structured data and metadata for legion toolchain usage, bypassing deep syntax tree analysis. It generates comprehensive architecture maps for human context and machine-readable artifacts for project planning.

When should I avoid using automated codebase mapping for software project analysis?

Avoid automated codebase mapping if your project requires deep syntax tree or language server protocol analysis rather than structured metadata. This tool generates high-level architecture maps without parsing abstract syntax trees.