map-codebase

Map codebase structure and context into a shareable factual brief.

Updated Mar 18, 2026
One-click install
npx skills add https://github.com/mikecubed/agent-orchestration --skill map-codebase-mikecubed
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: map-codebase
Source: https://github.com/mikecubed/agent-orchestration/tree/main/plugins/flow/skills/map-codebase
Command: npx skills add https://github.com/mikecubed/agent-orchestration --skill map-codebase-mikecubed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps developers and teams quickly understand unfamiliar codebases by generating a structured, shareable factual context brief that downstream skills can consume without re-exploration.

Core Features & Use Cases

  • Structured discovery pass across multiple dimensions to extract project structure, entry points, dependencies, and deployment context.
  • Generates a concise, actionable context brief suitable for onboarding, planning, debugging, and architecture reviews.
  • Automates the production of a standardized brief file at the default location and updates the SESSION.md with progress and decisions.

Quick Start

Map this codebase to produce a factual context brief and save it to the default output location

Frequently Asked Questions about map-codebase

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

FAQPage Schema
How do I document an unfamiliar codebase for developer onboarding?▼

Documenting an unfamiliar codebase for onboarding requires a structured discovery pass across multiple dimensions to extract project structure, entry points, dependencies, and deployment context into a shareable factual context brief.

What is a codebase context brief and when should I generate one?▼

A codebase context brief is a standardized factual summary of a repository's architecture. Generate one during onboarding, planning, debugging, or architecture reviews of unfamiliar repositories to provide immediate downstream context.

How do I generate a codebase architecture summary for planning and debugging?▼

Generate a codebase architecture summary by orchestrating a five-dimension discovery workflow. This process outputs a concise, actionable context brief to a default file path and updates your session tracking file with progress and decisions.

Can I use a structured codebase discovery workflow for architecture reviews?▼

Yes, you can use a structured codebase discovery workflow for architecture reviews. It applies a five-dimension discovery pass to identify project structure and deployment context, outputting a factual brief suitable for evaluating architecture.

Do I need any specific dependencies to map a codebase and produce a context brief?▼

No specific dependencies are required to map a codebase and produce a context brief. The workflow independently identifies existing dependencies and deployment context, saving the output to a default markdown path without external tools.

What is the best way to prepare an unfamiliar repository for flow planning?▼

The best way to prepare an unfamiliar repository for flow planning is to map the codebase first. This generates a factual context brief at the default output location, which downstream flow planning and arch-review steps can directly consume.