Curación de Contexto y Higiene de Reglas
Práctica de ingeniería para diseñar, auditar y limpiar regularmente archivos de configuración de comportamiento del agente (.cursorrules, .clinerules, AGENTS.md) para prevenir la degradación de la atención del modelo.
1. Visión general del concepto y problema sistémico
Los desarrolladores a menudo tratan archivos como .cursorrules o .clinerules como basureros:
- ¿Apareció un bug? Se añadió una regla: "Nunca uses la biblioteca X".
- Una semana después, otro desarrollador añadió: "Usa la biblioteca X para operaciones rápidas".
- En tres meses, el archivo se convierte en un rollo ilegible con 80 instrucciones contradictorias.
- El modelo en cada solicitud se ve obligado a leer este caos, gastando tokens y perdiendo calidad de generación.
Curación de Contexto es una disciplina de minimalismo y limpieza arquitectónica: las reglas del sistema deben ser modulares, jerárquicas, relevantes y concisas.
2. Taxonomía arquitectónica y modelo mental
┌─────────────────────────────────────────────────────────────┐
│ HIERARQUÍA MODULAR DE CONTEXTO │
├─────────────────────────────────────────────────────────────┤
│ 1. REGLAS RAÍZ (.cursorrules / AGENTS.md) [Máx 150 líneas] │
│ • Stack central y límites estrictos (Next.js 15, Drizzle) │
│ • Lista de prohibiciones (Sin ningún, sin ts-ignore, sin deps no verificados) │
│ • Comando de verificación: `pnpm check && pnpm test` │
├─────────────────────────────────────────────────────────────┤
│ │ │
│ ▼ Carga dinámica bajo demanda │
├─────────────────────────────────────────────────────────────┤
│ 2. HABILIDADES DE DOMINIO Y ESPECIFICACIONES DE SUBSISTEMAS (.agents/skills/) │
│ • `skills/better-auth/` ➔ cargado SOLO durante tareas de autenticación │
│ • `skills/seo-audit/` ➔ cargado SOLO para páginas de marketing │
│ • `skills/db-migrations/` ➔ cargado SOLO para ediciones de esquema │
└─────────────────────────────────────────────────────────────┘
3. Pipeline técnico y mecánica interna
01. Regla de "Negación Absoluta" (Negative Constraints)
En lugar de largas descripciones sobre cómo escribir código, las reglas de calidad definen claramente las acciones prohibidas:
## Invariantes Estrictos
- NUNCA ejecutes `npm run build` localmente durante el desarrollo; usa `tsc --noEmit`.
- NUNCA uses estilos CSS en línea; usa tokens de diseño de Tailwind.
- NUNCA inventes IDs de usuario simulados; consulta los fixtures de la base de datos.
02. Uso de referencias relativas en lugar de copiar y pegar código
En lugar de copiar todo el archivo de tipos en .cursorrules, indica referencias:
Antes de modificar entidades de base de datos, lee las definiciones de esquema en [schema.ts](file:///src/db/schema.ts).
Los entornos de agentes modernos cargarán automáticamente el contenido del archivo según sea necesario.
4. Escenarios prácticos de ingeniería en producción
01. Regla de "Negación Absoluta" (Negative Constraints)
02. Uso de referencias relativas en lugar de copiar y pegar código
03. Auditoría mensual de reglas
5. Errores comunes, trampas y seguridad
- Intentar enseñar a la modelo a través de reglas: No escribas en las reglas lecciones sobre qué es la asincronía en JavaScript o cómo funcionan las promesas. El modelo ya lo sabe. Las reglas son necesarias únicamente para la especificidad de tu repositorio.
- Pérdida de relevancia: Si el proyecto ha cambiado de Tailwind v3 a Tailwind v4, las reglas antiguas con utilidades obsoletas generarán errores de sintaxis. Realiza una auditoría mensual de las reglas.
FAQ: Curación de Contexto y Higiene de Reglas
Términos relacionados
Reglas de Agente (.cursorrules / CLAUDE.md / AGENTS.md)
Archivos legibles por máquina de regulaciones arquitectónicas y restricciones en el repositorio, que se montan automáticamente en el contexto del sistema de los agentes de IA para prevenir la degradación de la base de código.
Degradación del Contexto (Context Rot & Attention Decay)
Disminución sistemática de la precisión, cumplimiento de instrucciones y coherencia lógica de los LLM a medida que se acumula ruido de diálogo, borradores de código obsoletos y salidas del compilador en la ventana de contexto.
Instrucciones del Sistema (System Instructions & Metaprompting)
Bloque de instrucciones metacontextuales prioritarias que se transmite en la posición cero de la ventana de contexto y define el rol, las reglas de seguridad, las herramientas disponibles y los límites de comportamiento del agente.
Spec-First Engineering (Desarrollo de IA Basado en RFC)
Metodología de desarrollo mediante IA, donde el 80% del esfuerzo del desarrollador se destina a crear una especificación técnica clara (PRD/RFC) antes de generar la primera línea de código.