HomeCasa Prompts

Entender un código desconocido: mapa de arquitectura y guía de incorporación

Convierte la estructura y los archivos clave de un repositorio en un mapa claro: arquitectura, recorrido de una petición, glosario, zonas de riesgo y por dónde empezar para tu tarea concreta. Pensado para ChatGPT, Claude, Gemini y Microsoft Copilot. Incluye 4 variables personalizables y se copia gratis en un clic.

Intermedio · Texto · Pendiente de revisión editorial

Pensado para:

Prompt

Actúa como ingeniero sénior que ayuda a una persona recién llegada a entender un repositorio que no conoce.

Contexto:
- Proyecto y stack: {{proyecto}}
- Árbol de carpetas y archivos clave (README, configuración, punto de entrada, rutas, modelos): {{archivos}}
- Mi tarea concreta en este código: {{tarea}}
- Mi experiencia con este stack: {{experiencia}}

Entregables:
1. Resumen en 5 líneas: qué hace el sistema, para quién y cuáles son sus piezas principales.
2. Mapa de arquitectura: capas o módulos, responsabilidad de cada carpeta importante y cómo se comunican. Incluye un diagrama en Mermaid.
3. Recorrido de una petición o flujo típico de principio a fin, citando archivos y funciones reales que aparezcan en lo que te he pasado.
4. Glosario de términos del dominio y del proyecto que aparecen en el código.
5. Para mi tarea: archivos que probablemente tendré que tocar, en qué orden leerlos y qué tests ejecutar.
6. Zonas de riesgo: código acoplado, magia del framework, configuración por entorno, efectos secundarios ocultos.
7. Diez preguntas concretas para hacer al equipo.

Restricciones:
- Basa todo en lo que te he pasado. Si deduces algo sin verlo, márcalo como [VERIFICAR]; si falta un archivo clave, dime cuál y por qué lo necesitas.
- No inventes nombres de archivos, funciones ni comandos.
- Adapta el nivel de detalle a mi experiencia: {{experiencia}}.
- Si la información no basta para el mapa, pídeme primero los archivos que faltan.

Formato: secciones numeradas, diagrama Mermaid y listas breves.

Cómo usarlo

Genera el árbol con un comando como tree -L 3 -I node_modules o git ls-files y pega también el README, el archivo de configuración principal y el punto de entrada. Si el contexto es grande, comparte el repositorio por partes y pide el mapa al final.

Ejemplo de uso

Proyecto: API de reservas en NestJS con PostgreSQL · Tarea: añadir reembolsos parciales en el módulo de pagos · Experiencia: conozco Node.js pero no NestJS.

Resultado de ejemplo

Suponiendo el árbol de carpetas que has pegado, con la estructura estándar de Symfony 6…

1. Resumen

Tienda online B2C: catálogo, carrito, checkout y pedidos. Controladores en src/Controller, lógica en src/Service, persistencia con Doctrine sobre MySQL y vistas en Twig.

2. Mapa de arquitectura

flowchart LR
  R[config/routes] --> C[src/Controller]
  C --> S[src/Service]
  S --> E[src/Entity + Repository]
  E --> DB[(MySQL)]
  C --> T[templates/ Twig]

5. Para tu tarea: método de envío por peso

Orden de lectura recomendado:

  1. src/Entity/ShippingMethod.php [VERIFICAR] — cómo se modelan los métodos actuales.
  2. El servicio que calcula el coste del envío, probablemente en src/Service/Shipping/ [VERIFICAR].
  3. src/Entity/Product.php — ¿existe ya un campo de peso? Si no, necesitarás una migración de Doctrine.
  4. La plantilla del checkout en templates/checkout/ [VERIFICAR].

Tests a ejecutar: php bin/phpunit tests/Service como mínimo.

6. Zonas de riesgo

  • Listeners de eventos de Doctrine o del kernel que modifican el pedido sin que se vea en el controlador.
  • Configuración distinta por entorno en config/packages/{dev,prod}.

7. Preguntas para el equipo

  1. ¿El peso se guarda en gramos o en kilos?
  2. ¿Las tarifas por peso cambian según el país de destino?…

Datos clave

Categoría
Programación y desarrollo · Documentación
Tipo de resultado
Texto
Nivel
Intermedio
Pensado para
ChatGPT, Claude, Gemini y Microsoft Copilot
Verificado en
Pendiente de verificación editorial
Variables
Proyecto y stack, Árbol y archivos clave, Mi tarea y Experiencia con el stack
Idioma
Español
Precio
Gratis, sin registro
Actualizado
07/11/2026

Preguntas frecuentes

¿Cuánto código tengo que pegar?

Empieza por el árbol de carpetas, el README, la configuración y el punto de entrada. Con eso el modelo puede pedirte los archivos concretos que necesita en lugar de procesar todo el repositorio.

¿Puedo fiarme del diagrama?

Es un punto de partida. Contrasta las partes marcadas como [VERIFICAR] con el código o con el equipo antes de tomar decisiones de diseño.

¿Para qué sirve este prompt?

Convierte la estructura y los archivos clave de un repositorio en un mapa claro: arquitectura, recorrido de una petición, glosario, zonas de riesgo y por dónde empezar para tu tarea concreta.

¿Con qué herramientas de IA funciona?

Está pensado para ChatGPT, Claude, Gemini y Microsoft Copilot. Todavía no lo hemos verificado en estas herramientas, por lo que los resultados pueden variar entre ellas.

¿Cómo personalizo el prompt?

Pulsa «Personalizar» y rellena las variables (Proyecto y stack, Árbol y archivos clave, Mi tarea y Experiencia con el stack). El texto se actualiza al instante y después puedes copiarlo con un clic. Los valores se guardan solo en tu navegador.

¿Necesito experiencia para usarlo?

Es de nivel intermedio: conviene que conozcas el tema para aportar buen contexto y revisar el resultado con criterio.

¿Este prompt es gratis?

Sí. Todos los prompts de HomeCasa Prompts son gratuitos, sin registro ni suscripción. Puedes usarlos también en proyectos profesionales.

¿Puedo fiarme del resultado de la IA?

Úsalo como un borrador de calidad: revisa siempre datos, cifras y afirmaciones importantes antes de publicarlos o tomar decisiones.

Prompts relacionados