Mapear un código

Un repo que nunca has visto, leído por tres agentes a la vez.

En un código que no conoces, el primer día se va en encontrar dónde vive cada cosa. Apunta una sesión principal al repo y ella reparte la lectura: un ayudante se queda con la capa de datos, otro con la API, otro con el frontend y el build. Cada uno devuelve un resumen corto con rutas de archivos, y la principal escribe una visión general con todos ellos.

Gratis y de código abiertoCorre en Mac y LinuxCon tus propias cuentas de Claude y Codex
La terminal de Claude Code de la sesión principal después de que sus ayudantes informaran, con su resumen conjunto
Grabado en una máquina de demo: la sesión principal resume lo que le devolvieron sus ayudantes.

Pide a un agente que te explique un repo grande y te hace un tour por la primera carpeta

Una sola sesión lo lee todo ella misma, y un repo grande no cabe. Lo que leyó primero sale con detalle, y al resto le toca una frase por cabeza.

Un agente por su cuenta
  • Un solo lector recorriendo todo el repo
  • Detalle donde empezó, suposiciones donde no llegó
  • Cada pregunta de seguimiento vuelve a empezar la lectura
Agentes lado a lado en Overvibe
  • Un ayudante por zona, todos leyendo a la vez
  • Una visión general escrita con cada informe
  • Las preguntas de seguimiento van al ayudante que leyó esa parte

Tres lectores y una visión general

Tú escribes

Soy nuevo en este repo. Haz que unos ayudantes mapeen las partes principales en paralelo y escríbeme una visión general en ARCHITECTURE.md.

  1. 1La principal reparte el repo

    Mira las carpetas de primer nivel y da a cada ayudante una zona y las mismas tres preguntas: qué hay aquí, qué lo llama y qué es arriesgado cambiar.

  2. 2Los ayudantes leen, nadie edita

    Cada uno en su propia terminal bajo la sesión principal, informando de lo que encontró con rutas de archivos.

  3. 3Vuelve la visión general

    La principal escribe ARCHITECTURE.md con los informes y lo termina con lo que todavía no sabe.

Detrás de todo, un ayudante por zona. La segunda línea es para más tarde: el ayudante que leyó la API vuelve con su conversación y responde con lo que ya leyó. Lee la referencia de la CLI

$ overvibe new --attach --tool codex --cwd . --name "repo: map api" \
    --prompt "Read src/api. What is here, what calls it, what is risky to change? Give paths. Do not edit. When done, run: overvibe send \"$OVERVIBE_SESSION\" \"<map>\""
$ overvibe resume "repo: map api" --prompt "Where does the API check auth?"

Con un agente vale cuando

el repo es lo bastante pequeño para leerlo de una vez, o solo te importa un rincón. Pregunta a Claude directamente. Los ayudantes se ganan el sueldo cuando el repo tiene varias partes y cada una lleva su rato leerla.

Preguntas

¿Cambiarán algo los ayudantes?

El prompt les dice que no. Con un repo del que todavía no te fías, inícialos con --mode ask, para que cada herramienta pregunte antes de ejecutar nada y respondas en Overvibe.

¿En qué se diferencia de un informe de investigación?

Es el mismo patrón, apuntado al código. El informe de investigación cubre fuentes de fuera del repo, como documentación, la web y exportaciones.

¿Puedo hacer preguntas un día después?

Sí. Detén a los ayudantes cuando tengas la visión general, y overvibe resume trae a uno de vuelta con su conversación cuando tengas una pregunta sobre su parte.

Otras formas de emparejar agentes

Ten la visión general antes de leer el código

Instala Overvibe, abre una sesión principal en el repo y pide un ayudante por zona.

La app de Overvibe: un coordinador con sus ayudantes Codex y Gemini (agy) en la barra lateral, cada uno con su estado, y una sesión que te espera