Reglas efectivas
En un monorepo, las reglas pueden estar en la raíz, en cada paquete y en cualquier carpeta por debajo. La vista Effective Rules muestra, para cualquier archivo, las reglas que realmente se le aplican, combinadas desde la raíz hacia su paquete y sus carpetas, con marcas donde una regla más profunda sustituye a otra de más arriba.
Cómo se apilan las reglas en un monorepo
| Capa | Dónde | Se aplica a |
|---|---|---|
| Global | ~/.ingot/rules, ~/.ingot/AGENTS.md | todos los proyectos de esta máquina |
| Raíz | .ingot/rules, carpetas de reglas importadas, el AGENTS.md de la raíz | todo el proyecto |
| Paquete | <paquete>/.ingot/rules, <paquete>/AGENTS.md | los archivos de ese paquete (una carpeta con package.json, pyproject.toml, go.mod, Cargo.toml o similar) |
| Carpeta | <carpeta>/.ingot/rules, <carpeta>/AGENTS.md | los archivos bajo esa carpeta |
Dos reglas deciden qué gana:
- Mismo nombre: gana la carpeta más profunda.
packages/web/.ingot/rules/style.mdsustituye a.ingot/rules/style.mdde la raíz para los archivos depackages/web. - El
AGENTS.mdmás cercano. ElAGENTS.mdde la raíz se carga siempre; de los anidados, solo se carga el más cercano por encima del archivo.
Dentro de una misma carpeta, las reglas .ingot ganan a las heredadas y a las importadas con el mismo nombre.
Abrir la vista
- Haz clic derecho en un archivo del árbol del proyecto o en el editor › Show Effective Rules.
- Find Action (⌘⇧A / Ctrl+Shift+A) › Show Effective Rules for File, o pulsa ⌘⌥⇧E (Ctrl+Alt+Shift+E) para el editor activo.
Escribe o elige otra ruta en el campo File para comparar archivos; el botón de diana vuelve al editor activo.
Cómo leer la vista
Las etiquetas de capa de arriba muestran el camino de la combinación, por ejemplo Root › Package packages/web/ › Folder packages/web/src/components/. Debajo, cada regla aparece en su capa con un estado:
| Estado | Significado |
|---|---|
| applied | se carga para este archivo (siempre activa, coincidencia de glob o AGENTS.md más cercano) |
| on request | el agente la carga cuando su descripción encaja con la tarea |
| @-mention only | solo se carga si la mencionas con @ |
| no glob match | sus globs no coinciden con este archivo |
| overridden | una regla con el mismo nombre en una carpeta más profunda la sustituye |
| shadowed | una regla con el mismo nombre en una carpeta con más prioridad (.ingot sobre .cursor) la sustituye |
Las marcas de sustitución unen ambos lados: ↓ overridden by packages/web/style en la regla sustituida y ↑ overrides style en la que la sustituye. Cuando una regla más profunda contradice una sola línea de una regla de más arriba (exportaciones con nombre o por defecto, tabulaciones o espacios), la línea de arriba aparece tachada y la que la sustituye se muestra con su archivo y número de línea. Las contradicciones dentro de la misma capa se marcan con ⚠: son conflictos reales que Rules Doctor también informa.
Abre Merged instructions para leer el texto final que recibe el agente para este archivo, en orden de carga. El recuento de tokens de arriba es el coste de todo lo que se aplica.
Desde la terminal
ingot effective packages/web/src/components/Button.tsx # capas, estados y marcas
ingot effective packages/web/src/components/Button.tsx --merged # más las instrucciones combinadas
ingot effective packages/web/src/components/Button.tsx --json
Relacionado
- Reglas y /init y AGENTS.md
- Reglas aplicadas y procedencia: qué cargó un turno real del agente
- Rules Doctor: sustituciones y conflictos en todo el proyecto