OpenCode Desktop
Descarga la aplicación desde opencode.ai/download y abre la carpeta del taller desde ahí.
Antes de empezar
Lo que necesitas
El taller está pensado para docentes y clínicos. La instalación debe ser simple, y los materiales finales deben poder abrirse sin depender de LaTeX, Pandoc u otras herramientas instaladas localmente.
API key temporal
Se entrega durante el taller. Es solo para la actividad, no debe compartirse ni reutilizarse fuera de la sesión.
Carpeta del taller
Incluye instrucciones, fuentes por tema, formatos de salida y entregables generados por el agente.
Entorno de trabajo
La carpeta organiza el pensamiento del agente
La estructura está separada por tema clínico. Cada tema tiene fuentes propias y una carpeta equivalente para sus entregables.
taller-ia/
Por qué esta estructura importa
El usuario no tiene que repetir cada regla en cada interacción. AGENTS.md contiene instrucciones persistentes, fuentes/ contiene el material revisable y formatos/ define la forma del entregable.
- El agente usa solo los archivos Markdown de la subcarpeta del tema solicitado.
- Los PDF pueden quedar como respaldo, pero no son la fuente operativa del ejercicio.
- Los entregables se guardan en la subcarpeta correspondiente dentro de entregables/.
- El resultado final se genera en HTML para que sea fácil de abrir, revisar e imprimir como PDF.
Instrucciones persistentes
AGENTS.md evita repetir reglas en el prompt
Este archivo define cómo debe trabajar el agente: qué fuentes puede usar, dónde guardar resultados, cuándo pedir revisión humana y qué formato producir.
Reglas principales
- Usar solo archivos Markdown en la subcarpeta de fuentes/ correspondiente al tema solicitado.
- No inventar fuentes ni datos; si falta información, declararlo.
- Presentar un plan antes de generar archivos.
- Guardar entregables en la subcarpeta correspondiente de entregables/.
- Incluir fuentes utilizadas y puntos que requieren revisión humana.
- Generar el entregable en formato HTML.
flujo del agente
Estructuras de salida
Los formatos hacen que el resultado sea consistente
En vez de pedir una estructura distinta cada vez, el taller ofrece archivos de formato que el agente debe leer antes de escribir el entregable.
Resumen de patología
Para una enfermedad o entidad clínica: definición, epidemiología, fisiopatología, presentación clínica, diagnóstico y tratamiento.
Resumen de bibliografía
Para sintetizar varios artículos científicos sobre un mismo tema, integrando coincidencias, diferencias y tendencias emergentes.
Prompt de ejemplo
El prompt debe ser corto porque el entorno ya trabaja
La idea del taller no es escribir un prompt gigante. La complejidad vive en AGENTS.md, en las fuentes organizadas y en los archivos de formatos/.
prompt para OpenCode
Necesito preparar un resumen de patología sobre pancreatitis aguda
para médicos generales y residentes de urgencias.Progresión didáctica
Las cuatro etapas del taller
La sesión usa una misma tarea para mostrar cómo cambia la calidad del trabajo cuando el contexto deja de estar solo en el prompt.
Chatbot básico
Prompt mínimo en ChatGPT.com. Es rápido, pero con poco contexto y baja trazabilidad.
Chatbot con contexto
Se agregan audiencia, propósito, tono y restricciones. Mejora, pero todo sigue siendo manual.
Archivos organizados
El contexto vive en carpetas: instrucciones, fuentes, formatos y entregables.
Agente local
OpenCode lee, planifica y genera archivos con trazabilidad dentro de un entorno preparado.
“
La diferencia no está en la herramienta. Está en pasar de pedir una respuesta a diseñar un entorno de trabajo para la IA.
Al terminar, podrás diferenciar modalidades de uso de IA y entender por qué el contexto, las instrucciones, los formatos y la trazabilidad importan tanto como el prompt.