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.