Ejemplo: entender un repositorio nuevo

Los prompts de ejemplo son ilustrativos; los comandos están verificados contra la documentación oficial.

Acabas de clonar un repositorio que no has visto nunca. El objetivo: hacerte un modelo mental de la arquitectura, encontrar los puntos de entrada y dejar por escrito unas instrucciones de proyecto duraderas para que las sesiones futuras arranquen mejor informadas.

El flujo

1. Abre una sesión en la raíz del repositorio.
2. Empieza con preguntas amplias de orientación y luego ve estrechando.
3. Usa un subagente de exploración en solo lectura donde esté disponible.
4. Genera el archivo de instrucciones del proyecto (/init).
5. Haz preguntas de seguimiento sobre las zonas que te interesan.

Claude Code

Abre una sesión interactiva:

cd tu-repo
claude

Genera un CLAUDE.md inicial para que las sesiones futuras carguen el contexto del proyecto solas:

/init

Explora de forma interactiva:

Dame una visión general de este repositorio: qué hace, cuáles son los módulos
principales y dónde está el punto de entrada de la aplicación.

¿Cómo funciona el flujo de autenticación de principio a fin? Trázalo desde el
handler HTTP hasta la base de datos.

Delega la exploración profunda en el subagente Explore integrado (de solo lectura, corre un modelo rápido y admite niveles de profundidad):

Usa un subagente Explore (very thorough) para mapear cómo está estructurado el
módulo de facturación y qué otros módulos dependen de él.

Sigue preguntando sin salir de la sesión y, más adelante, continúa donde lo dejaste:

claude -c    # continúa la conversación más reciente de este directorio

Claude Code también va acumulando aprendizajes entre sesiones por su cuenta (memoria automática).

Codex

Abre la TUI:

cd tu-repo
codex

Genera un AGENTS.md inicial (Codex lee el AGENTS.md del repositorio automáticamente):

/init

Explora de forma interactiva:

Dame una visión general de este repositorio: módulos principales, puntos de
entrada y cómo están conectados entre sí.

Delega la exploración intensiva en lectura en el subagente explorer integrado (los flujos multiagente vienen activados por defecto; features.multi_agent = true):

Lanza un subagente explorer que mapee el módulo de facturación y sus
dependencias, y luego resume aquí lo que encuentre.

Traza una petición de login desde el handler de la ruta hasta la consulta a la
base de datos. Lista los archivos implicados.

Kimi Code

Abre la TUI:

cd tu-repo
kimi

Analiza el código y genera AGENTS.md (el archivo de instrucciones de proyecto de Kimi Code):

/init

Explora de forma interactiva:

Dame una visión general de este repositorio: para qué sirve, módulos
principales y puntos de entrada.

Usa el subagente explore integrado, que es de solo lectura (se lanza con una petición de aprobación en el modo Always Ask por defecto):

Usa el subagente explore para mapear el módulo de facturación y decirme qué
archivos definen su interfaz pública.

Haz preguntas laterales sin ensuciar el hilo principal de la investigación:

/btw ¿Qué framework de tests usa este repositorio?

Relacionado

• Flujos de Claude Code: Claude Code — Flujos de trabajo
• Flujos de Codex: Codex CLI — Flujos de trabajo
• Flujos de Kimi Code: Kimi Code — Flujos de trabajo
• Tablas de referencia rápida: Cheatsheet de las tres herramientas

---

Última verificación: 2026-09-07

Las herramientas de IA para programar evolucionan rápido. Si encuentras información desactualizada, abre un issue o un pull request.