🚀 Nuestro primer prompt en un proyecto

Una de las situaciones más habituales cuando trabajamos con un proyecto nuevo es no saber exactamente cómo está organizado ni por dónde empezar.

Aquí es donde OpenCode puede convertirse en una herramienta extremadamente útil.

En lugar de invertir tiempo explorando manualmente carpetas y archivos, podemos pedirle que analice el proyecto por nosotros y nos ayude a entender su estructura.

🧠 El mejor primer prompt posible

Cuando abres un proyecto que no conoces, una de las primeras cosas que puedes hacer es pedirle a OpenCode que actúe como tu copiloto técnico.

La idea es muy simple:

Pídele que explore el proyecto, te explique qué contiene y te recomiende los siguientes pasos.

Un ejemplo de prompt sería:

Explora este proyecto como si fueras mi copiloto técnico y dime:

- Qué archivos hay
- Qué falta por empezar
- Qué paso me recomiendas

No modifiques nada.

Este tipo de prompt proporciona mucho contexto y permite que el agente realice una primera evaluación completa del proyecto.

📂 Analizando un proyecto existente

En la demostración se utiliza un proyecto real que ya cuenta con una estructura definida.

El proyecto contiene:

Componentes
Páginas
Archivos de configuración
Diferentes carpetas organizadas

Es decir, no se trata de un proyecto vacío, sino de una aplicación con cierta complejidad.

Gracias a esto, OpenCode puede inspeccionar el código y generar un análisis útil sobre el estado actual del proyecto.

⚠️ La importancia de indicar que no modifique nada

Hay un detalle muy importante en este primer prompt:

No modifiques nada

¿Por qué conviene añadir esta instrucción?

Porque el objetivo inicial es únicamente comprender el proyecto.

Si simplemente preguntas qué falta por hacer, algunos agentes podrían interpretar que también deben comenzar a realizar cambios.

Al indicar explícitamente que no modifique nada, limitamos la tarea a:

Analizar
Inspeccionar
Recomendar

Pero nunca ejecutar cambios sobre el código.

⌨️ Cómo escribir prompts largos

Mientras escribes un prompt en OpenCode, es importante recordar una combinación de teclas muy útil.

Para insertar un salto de línea:

Shift + Enter

Si pulsas únicamente Enter, el prompt se enviará inmediatamente al modelo.

Por eso, cuando quieras crear instrucciones más elaboradas con varias líneas, utiliza siempre Shift + Enter.

🤔 Entendiendo el proceso de pensamiento

Una vez enviado el prompt, OpenCode comienza a trabajar.

Durante este proceso puedes observar diferentes fases.

Thinking

Cuando aparece la sección de “Thinking”, significa que el modelo está razonando internamente sobre la tarea.

Es normal ver que:

A veces piensa en español
A veces piensa en inglés
Va construyendo progresivamente la respuesta

Esta información permite entender qué está haciendo el agente antes de responder.

🛠️ Uso de herramientas durante el análisis

Además del razonamiento, OpenCode puede ejecutar herramientas para recopilar información.

Por ejemplo:

Explorar directorios
Leer archivos
Revisar la estructura del proyecto
Buscar información relevante

Durante la demostración puede verse cómo inspecciona todos los archivos disponibles para construir una visión general de la aplicación.

Esto es importante porque demuestra que el agente no responde únicamente basándose en el prompt, sino también en la información real del proyecto.

📋 El análisis generado por OpenCode

Después de inspeccionar el proyecto, OpenCode devuelve un informe que incluye:

El stack tecnológico utilizado
La estructura principal de carpetas
Las páginas existentes
Los componentes encontrados
Posibles funcionalidades pendientes

Este tipo de análisis proporciona una visión global del proyecto en pocos segundos.

🎯 Recibiendo recomendaciones accionables

Lo más interesante es que OpenCode no se limita a describir archivos.

También propone acciones concretas.

En la demostración, el agente recomienda ejecutar el proyecto localmente para comprobar el estado real de la aplicación.

Por ejemplo:

npm run dev

La recomendación tiene sentido porque observar únicamente los archivos no siempre permite saber qué partes están completas y cuáles necesitan trabajo adicional.

Ver la aplicación en funcionamiento proporciona mucho más contexto.

💡 Una forma rápida de comprender cualquier proyecto

Este primer prompt es especialmente útil cuando:

Te incorporas a un proyecto existente
Heredas código de otro desarrollador
Retomas un proyecto antiguo
Exploras repositorios desconocidos
Empiezas a colaborar en un equipo

En lugar de dedicar tiempo a inspeccionar manualmente cada carpeta, puedes obtener una explicación inicial generada por IA.

📌 Ideas clave de esta clase

Quédate con estos conceptos:

OpenCode puede analizar proyectos completos existentes.
Un buen primer prompt ayuda a entender rápidamente la estructura del código.
Es recomendable pedir explícitamente que no realice modificaciones.
Puedes utilizar Shift + Enter para crear prompts de varias líneas.
El modelo muestra su proceso de razonamiento mediante la sección “Thinking”.
OpenCode utiliza herramientas para inspeccionar archivos y carpetas.
El análisis incluye estructura, stack tecnológico y posibles tareas pendientes.
El agente puede recomendar los siguientes pasos para avanzar en el proyecto.

🚀 Lo siguiente: empezar a trabajar con el proyecto

Una vez que entiendes la estructura general de la aplicación, ya puedes comenzar a colaborar con OpenCode de forma mucho más efectiva.

Ahora el agente conoce el contexto del proyecto y puede ayudarte a implementar funcionalidades, corregir errores o continuar el desarrollo con mucha más precisión.

💡 Tip: Siempre que abras un proyecto que no conozcas, utiliza primero un prompt de exploración. Dedicar unos segundos a entender la estructura general te ahorrará mucho tiempo durante el desarrollo.