Ag
Guías

¿Qué es una regla?

Instrucciones que el agente carga casi siempre: convenciones del stack, estilo y qué evitar. Dónde van y un ejemplo.

~3 min lectura Revisado el 10 de julio de 2026
Cursor Windsurf VS Code GitHub Copilot Antigravity Claude Code Principiante

En una línea

Una regla es texto que el agente lee en (casi) cada conversación: convenciones del proyecto, stack, estilo de código y cosas que no debe hacer. A diferencia de un skill, no espera a que la tarea encaje — está siempre ahí.

Comparación con skills y MCP: Skills vs reglas vs MCP.

Para qué sirven

  • Que el agente use Vitest y no Jest, App Router y no Pages, TypeScript estricto, etc.
  • Alinear respuestas con cómo escribe tu equipo, no con un stack genérico de internet.
  • Evitar repetir lo mismo en cada chat (“no uses any”, “tests antes de commit”).

Qué no son

  • No son AGENTS.md — ese archivo suele ser contexto del repo (build, tests, estructura). Reglas = convenciones de código/comportamiento. Muchos proyectos usan ambos.
  • No son un skill — el skill se activa solo para tareas concretas.
  • No son verdad absoluta copiada de internet — hay que adaptarlas a tu repo.

Dónde van (según plataforma)

PlataformaUbicación habitual
Cursor.cursor/rules/*.mdc o .md
Windsurf.windsurf/rules/ (legacy .windsurfrules)
VS Code / Copilot.github/copilot-instructions.md
Claude CodeCLAUDE.md o reglas en settings (según setup)
Antigravityreglas de workspace (similar a Cursor/Windsurf)

Detalle por plataforma en Plataformas.

Ejemplo mínimo (Cursor)

---
description: Convenciones TypeScript del proyecto
globs: **/*.{ts,tsx}
---
- Usar App Router de Next.js
- Tests con Vitest
- No usar `any`
- Componentes en PascalCase

En Copilot, el mismo espíritu va en .github/copilot-instructions.md en prosa, sin frontmatter globs.

Cuántas reglas

Pocas y específicas. Diez reglas largas y genéricas suelen peor que tres líneas claras. Si copias de Cursor Directory u otra lista, lee, recorta y adapta.

Cuándo crear reglas

  • Ya tienes AGENTS.md o equivalente y quieres fijar convenciones de código.
  • El agente repite el mismo error (imports, framework, linter).

Cuándo no

  • Primer día con IA → contexto del repo primero, empezar aquí.
  • Tarea puntual con pasos fijos → mejor un skill.
  • Integración externa (browser, DB) → MCP.

Catálogo en Agentoteca

En /rules/ hay referencias oficiales y directorios (no una lista infinita):