Entender código que te da miedo tocar: 3 prompts para que Claude te lo desmonte

Abres un repo que no escribiste tú. Heredado, ajeno, o tuyo de hace seis meses. Y no te enteras de nada. Antes de tocar algo y romperlo, que te lo explique Claude. Aquí tienes los 3 prompts que le sueltas para que te desmonte el código, más una checklist para tu primer día en un proyecto que no conoces.

Hasta el propio creador de Claude Code, Boris Cherny, cuenta que una de las primeras cosas para las que usa Claude Code es explicarse código difícil. No es un truco de nicho: es de los usos de primera.

Cómo se usan

Abre Claude Code en la raíz del proyecto (el directorio del código, no una carpeta suelta).
Pega el prompt que necesites tal cual. Si quieres centrarlo en un archivo concreto, dile cuál al final.
Léelo con el código delante. Claude te orienta y acelera, pero contrasta su explicación contra el código real antes de fiarte del todo.

Van en orden: primero entiendes qué hace (A), luego por dónde entra y cómo fluye (B), y al final qué puedes tocar sin liarla (C).

Prompt A — Explícamelo en cristiano

Para cuando abres el repo y no sabes ni por dónde mirar. Que te lo cuente como a alguien que acaba de llegar.

Actúa como un dev senior que me hace de guía en mi primer día en este proyecto.
Yo NO escribí este código y no lo entiendo todavía.

Explícame en lenguaje llano, sin jerga, qué hace este proyecto y para qué existe.

Luego dame un resumen archivo por archivo (o módulo por módulo, si son muchos):
- Qué hace ese archivo, en UNA línea.
- Por qué existe / qué problema resuelve.

Reglas:
- Habla como si se lo contaras a alguien que acaba de llegar, no a un experto.
- Si usas un término técnico que no es obvio, explícalo entre paréntesis la primera vez.
- Si algo no te queda claro del propio código, dilo ("esto no me cuadra") en vez de inventar.

Empieza por el panorama general en 3-4 frases, y después baja al detalle por archivos.

Prompt B — El mapa: por dónde entra y cómo fluye

Una vez sabes qué hay, necesitas saber por dónde empieza todo y cómo se conectan las piezas. Esto es el “mapa” del repo.

Quiero que me hagas el mapa de este proyecto, como un recorrido, no como un volcado técnico.

1. ¿Dónde EMPIEZA la ejecución? Señálame el archivo y la función por donde
   arranca todo (el punto de entrada).
2. Cuéntame el flujo principal paso a paso: cuando entra una petición / se ejecuta
   la acción más típica, ¿qué pasa, en qué orden?
3. ¿Qué piezas se llaman entre sí? Quién llama a quién: A usa B, B usa C...
   Descríbelo como un camino que se sigue, no como una lista de dependencias.

Formato de salida:
- El recorrido en pasos numerados, en lenguaje llano.
- Al final, una frase por cada conexión importante ("X llama a Y para hacer Z").

No me sueltes diagramas ni nada visual: quiero entenderlo leyendo, en cristiano.

Prompt C — Qué puedo tocar sin romper nada

El que de verdad te quita el miedo. Antes de cambiar una línea, que te diga dónde es seguro y dónde está el campo de minas.

Quiero modificar algo en este proyecto, pero no sé qué es seguro tocar y qué es delicado.

Primero DIAGNOSTICA, no cambies nada todavía. Avísame antes de tocar una sola línea.

Dame dos listas claras:

ZONAS SEGURAS de modificar:
- Partes que están bastante aisladas, que casi nada más depende de ellas.
- Por cada una, di por qué es relativamente segura tocarla.

ZONAS FRÁGILES (cuidado):
- Partes de las que dependen muchas otras: si las tocas, puede romperse algo lejano.
- Por cada una, dime QUÉ depende de ella y QUÉ riesgo concreto corro si la cambio.

Y antes de que yo toque nada, dime:
- Qué debería mirar / comprobar primero (tests que existan, dónde se usa eso, etc.).
- Qué pregunta debería hacerle yo a este código antes de modificarlo.

Recuerda: solo diagnóstico. No edites ningún archivo hasta que yo te lo pida.

Checklist: primer día en un repo ajeno

Cuando heredas un proyecto, el orden importa. No empieces tocando: empieza entendiendo. Esto te orienta en los primeros 20 minutos.

✅ Lee el README (si lo hay). Te dice para qué sirve, cómo se arranca y qué necesitas instalar.
✅ Mira la estructura general. Lanza el Prompt A para tener el panorama y el resumen por archivos.
✅ Localiza el punto de entrada. Lanza el Prompt B: por dónde arranca y cómo fluye lo más típico.
✅ Corre los tests (si existen). Antes de tocar nada, comprueba que el proyecto funciona y que tienes una red de seguridad.
✅ Identifica las zonas frágiles. Lanza el Prompt C antes de cambiar una línea: qué es seguro y qué no.
✅ Pide un glosario. Si el proyecto usa palabras raras propias suyas, pídele a Claude que te las traduzca.
✅ Solo entonces, toca. Cambio pequeño primero, vuelve a correr los tests, y comprueba que sigue todo en pie.

Lo honesto

Esto es para que entiendas y decidas tú, no para delegar el criterio. Claude te orienta y te hace entender mucho más rápido un código que te intimida, pero no es infalible: lee su explicación con el código delante y, sobre todo, revisa cualquier cambio antes de aplicarlo. Es tu copiloto para comprender, no el que pilota.

Regla de oro

Primero entiende, luego toca. El miedo a romper un repo ajeno se quita sabiendo qué hace y de qué depende cada parte, no cruzando los dedos.

Sígueme para más trucos con Claude Code e IA → @pabloinpublic

Únete a la comunidad → pabloinpublic.com