Exportar reglas a otras herramientas
Mantén un solo conjunto de reglas en .ingot/rules y expórtalo a los archivos que leen otras herramientas de IA para programar: AGENTS.md, CLAUDE.md, .cursor/rules, .windsurf/rules y las instrucciones de GitHub Copilot. Quien use otra herramienta recibe las mismas reglas, y el CI puede fallar cuando las copias se desvían.
Exportar desde el IDE
Abre la página Rules & MCP (franja derecha), elige la pestaña Rules y pulsa Export. También puedes ejecutar Export Rules to Other Tools… desde Find Action.
El diálogo muestra cada archivo que escribiría la exportación, antes de cambiar nada:
- New, Update y Delete con las líneas añadidas y quitadas.
- Up to date cuando un archivo ya coincide.
- Skipped para un archivo de regla escrito a mano; Ingot nunca lo sobrescribe salvo que marques Overwrite hand-written files.
Desmarca un destino para no tocar sus archivos y pulsa Export.
Qué se escribe
| Destino | Archivos |
|---|---|
AGENTS.md | un bloque gestionado con todas las reglas exportadas |
CLAUDE.md | el mismo bloque gestionado |
.cursor/rules | un <regla>.mdc por regla, con alwaysApply, globs y description |
.windsurf/rules | un <regla>.md por regla, con el trigger correspondiente (siempre activa, glob, decisión del modelo o manual) |
| GitHub Copilot | .github/copilot-instructions.md (bloque gestionado) y .github/instructions/<regla>.instructions.md con applyTo para las reglas con globs |
El bloque gestionado va entre los comentarios <!-- ingot:export:begin --> y <!-- ingot:export:end -->. Tu propio texto por encima y por debajo queda igual. Ingot lee AGENTS.md y CLAUDE.md sin ese bloque, así que las reglas exportadas nunca llegan dos veces al agente.
Los archivos de regla generados empiezan con un comentario generated by ingot export. Cuando borras o renombras una regla en .ingot/rules, la siguiente exportación borra sus archivos generados, y solo esos.
Mantener una regla privada
Añade export: false al frontmatter de una regla para dejarla fuera de todos los archivos exportados:
---
description: Nuestra lista de comprobación de releases
export: false
---
Solo la necesitan los agentes de Ingot.
Para exportar solo a algunos destinos, enuméralos en .ingot/export.json, por ejemplo { "targets": ["agents", "claude", "copilot"] }. Ejecuta ingot export --help para ver todos los identificadores.
Desde la terminal
npx @ingotide/cli export # escribe todos los destinos
npx @ingotide/cli export --dry-run # muestra qué cambiaría
npx @ingotide/cli export --check # sale con 1 si un archivo no está al día (CI)
| Opción | Significado |
|---|---|
--targets <lista> | lista de destinos separada por comas (por defecto: .ingot/export.json, si no, todos) |
--check | no escribe nada; sale con 1 si un archivo exportado difiere de .ingot/rules |
--dry-run | imprime el plan sin escribir |
--force | sobrescribe también los archivos de regla escritos a mano |
--json | el plan en JSON |
--init-ci | añade .github/workflows/ingot-rules.yml |
Detectar desvíos en CI
ingot export --init-ci escribe un flujo de GitHub Actions que se ejecuta en los pull requests que tocan reglas. Ejecuta export --check, así que un pull request falla cuando alguien edita .ingot/rules sin exportar, o edita a mano un archivo exportado. También ejecuta las pruebas de reglas con el modelo simulado gratuito.