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

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

ArchivoEsquema
.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.jsonServidores MCP
.ingot/hooks.jsonHooks
.ingot/environment.jsonEntorno del proyecto
.ingot/worktrees.jsonPreparación de worktrees
.ingot/policy.jsonPolítica del agente
.ingot/frozen.jsonZonas congeladas
.ingot/doctor.jsonAjustes 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 **/*.tsx o packages/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 command o url)
  • 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