🏗️ Build y Plan en OpenCode
Una de las características más interesantes de OpenCode es que incorpora distintos tipos de agentes especializados.
Cada agente tiene responsabilidades diferentes y está diseñado para resolver tareas concretas dentro de tu flujo de trabajo.
Los dos agentes públicos más importantes son:
- Build
- Plan
Entender la diferencia entre ambos es fundamental para trabajar de forma segura y eficiente.
🤖 Los agentes tienen comportamientos distintos
Aunque ambos utilizan modelos de inteligencia artificial, no trabajan de la misma forma.
OpenCode permite cambiar rápidamente entre ellos utilizando el selector de agente.
Al hacerlo, cambia completamente la forma en que la IA interactúa con tu proyecto.
No es simplemente una diferencia de nombre. Cada agente tiene permisos y objetivos distintos.
🏗️ Build: el agente que puede modificar tu proyecto
El agente Build está pensado para construir e implementar cambios.
Su característica principal es que tiene permisos para escribir en disco.
Esto significa que puede:
- Modificar archivos
- Crear nuevo código
- Actualizar componentes
- Reorganizar estructuras del proyecto
- Aplicar cambios automáticamente
Cuando le pides una tarea a Build, el agente puede ejecutar directamente las modificaciones necesarias para completarla.
Por eso es ideal cuando ya tienes claro qué quieres hacer.
📋 Plan: el agente que analiza sin tocar nada
El agente Plan tiene un objetivo completamente distinto.
A diferencia de Build:
Plan no tiene permisos de escritura.
Esto significa que puede explorar el proyecto, entenderlo y razonar sobre él, pero no modificará absolutamente ningún archivo.
Su trabajo consiste en:
- Analizar la estructura del proyecto
- Detectar oportunidades de mejora
- Identificar problemas potenciales
- Proponer soluciones
- Elaborar planes de implementación
Gracias a esta limitación, puedes pedir análisis complejos sin miedo a que la IA empiece a modificar archivos por su cuenta.
🔍 Un ejemplo práctico de uso
Imagina que quieres mejorar el rendimiento de una aplicación.
En lugar de utilizar directamente Build, puedes comenzar con Plan y solicitar algo como:
Quiero mejorar el rendimiento del proyecto.
El agente recorrerá el código base, analizará recursos, componentes y configuraciones para detectar posibles problemas.
Posteriormente generará un plan con recomendaciones concretas.
Por ejemplo:
- Recursos que podrían optimizarse
- Imágenes mal ubicadas
- Scripts innecesarios
- Componentes costosos
- Problemas de organización
Todo ello sin modificar una sola línea de código.
💬 Refinar el plan antes de implementar
Una de las ventajas más potentes de Plan es que puedes conversar sobre el resultado.
Una vez generado el plan puedes indicar:
- Qué partes implementar
- Qué cambios descartar
- Qué prioridades seguir
- Qué aspectos profundizar
Por ejemplo:
- Implementa únicamente esta mejora
- No quiero este cambio
- Explora una alternativa diferente
- Hazme más preguntas antes de continuar
De esta forma la IA actúa más como un arquitecto técnico que como un ejecutor automático.
🚀 Combinar Plan y Build
Una estrategia muy útil consiste en utilizar ambos agentes de forma secuencial.
El flujo habitual sería:
- Analizar con Plan.
- Revisar y ajustar las propuestas.
- Cambiar a Build.
- Implementar únicamente las mejoras seleccionadas.
Además, es posible cambiar incluso el modelo utilizado entre ambas fases.
Por ejemplo:
- Utilizar un modelo rápido para analizar.
- Utilizar un modelo más potente para implementar.
Esto permite optimizar tanto costes como velocidad.
♿ Utilizar Plan para auditorías especializadas
Plan también resulta muy útil para tareas específicas de revisión.
Por ejemplo:
- Accesibilidad
- Rendimiento
- Seguridad
- Arquitectura
- Calidad del código
Puedes pedirle que identifique problemas y que formule las preguntas necesarias antes de proponer una solución completa.
Esto genera procesos de mejora mucho más controlados.
⚡ Trabajar en paralelo mientras la IA piensa
Otra característica interesante de OpenCode es que no necesitas quedarte esperando.
Mientras un agente está trabajando:
- Puedes abrir otra terminal.
- Ejecutar otra instancia de OpenCode.
- Seguir trabajando sobre el mismo proyecto.
Esto permite mantener la productividad incluso cuando una tarea requiere bastante análisis.
🔔 Notificaciones cuando termina una tarea
Cuando el agente finaliza su trabajo, OpenCode muestra una notificación.
Gracias a ello:
- No necesitas vigilar constantemente el proceso.
- Puedes continuar trabajando en otras tareas.
- Recibes un aviso cuando el análisis o implementación ha terminado.
La experiencia se parece mucho más a trabajar con compañeros de equipo que a ejecutar simples comandos de terminal.
📌 Ideas clave de esta clase
Quédate con estos conceptos:
- OpenCode dispone de varios tipos de agentes.
- Los dos agentes públicos principales son Build y Plan.
- Build puede modificar archivos y escribir en disco.
- Plan analiza el proyecto sin realizar cambios.
- Plan es ideal para auditorías y planificación.
- Puedes discutir y refinar los planes antes de implementarlos.
- Es posible combinar Plan para analizar y Build para ejecutar.
- Puedes cambiar de modelo entre análisis e implementación.
- OpenCode permite trabajar en paralelo mientras los agentes procesan tareas.
- Las notificaciones avisan cuando una tarea finaliza.
🚀 Lo siguiente: aprovechar agentes especializados
Ahora que conoces las diferencias entre Build y Plan, puedes empezar a utilizarlos de forma estratégica.
Utiliza Plan para entender y diseñar cambios con seguridad, y reserva Build para ejecutar únicamente aquellas modificaciones que realmente quieras aplicar.
💡 Tip: Antes de pedir cambios importantes en un proyecto, utiliza siempre Plan. Obtener primero una propuesta detallada suele producir mejores resultados y evita modificaciones inesperadas en tu código.