Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

Las reglas son instrucciones persistentes que determinan cómo se comporta Devin CLI en tu proyecto. Se inyectan en el contexto del agente al inicio de cada sesión, lo que garantiza un comportamiento coherente en todo tu equipo. Los usos habituales de las reglas incluyen estándares de código, directrices de arquitectura, bibliotecas preferidas, convenciones de testing y restricciones específicas del proyecto. Para mejorar la capacidad de programación, acelerar la finalización y reducir el costo, recomendamos encarecidamente usar skills siempre que sea posible en lugar de reglas. Las skills solo se inyectan en el contexto cuando son relevantes. Las reglas y AGENTS deben mantenerse lo más pequeñas posible. El patrón que recomendamos es usar una regla para hacer referencia a skills que el modelo debe usar en situaciones concretas.

AGENTS.md

La forma más sencilla de agregar reglas es mediante un archivo AGENTS.md en la raíz de tu proyecto:
# Reglas del proyecto

- Usar TypeScript para todos los archivos nuevos
- Seguir los patterns existentes en src/components/
- Ejecutar siempre `npm run lint` antes de confirmar
- Usar pnpm, no npm ni yarn
- Escribir pruebas para todas las nuevas funciones utilitarias
La CLI de Devin lee este archivo automáticamente.
AGENTS.md es la opción recomendada para las reglas del proyecto. Es fácil de leer, tiene control de versiones y funciona con múltiples herramientas de IA.

Reglas globales

También puedes crear reglas que se apliquen a todos los proyectos colocando un archivo AGENTS.md en tu directorio de configuración de usuario:
~/.config/devin/AGENTS.md
Las reglas globales se cargan al inicio de cada sesión, sin importar en qué proyecto estés trabajando. Úsalas para definir preferencias personales que se apliquen en todas partes:
# My Global Rules

- Always write commit messages in conventional commit format
- Prefer functional patterns over imperative code
- Run tests before suggesting a task is complete
Las reglas globales funcionan junto con las reglas del proyecto; ambas se cargan y están activas al mismo tiempo. AGENT.md también se admite en esta ubicación.
Si usas Claude Code, Devin CLI también lee ~/.claude/CLAUDE.md como regla global.

Nombres de archivo compatibles

Devin CLI lee reglas de cualquiera de estos archivos:
ArchivoNotas
AGENTS.mdRecomendado
AGENT.mdAlternativa en singular
CLAUDE.mdCompatible con Claude Code
Todos se tratan por igual: su contenido se carga como reglas siempre activas. Estos archivos pueden existir en múltiples niveles de tu proyecto (no solo en la raíz). Los archivos en la raíz del workspace se cargan al inicio de la sesión. Los archivos en subdirectorios se detectan de forma diferida cuando el agente accede a archivos de ese directorio, lo que mantiene el contexto centrado en la parte relevante de la base de código. También pueden colocarse en el directorio de configuración global para que se apliquen a todos los proyectos, excepto CLAUDE.md, que se lee globalmente desde ~/.claude/CLAUDE.md.

Reglas de otras herramientas

Si vienes de otra herramienta de codificación con IA, Devin CLI puede leer tus reglas existentes:
Devin CLI lee las reglas de .cursorrules y .cursor/rules/*.md.Las reglas de Cursor admiten frontmatter para controlar la activación:
---
description: "React component guidelines"
globs: "src/components/**/*.tsx"
alwaysApply: false
---

Use functional components with hooks. Never use class components.
Comportamiento de activación:
  • alwaysApply: true — Siempre activa
  • globs especificado — Activa al trabajar con archivos que coinciden
  • Solo description — El agente decide cuándo aplicarla
  • Ninguno de los anteriores — El usuario debe invocarla manualmente
Devin CLI lee las reglas de .windsurf/rules/*.md y .windsurf/global_rules.md.Compatibilidad con subdirectorios: Los directorios .windsurf/rules/ pueden existir en múltiples niveles de tu proyecto, no solo en la raíz. Las reglas en la raíz del workspace se cargan al inicio de la sesión. Las reglas en subdirectorios se detectan de forma diferida: cuando el agente accede a archivos de ese directorio, cualquier .windsurf/rules/ que encuentre allí (y en los directorios superiores hasta la raíz del workspace) se carga automáticamente. Esto evita contaminar el contexto del agente con reglas de partes no relacionadas del proyecto.Las reglas de Windsurf admiten frontmatter:
---
description: "API design rules"
trigger: always_on
---

All API endpoints must return JSON with a consistent envelope format.
Valores de trigger: always_on, manual, model_decision, agent, glob
Devin CLI lee las reglas del directorio .claude/.
Devin CLI no admite archivos .codeiumignore. Si usas el autocompletado de Codeium y has configurado patrones de exclusión, esos patrones no se aplicarán a Devin CLI.

Control de importaciones

Puedes habilitar o deshabilitar la lectura de formatos de herramienta específicos en tu archivo de configuración (~/.config/devin/config.json — o %APPDATA%\devin\config.json en Windows — o .devin/config.json):
{
  "read_config_from": {
    "cursor": true,
    "windsurf": true,
    "claude": true
  }
}
AGENTS.md siempre se lee y no se puede desactivar.

Tipos de activación de reglas

Las reglas cargadas desde formatos externos pueden tener distintos comportamientos de activación:
TipoComportamiento
Siempre activasActivas en todas las sesiones, sin necesidad de ninguna acción por parte del usuario
Activadas por globActivas cuando el agente trabaja con archivos que coinciden con patrones específicos
Decididas por el agenteEl agente decide cuándo aplicarlas según la descripción de la regla
Invocables por el usuarioSolo se activan cuando el usuario las invoca explícitamente
Las reglas de AGENTS.md son siempre “siempre activas”.

Mejores prácticas

Mantén las reglas concisas

Las reglas largas y verbosas dispersan la atención del agente. Céntrate en lo más importante.

Sé específico

“Usa pnpm” es mejor que “usa el gestor de paquetes adecuado”. Las instrucciones concretas son más fáciles de seguir.

Incluye ejemplos

Muestra el patrón que quieres, no solo lo describas.

Contrólalas con versiones

Mantén las reglas en tu repo para que todo el equipo se beneficie de las mismas pautas.
Para la mayoría de los tipos de reglas más comunes, considera usar skills en su lugar. Las skills te dan más control sobre cuándo y cómo se aplican.