codemap

Generate hierarchical repository codemaps with hash-based change detection.

Updated Jun 5, 2026
One-click install
npx skills add https://github.com/forgefabrik/agent-bigbrother --skill codemap-forgefabrik
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codemap
Source: https://github.com/forgefabrik/agent-bigbrother/tree/main/.config/opencode/skills/codemap
Command: npx skills add https://github.com/forgefabrik/agent-bigbrother --skill codemap-forgefabrik

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill removes the guesswork from onboarding unfamiliar repositories by creating a structured, folder-by-folder map of the codebase and tracking what changed over time.

Core Features & Use Cases

  • Repository Mapping: Scans a project, selects relevant source and config files, and creates a hierarchical codemap for each folder.
  • Change Tracking: Uses hash-based state in .slim/codemap.json to detect added, removed, and modified files after the initial mapping run.
  • Legacy Migration: Automatically upgrades older .slim/cartography.json state into the current codemap format without losing continuity.
  • Use Case: A new engineer can run the Skill on an unfamiliar repository to generate documentation scaffolding and quickly identify which folders need deeper analysis.

Quick Start

Use the codemap skill to create or refresh a change-aware repository map for the current codebase.

Frequently Asked Questions about codemap

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

FAQPage Schema
How do I generate a hierarchical map of an unfamiliar codebase?

Repository mapping scans a project to select relevant source and config files, creating a hierarchical codemap for each folder. This provides folder-level understanding for unfamiliar codebases and bootstraps documentation scaffolding to identify directories needing deeper analysis.

How does hash-based change detection work for repository mapping?

Hash-based change detection for repository mapping stores file state in a local JSON file. On subsequent runs, it compares current file hashes against this saved state to precisely identify which files were added, removed, or modified since the initial mapping.

Can I migrate legacy cartography state into a new codemap format?

Yes, you can migrate legacy cartography state into a new codemap format. The repository mapping process automatically upgrades older JSON state files into the current format without losing continuity during your workflow.

What is the best way to bootstrap documentation scaffolding for a project?

The best way to bootstrap documentation scaffolding is to run a repository mapping process that generates hierarchical codemaps. This creates an empty scaffold for affected directories, giving you a structured starting point for project documentation.

Does repository mapping work with incremental mapping workflows?

Yes, repository mapping works with incremental mapping workflows by applying deterministic file selection and hash-based change detection. It refreshes the codemap and updates affected directories without requiring a full rescan of the entire codebase.

When do I need empty codemap scaffolding for affected directories?

You need empty codemap scaffolding for affected directories when initializing documentation in newly added folders or when incremental mapping detects changes. It provides a structured placeholder to guide subsequent manual documentation efforts.