Rules Doctor
Rules Doctor revisa cada regla, cada AGENTS.md y cada archivo de configuración .ingot del proyecto en busca de conflictos, globs muertos, duplicados, reglas demasiado grandes y errores de esquema, y muestra cuántos tokens cuesta cada regla frente a tu presupuesto de reglas siempre activas. Úsalo en el IDE, donde los hallazgos aparecen en la vista Problems, o desde la terminal con ingot doctor.
Usarlo en el IDE
Rules Doctor se ejecuta solo al abrir un proyecto y de nuevo cada vez que cambia una regla, un AGENTS.md o un archivo .ingot, o cuando se añaden o eliminan archivos. Para ejecutarlo a mano:
- Find Action (⌘⇧A / Ctrl+Shift+A) › Run Rules Doctor
- o pulsa ⌘⌥⇧D (Ctrl+Alt+Shift+D)
Los hallazgos aparecen en la vista Problems con el origen Rules Doctor (los errores de esquema con el origen Ingot schema), y una notificación los resume, por ejemplo Rules Doctor: 1 error, 4 warnings, 2 info · 11 rule files · always-on 40 / 4k tokens. Haz doble clic en un hallazgo para abrir la regla en la línea o el glob afectado.
Qué revisa
| Hallazgo | Gravedad | Qué significa |
|---|---|---|
| Conflict | aviso | Dos reglas que se cargan juntas piden cosas opuestas: tabulaciones y espacios, comillas simples y dobles, exportaciones con nombre y por defecto, npm y pnpm, y similares |
| Override | info | Una regla en una carpeta más profunda contradice una regla de la raíz para los archivos de esa carpeta (normal en monorepos; se lista para que lo veas) |
| Dead glob | aviso | Un patrón de globs no coincide con ningún archivo del proyecto, así que esa parte de la regla nunca se carga |
| Duplicate | aviso | Una regla repite otra palabra por palabra |
| Duplicate line | info | Una frase aparece en más de una regla |
| Shadowed | aviso | Una regla nunca se carga porque gana otra con el mismo nombre (por ejemplo .ingot/rules/style.md sobre .cursor/rules/style.mdc) |
| Oversized | aviso | Una regla supera el límite por regla (1.500 tokens por defecto) |
| Over budget | aviso | Las reglas que se cargan en cada turno para una carpeta superan el presupuesto siempre activo (4.000 tokens por defecto) |
| Empty | aviso | Una regla no tiene instrucciones |
| Manual only | info | Una regla tiene alwaysApply: false y ni globs ni descripción, así que solo se carga si la mencionas con @ |
| Schema | error o aviso | Un archivo .ingot no cumple su esquema: una clave desconocida (con la clave válida más parecida sugerida), un valor obligatorio que falta, un tipo incorrecto |
Coste en tokens y presupuesto siempre activo
Cada regla recibe una estimación de tokens (unos 4 caracteres por token, la misma estimación que usa el medidor de uso del agente). Las reglas que se cargan en cada turno —las de alwaysApply: true y los archivos AGENTS.md— cuentan para el presupuesto siempre activo de cada carpeta, de modo que un paquete de un monorepo con reglas propias tiene su propia línea. Las reglas con globs, con descripción o manuales solo cuestan tokens en los turnos en que se cargan.
Configurarlo
Pon los valores por defecto del proyecto en .ingot/doctor.json (el archivo tiene esquema, así que tienes autocompletado y validación al editarlo):
{
"budget": 6000,
"maxRuleTokens": 2000,
"ignore": ["duplicate-line", "manual-only"]
}
ignore acepta códigos de hallazgo: conflict, override, dead-glob, duplicate, duplicate-line, shadowed, oversized, budget, empty, manual-only, schema.
Usarlo desde la terminal
La CLI ingot hace las mismas comprobaciones, así que puedes validar cambios de reglas en CI:
ingot doctor # informe legible; termina con 1 si hay errores
ingot doctor --strict # también termina con 1 si hay avisos
ingot doctor --json # el informe completo en JSON
ingot doctor --budget 6000 --max-rule-tokens 2000 --ignore duplicate-line,manual-only
ingot doctor --no-global # sin tus reglas personales de ~/.ingot
Las opciones tienen prioridad sobre .ingot/doctor.json. Tus reglas globales de ~/.ingot se incluyen por defecto, porque se cargan en todos los proyectos; usa --no-global en CI.
Relacionado
- Reglas y /init y AGENTS.md: cómo se cargan las reglas
- Reglas aplicadas y procedencia: qué reglas cargó realmente un turno
- Reglas efectivas: las reglas combinadas de un archivo en un monorepo
- Esquemas de .ingot y vista previa de globs: autocompletado y validación en vivo mientras editas