context-mapper

Maps codebase structure, dependencies, and conventions into a YAML context map before code changes.

4|2|Updated Jan 27, 2026
One-click install
npx skills add https://github.com/Arete-Consortium/ai-skills --skill context-mapper-arete-consortium
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: context-mapper
Source: https://github.com/Arete-Consortium/ai-skills/tree/main/workflows/context-mapping
Command: npx skills add https://github.com/Arete-Consortium/ai-skills --skill context-mapper-arete-consortium

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents and engineers often make blind changes in unfamiliar or large codebases, causing regressions in distant files and violating project conventions. This Skill performs read-only reconnaissance before any code is written, producing a structured context map that downstream agents consume. ## Core Features & Use Cases - WHY/WHAT/HOW Context Mapping: Captures intent, scope, dependencies, data flows, and an execution strategy as structured YAML with file paths and line numbers as evidence. - Three Mapping Modes: Full mapping for unfamiliar codebases, incremental mapping for targeted changes, and conflict detection when multiple agents touch shared files. - Typed Capability Contracts: Five capabilities (directory scan, dependency analysis, convention detection, change impact analysis, conflict detection) with defined inputs, outputs, and post-execution checks. - Use Case: Before refactoring authentication across 23 routes, run a full mapping to trace the token validation data flow, identify all downstream consumers of the auth middleware, and hand the resulting context map to implementation agents. ## Quick Start Ask the agent to map the context of your codebase for a planned change, for example: map this repository and identify every file affected by modifying the auth handler before I start the refactor.

Frequently Asked Questions about context-mapper

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

FAQPage Schema
How do I analyze a codebase before making a large refactor?▼

Run a full context mapping pass that scans directory structure, traces internal imports and external package dependencies, detects naming and test conventions, and produces a YAML context map. Downstream agents then execute changes using that map instead of exploring blind.

How to detect conflicts when multiple agents edit the same files?▼

Use conflict detection mode, which takes the change sets from each agent, identifies shared files and lock contention, and outputs a recommended execution sequence. This flags merge conflicts before they happen rather than after.

When should I skip codebase context mapping?▼

Skip it for small isolated single-file changes, where mapping overhead exceeds the change complexity, and when the codebase is already well understood from recent work. Also skip it if you need an implementation plan rather than read-only reconnaissance.

Can context mapping modify or fix code it finds?▼

No, the skill is strictly read-only and never writes or modifies code during mapping. It produces a structured context map with evidence, and separate implementation agents or personas perform the actual changes.

What happens when the codebase is too large to map fully?▼

The skill scopes down to change-adjacent files and explicitly notes the boundary of the mapped area. It caps scanning depth and files in scope, and surfaces unmapped regions as known unknowns rather than guessing.