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:

1. Escaneo: estructura del repo, lenguaje, entry points, tests, subsistemas, dependencias y convenciones.
2. Sondeo: tareas sintéticas (import check, syntax check, test runner, validación de config).
3. 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

• Repo: https://github.com/amurlaniakea/repomapper
• Paper: arXiv:2606.20512

¿Cuánto tiempo pierde tu agente en cada repositorio nuevo aprendiendo lo que ya está escrito?