Rules

Establece instrucciones personalizadas para opencode.

Puedes proporcionar instrucciones personalizadas a opencode creando un archivo AGENTS.md. Esto es similar a las rules de Cursor. Contiene instrucciones que se incluirán en el contexto del LLM para personalizar su comportamiento para tu proyecto específico.

Inicializar

Para crear un nuevo archivo AGENTS.md, puedes ejecutar el comando /init en opencode.

Consejo: Deberías hacer commit del archivo AGENTS.md de tu proyecto a Git.

Esto escaneará tu proyecto y todo su contenido para entender de qué trata el proyecto y generará un archivo AGENTS.md con ello. Esto ayuda a opencode a navegar mejor por el proyecto.

Si ya tienes un archivo AGENTS.md existente, intentará añadir a él.

Ejemplo

También puedes simplemente crear este archivo manualmente. Aquí hay un ejemplo de algunas cosas que puedes poner en un archivo AGENTS.md.

Estamos añadiendo instrucciones específicas del proyecto aquí y esto se compartirá con tu equipo.

Tipos

opencode también soporta leer el archivo AGENTS.md desde múltiples ubicaciones. Y esto sirve para diferentes propósitos.

Proyecto

Coloca un AGENTS.md en la raíz de tu proyecto para reglas específicas del proyecto. Estas solo aplican cuando estás trabajando en este directorio o sus subdirectorios.

Global

También puedes tener reglas globales en un archivo ~/.config/opencode/AGENTS.md. Esto se aplica a todas las sesiones de opencode.

Como esto no se hace commit a Git ni se comparte con tu equipo, recomendamos usar esto para especificar cualquier regla personal que el LLM deba seguir.

Compatibilidad con Claude Code

Para usuarios que migran desde Claude Code, OpenCode soporta las convenciones de archivos de Claude Code como alternativas:

• Reglas de proyecto: CLAUDE.md en tu directorio de proyecto (usado si no existe AGENTS.md)
• Reglas globales: ~/.claude/CLAUDE.md (usado si no existe ~/.config/opencode/AGENTS.md)
• Skills: ~/.claude/skills/ — ver Agent Skills para detalles

Para deshabilitar la compatibilidad con Claude Code, establece una de estas variables de entorno:

Precedencia

Cuando opencode inicia, busca archivos de reglas en este orden:

• Archivos locales recorriendo hacia arriba desde el directorio actual (AGENTS.md, CLAUDE.md)
• Archivo global en ~/.config/opencode/AGENTS.md
• Archivo de Claude Code en ~/.claude/CLAUDE.md (a menos que esté deshabilitado)

El primer archivo coincidente gana en cada categoría. Por ejemplo, si tienes tanto AGENTS.md como CLAUDE.md, solo se usa AGENTS.md. De manera similar, ~/.config/opencode/AGENTS.md tiene precedencia sobre ~/.claude/CLAUDE.md.

Instrucciones personalizadas

Puedes especificar archivos de instrucciones personalizadas en tu opencode.json o en el global ~/.config/opencode/opencode.json. Esto te permite a ti y a tu equipo reutilizar reglas existentes en lugar de tener que duplicarlas en AGENTS.md.

Ejemplo:

También puedes usar URLs remotas para cargar instrucciones desde la web.

Las instrucciones remotas se obtienen con un timeout de 5 segundos.

Todos los archivos de instrucciones se combinan con tus archivos AGENTS.md.

Referenciar archivos externos

Mientras opencode no analiza automáticamente las referencias de archivos en AGENTS.md, puedes lograr funcionalidad similar de dos maneras:

Usando opencode.json

El enfoque recomendado es usar el campo instructions en opencode.json:

Instrucciones manuales en AGENTS.md

Puedes enseñar a opencode a leer archivos externos proporcionando instrucciones explícitas en tu AGENTS.md. Aquí hay un ejemplo práctico:

Este enfoque te permite:

• Crear archivos de reglas modulares y reutilizables
• Compartir reglas entre proyectos via symlinks o submódulos git
• Mantener AGENTS.md conciso mientras referencias directrices detalladas
• Asegurar que opencode carga archivos solo cuando es necesario para la tarea específica

Consejo: Para monorepos o proyectos con estándares compartidos, usar opencode.json con patrones glob (como packages/*/AGENTS.md) es más mantenible que las instrucciones manuales.