repomapper v0.1.0: guía operativa AGENTS.md para cualquier repositorio
Genera una guía operativa compacta en formato AGENTS.md para cualquier repositorio de código: subsistemas, tests, convenciones y trampas históricas. 82 tests. Basado en el paper Probe-and-Refine Tuning of Repository Guidance for Coding Agents (2026).
El problema
Los agentes de código necesitan conocimiento operativo del repositorio que no está en el código:
- Qué archivos albergan cada subsistema.
- Cómo ejecutar la suite de tests.
- Qué workflows han llevado históricamente a fixes equivocados.
- Convenciones y estructura del proyecto.
Los humanos mantienen archivos AGENTS.md para aportar ese contexto, pero crearlos a mano es tedioso y se desactualizan.
La solución
RepoMapper automatiza el proceso en tres pasos:
- Escaneo: estructura del repo, lenguaje, entry points, tests, subsistemas, dependencias y convenciones.
- Sondeo: tareas sintéticas (import check, syntax check, test runner, validación de config).
- Generación: guía operativa compacta (<3000 caracteres) en formato AGENTS.md.
Uso básico
git clone https://github.com/amurlaniakea/repomapper.git
cd repomapper
python3 -m venv venv && source venv/bin/activate && pip install -e .
# Generar AGENTS.md para un repositorio
python3 -m repomapper /path/to/repo
Links
¿Cuánto tiempo pierde tu agente en cada repositorio nuevo aprendiendo lo que ya está escrito?
Top comments (0)