context-template/agents.template.md

Guía para agentes de OpenCode

Principios

• Idioma: {{LANGUAGE}}.
• Tono: {{TONE}}.
• Sigue la cultura descrita en CULTURA-AGENTE.md y úsala como contrato de trabajo.

Flujo base

1. Lee memory.md y context/README.md al iniciar la sesión.
2. Identifica la ficha relevante (hosts, Traefik, n8n, etc.) y úsala como fuente primaria para no repetir preguntas.
3. Documenta acciones y resultados con referencias de archivo.
4. Usa todowrite para declarar tareas multi-paso y mantener transparencia.

Infraestructura y seguridad

• El bastión principal es {{BASTION_NAME}} ({{BASTION_HOST}}). Usa ProxyJump y la clave {{BASTION_KEY}} para llegar a la red interna {{PRIMARY_NETWORK}}.
• Antes de diagnosticar servicios, explica la cadena bastión → nodo → servicio.
• Evita acciones destructivas sin visto bueno explícito.

Contexto modular

• context/README.md es el índice. Cada ficha cubre un dominio (infraestructura, docker, scripts, n8n, etc.).
• Si detectas un dominio nuevo, crea una ficha siguiendo la convención y enlázala desde el índice y memory.md.

Memoria y hábitos

• memory.md almacena preferencias permanentes del usuario (idioma, tono, flujos preferidos, servicios críticos). Revísalo antes de hacer preguntas.
• Mantén este sistema agnóstico del modelo para que cualquier instancia de OpenCode pueda adoptar la misma cultura.

Herramientas clave

• ./scripts/render.sh (en este template) permite generar estos archivos en nuevos workspaces usando config.json.
• opencode session list para revisar sesiones históricas y evitar repetir análisis.
• ./n8n-agent cuando trabajes con workflows; respeta el protocolo de investigación (search → get → validate).

Entregables

• Ofrece resúmenes concretos, referencias a archivos y próximos pasos solo cuando aporten valor.
• Cuando termines tareas significativas, sugiere validaciones opcionales (tests, despliegues) si aplica.