Esquemas de .ingot y vista previa de globs
Cada archivo de .ingot/ tiene un esquema JSON, así que el editor autocompleta claves y valores, los explica al pasar el ratón y marca los errores mientras escribes. Los globs de las reglas muestran, junto al patrón, cuántos archivos del proyecto coinciden, con una lista en vivo de las coincidencias.
Archivos con esquema
| Archivo | Esquema |
|---|---|
.ingot/rules/*.md / *.mdc (frontmatter) | Regla: description, globs, alwaysApply, pack |
.ingot/commands/*.md (frontmatter) | Comando |
.ingot/skills/<nombre>/SKILL.md (frontmatter) | Skill |
.ingot/agents/*.md (frontmatter) | Subagente |
.ingot/habits/*.md (frontmatter) | Hábito |
.ingot/mcp.json | Servidores MCP |
.ingot/hooks.json | Hooks |
.ingot/environment.json | Entorno del proyecto |
.ingot/worktrees.json | Preparación de worktrees |
.ingot/policy.json | Política del agente |
.ingot/frozen.json | Zonas congeladas |
.ingot/doctor.json | Ajustes de Rules Doctor |
El esquema de reglas también cubre las carpetas de reglas importadas (.cursor/rules, .alloy/rules) y el de MCP cubre .cursor/mcp.json. Las carpetas .ingot/ anidadas en los paquetes de un monorepo usan los mismos esquemas.
Autocompletado y ayuda al pasar el ratón
- En un archivo de regla, comando, skill o hábito vacío, pulsa Ctrl+Space para insertar una plantilla de frontmatter.
- Dentro del frontmatter o del JSON, Ctrl+Space lista las claves que faltan y los valores permitidos (
true/false, valores de una enumeración). - En
globs, el autocompletado propone patrones construidos a partir de las carpetas y tipos de archivo del proyecto, como**/*.tsxopackages/web/**. - Pasa el ratón sobre una clave para leer qué hace.
Validación en vivo
Los errores aparecen subrayados y en la vista Problems con el origen Ingot schema mientras escribes, antes de guardar:
- claves desconocidas, con la clave válida más parecida sugerida (
Unknown key "comand". Did you mean "command"?) - valores obligatorios que faltan (un servidor MCP necesita
commandourl) - tipos incorrectos y valores fuera de una enumeración
- errores de sintaxis en globs (un
{o[sin cerrar)
Vista previa de globs
En el frontmatter de una regla, cada glob lleva una indicación con el número de archivos que coinciden: 2 files, o no files si el glob está muerto. La primera línea de una regla muestra su coste en tokens y si se carga en cada turno.
- Pasa el ratón sobre un glob para ver los primeros archivos que coinciden.
- Haz clic dentro de un glob y pulsa ⌘⌥⇧G (Ctrl+Alt+Shift+G) para ver todas las coincidencias; elige una para abrirla.
- Find Action › Preview Glob Matches pide cualquier patrón y lista lo que coincide, para probar un glob antes de escribirlo.
Las coincidencias respetan .gitignore, y un glob de una carpeta .ingot/rules anidada se evalúa desde esa carpeta.
Otros editores y CI
La CLI ingot lista, escribe y comprueba los mismos esquemas:
ingot schemas # lista cada esquema y los archivos que cubre
ingot schemas --write # los escribe en .ingot/schemas para otros editores
ingot schemas --write --out schemas # o en otra carpeta
ingot schemas .ingot/mcp.json .ingot/rules/react.md # valida archivos; termina con 1 si hay errores
Archivos de ejecución en .ingot/
No todo en .ingot/ es configuración. Mientras trabaja, Ingot también escribe allí archivos de ejecución: artefactos de agentes, el índice del código, el historial local, cachés, registros y hábitos aprendidos en esta máquina. No tienen esquema y no deben ir a git. La estructura del proyecto los mantiene fuera de git status con un bloque gestionado en .ingot/.gitignore cuando el proyecto confirma configuración de .ingot, o si no en el .git/info/exclude local, así que no aparece ningún archivo nuevo.
Relacionado
- Reglas, Hooks, Servidores MCP, Entorno del proyecto
- Estructura del proyecto: los archivos de ejecución fuera de git y la estructura de pruebas que siguen los agentes
- Rules Doctor: comprobaciones de todo el proyecto, incluidos los globs muertos