Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

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

CapaDóndeSe aplica a
Global~/.ingot/rules, ~/.ingot/AGENTS.mdtodos los proyectos de esta máquina
Raíz.ingot/rules, carpetas de reglas importadas, el AGENTS.md de la raíztodo el proyecto
Paquete<paquete>/.ingot/rules, <paquete>/AGENTS.mdlos archivos de ese paquete (una carpeta con package.json, pyproject.toml, go.mod, Cargo.toml o similar)
Carpeta<carpeta>/.ingot/rules, <carpeta>/AGENTS.mdlos archivos bajo esa carpeta

Dos reglas deciden qué gana:

  • Mismo nombre: gana la carpeta más profunda. packages/web/.ingot/rules/style.md sustituye a .ingot/rules/style.md de la raíz para los archivos de packages/web.
  • El AGENTS.md más cercano. El AGENTS.md de 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:

EstadoSignificado
appliedse carga para este archivo (siempre activa, coincidencia de glob o AGENTS.md más cercano)
on requestel agente la carga cuando su descripción encaja con la tarea
@-mention onlysolo se carga si la mencionas con @
no glob matchsus globs no coinciden con este archivo
overriddenuna regla con el mismo nombre en una carpeta más profunda la sustituye
shadoweduna 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