35 lines
1.9 KiB
Markdown
35 lines
1.9 KiB
Markdown
# 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.
|