IA Mapper

IA-Mapper (Mapper) es una herramienta de análisis de repositorios que genera automáticamente un mapa completo del código fuente, guías de navegación y señales de riesgo mediante subagentes paralelos. Puede usarse como plugin de Claude Code o de forma autónoma con cualquier agente de IA.

¿Qué hace?

• Escanea el repositorio con listado de ficheros consciente de Git y caché local.
• Planifica grupos de subagentes respetando presupuestos de tokens.
• Produce un mapa completo (CODEBASE_MAP.md) y una guía de navegación rápida (CODEBASE_NAV.md).
• Soporta actualizaciones incrementales mediante git diff.
• Identifica puntos de entrada, ficheros más relevantes y zonas de alta actividad (churn).
• Emite señales de riesgo: TODOs/FIXMEs/HACKs, ficheros grandes, tests faltantes y churn.
• Genera hashes de módulo para comparar entre escaneos.

Flujo de trabajo

+-----------+    +-----------------+    +-------------------+    +----------------------+
| scan repo | -> | plan assignments | -> | parallel subagents | -> | CODEBASE_MAP + NAV   |
+-----------+    +-----------------+    +-------------------+    +----------------------+

Instalación

# Via plugin de Claude Code
claude plugins install mapper

# Manual (global)
git clone <repo-url> ~/.claude/skills/mapper

# Por proyecto
git clone <repo-url> .claude/skills/mapper

Uso rápido (CLI)

# Modo completo: scan + plan + risk + merge
python3 skills/mapper/scripts/run-mapper.py . --mode full

# Solo escaneo
python3 skills/mapper/scripts/scan-codebase.py . --format json --out .claude/mapper/scan.json

Modos disponibles

• --mode quick: escaneo + planificación
• --mode full: escaneo + planificación + riesgos + merge
• --mode update: solo cambios desde el último commit
• --mode risk: solo señales de riesgo

¿Para quién es?

Desarrolladores, equipos de ingeniería y agentes de IA que necesitan entender rápidamente un repositorio desconocido, identificar áreas de riesgo o incorporar contexto de código en sesiones de trabajo.