ferrox-map-codebase

Analyze an unfamiliar codebase and generate seven structured documentation outputs.

21|9|Updated Jul 21, 2026
One-click install
npx skills add https://github.com/FerroxLabs/ferrox-factory --skill ferrox-map-codebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ferrox-map-codebase
Source: https://github.com/FerroxLabs/ferrox-factory/tree/main/skills/ferrox-map-codebase
Command: npx skills add https://github.com/FerroxLabs/ferrox-factory --skill ferrox-map-codebase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly understand an unfamiliar codebase without loading everything into context at once. It coordinates parallel mapper agents to produce a structured codebase map directly on disk.

Core Features & Use Cases

  • Parallel codebase analysis: Spawns focused agents for technology, architecture, quality, and concerns.
  • Structured documentation output: Produces seven standard documents under .planning/codebase/ for consistent project intelligence.
  • Workflow support: Useful for brownfield onboarding, post-change refreshes, and pre-refactor investigation.
  • Example use case: Ask it to map a repository before a major refactor so you can review architecture, testing, and risk areas first.

Quick Start

Use the ferrox-map-codebase skill to analyze this repository and generate the full .planning/codebase/ map.

Frequently Asked Questions about ferrox-map-codebase

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

FAQPage Schema
How do I analyze an unfamiliar codebase for onboarding?

To analyze an unfamiliar codebase for onboarding, you can use parallel agents to map repository intelligence across technical, architectural, quality, and risk scenarios. This generates structured documentation directly on disk for consistent project intelligence.

What is the best way to map codebase architecture before a refactor?

The best way to map codebase architecture before a refactor is by spawning focused parallel agents to assess technology, architecture, quality, and concerns. This approach produces seven standard documents under a dedicated directory for pre-refactor investigation.

How does parallel codebase analysis work for large repositories?

Parallel codebase analysis works by spawning focused agents that target specific areas like technology, architecture, and quality. This prevents loading everything into context at once and produces a structured repository intelligence map directly on disk.

What documentation is generated when mapping a repository?

Mapping a repository generates seven standard documents under the `.planning/codebase/` directory. These structured outputs provide consistent project intelligence covering technical, architectural, quality, and risk scenarios.

Can I refresh codebase documentation after major changes?

Yes, you can refresh codebase documentation after major changes by running the analysis again. It supports post-change refreshes by regenerating the structured repository intelligence map to reflect the current state of the codebase.

Do I need to load the entire codebase into context to map it?

No, you do not need to load the entire codebase into context to map it. The skill coordinates parallel mapper agents that analyze the codebase and produce a structured map directly on disk without loading everything at once.