Hábitos
Los hábitos son una carpeta, .ingot/habits/, con un archivo Markdown por tipo de arreglo: bug.md, defect.md, design.md, performance.md, tests.md, security.md, refactor.md, general.md y cualquier tipo que añadas. Cada archivo guarda conocimiento duradero para las próximas ejecuciones: decisiones, patrones y "haz siempre X cuando Y", una viñeta por entrada. El agente lee los archivos que encajan con la tarea y añade lo que aprende al que corresponde. Haz commit de la carpeta y los agentes de todo tu equipo aprenden juntos.
Beta Habits es una función opcional y está desactivada hasta que la actives. Mientras está desactivada, el agente no lee ni escribe la carpeta; los archivos se quedan donde están. Las reglas dicen cómo escribir código; los hábitos son lo que el agente aprendió sobre trabajar en este proyecto.


Activarlo
Habits se encuentra de tres formas, como toda función opcional:
- Una sugerencia en el chat. Cuando tu prompt dice algo duradero ("From now on, always add a regression test when fixing a crash"), describe una rutina ("every time we release: bump the version, update the changelog, then tag the commit") o el proyecto ya tiene hábitos del equipo mientras Habits está desactivado, una pequeña tarjeta sobre el cuadro de chat ofrece Enable Habits. × la oculta para siempre.
- Settings › Features › Habits. Un interruptor. El mismo interruptor es Use habits arriba en la página Habits.
- El botón Habits de la barra de estado. Un clic activa Habits y abre la página Habits; se ve atenuado mientras Habits está desactivado. El atajo es
⌥⇧⌘`en macOS yCtrl+Alt+Shift+`en Windows y Linux, y Habits: Turn On and Open y Habits: Turn On or Off están en Find Action.
Al activar Habits se crea .ingot/habits/ con los archivos de tipo por defecto que falten. Nunca sobrescribe un archivo y, mientras Habits siga activado, un archivo de tipo que borres se queda borrado.






Los archivos de tipo
| Archivo | Qué va en él |
|---|---|
bug.md | Arreglos de bugs: algo falla, lanza una excepción o da un resultado erróneo |
defect.md | Defectos frente a la especificación: funciona, pero no como dicen el ticket o los criterios de aceptación |
design.md | UI y UX: diseño, estilos, temas, iconos, accesibilidad |
performance.md | Velocidad y recursos: latencia, memoria, renderizado, caché, tamaño del bundle |
tests.md | Tests unitarios y end-to-end: qué cubrir, cómo escribirlos, tests inestables |
security.md | Secretos, autenticación y entradas: nunca filtrar, validar siempre |
refactor.md | Reestructurar sin cambiar el comportamiento: nombres, extracción, duplicación, código muerto |
general.md | Todo lo demás que merece la pena guardar: convenciones del proyecto, flujo de trabajo, decisiones |
Un archivo de tipo es Markdown normal. El frontmatter dice de qué trata el tipo; las keywords deciden con qué tareas encaja. Cada viñeta - del cuerpo es una entrada.
---
description: Bug fixes: something crashes, throws or gives the wrong result.
keywords: [bug, crash, broken, error, exception, regression, stack trace, throw, null, undefined, fail]
---
# Bug
Lasting knowledge for future runs. One bullet per entry.
- Always add a regression test before fixing a crash
- Reproduce it in a failing test first
Tus propios tipos funcionan igual: i18n.md con keywords: [locale, translation] se lee en tareas de traducción.
Cómo los lee el agente
En cada petición, Ingot puntúa cada archivo de tipo con entradas frente a tu prompt: el nombre del tipo cuenta 2 puntos y cada una de sus keywords 1. El agente recibe las entradas de los 3 mejores tipos (como mucho las últimas 30 de cada uno) y de general.md, que siempre lee. También recibe la lista de todos los archivos de tipo con su número de entradas, para abrir otro si la tarea resulta tocarlo.
Para "Another crash on the cart page" el agente lee bug.md; para "Make the header spacing tighter" lee design.md, y el conocimiento sobre fallos queda fuera del prompt.
Cómo escribe en ellos el agente
Cuando el agente aprende algo que merece la pena guardar, añade una línea a su respuesta:
HABIT: [bug] Always add a regression test before fixing a crash
HABIT: Never log access tokens in the payment client
Ingot quita esas líneas de la respuesta y añade cada una a su archivo de tipo. Un tipo con nombre va a ese archivo (un nombre nuevo crea un archivo nuevo); sin tipo, Ingot clasifica la entrada con la misma puntuación, así que la segunda línea acaba en security.md. Una entrada que ya está en el archivo no se añade dos veces, y las líneas dentro de bloques de código no se tocan.
Cada guardado muestra una nota plateada Saved to Habits en el chat con el archivo y la entrada. Haz clic en la nota para ver el archivo en la página Habits, Open lo abre en una pestaña del editor y Undo quita la entrada del archivo.
Para que el agente lea los archivos pero nunca los escriba, desactiva Agent adds what it learns to the type files en la página Habits (ingot.habits.knowledge.autoSave).
Editar los archivos en la página Habits
Settings › Tools › Habits muestra la carpeta en Knowledge by type: cada archivo con su descripción y su número de entradas. Haz clic en un archivo para editarlo ahí mismo; el contador se actualiza mientras escribes. El icono de flecha lo abre en una pestaña del editor. Escape o Cancel cierra el editor sin guardar.


+ Add type crea un archivo de tipo nuevo. Usa letras, números y guiones; Bugs se rechaza si ya existe bug.md.


Guardar conocimiento desde tu prompt
Cuando tu prompt dice algo duradero mientras Habits está desactivado, la sugerencia nombra el archivo al que pertenece: Keep this in .ingot/habits/bug.md so the agent follows it in every future run. Enable Habits activa Habits, guarda la frase (sin "From now on" ni "please") en ese archivo y lo abre en la página Habits.


Playbooks de escenario
La misma carpeta puede guardar también playbooks: archivos con frontmatter when y steps para un escenario como un bug de pagos o una release. Cuando aparezca este tipo de tarea, sigue estos pasos, usa estas herramientas y no pares hasta que pasen estas comprobaciones. La página Habits los muestra en Scenario playbooks, debajo de los archivos de tipo.


Cuando la sugerencia viene de una rutina de tu prompt, Enable Habits abre un playbook redactado a partir de ella: el escenario se convierte en when y en el nombre, y cada paso ("…, then …", una lista numerada o lo que va tras dos puntos) en un paso. Edítalo, elige This project o Global y pulsa Add habit.




Un archivo de playbook
---
name: Payments bug
when: A bug report or failing test in the payments service
keywords: [payment, checkout, refund, invoice]
globs: ["services/payments/**"]
errorRegex: "PaymentError|CardDeclined"
steps:
- Reproduce the problem with a failing test in services/payments/test
- Search the service logs and recent commits for the error
- Fix the cause, not the symptom
- Run the payments test suite
allowedTools: [read_file, grep, glob, edit_file, ingot/run]
doneCriteria:
- The new test fails before the fix and passes after it
- npm test -w services/payments passes
---
Payments code handles money: never change rounding or currency logic without a test.
| Campo | Significado |
|---|---|
name | se muestra en el chat (hasta 64 caracteres) |
when | el escenario, en palabras sencillas; el agente lo lee para decidir si el playbook encaja |
keywords | palabras de tu prompt que apuntan a este playbook |
globs | archivos en contexto que apuntan a este playbook |
errorRegex | un patrón de error que buscar en tu prompt, adjuntos, diagnósticos y salida del terminal |
steps | la lista ordenada que sigue el agente (hasta 20) |
allowedTools | herramientas que el agente puede usar mientras el playbook está activo, como read_file, ingot/run o github/*; omítelo para permitirlas todas |
doneCriteria | comprobaciones que el agente confirma antes de terminar |
El texto tras el frontmatter se envía junto con los pasos como notas adicionales. Un archivo con when o steps es siempre un playbook, nunca un archivo de tipo.
Dónde viven los playbooks
| Carpeta | Alcance |
|---|---|
.ingot/habits/*.md | este proyecto; se comparte con Git |
~/.ingot/habits/*.md | todos los proyectos de esta máquina |
.cursor/habits/*.md | se lee por compatibilidad |
Si coinciden los nombres, gana el proyecto sobre .cursor/habits, que gana sobre la carpeta global. Desactivar un playbook del equipo para ti es un ajuste personal; no cambia el archivo del repositorio. Los archivos de tipo solo se leen de .ingot/habits/ del proyecto.
Los hábitos funcionan con cualquier estructura de proyecto. Si abres una subcarpeta de un repositorio, también se siguen los playbooks de .ingot/habits de las carpetas superiores, hasta la raíz del repositorio; los de la carpeta abierta ganan si el nombre coincide y los hábitos nuevos se guardan allí. Si un hábito parece ignorado, Help › Ingot Health… › Project setup indica si Habits está desactivado (con el botón Turn on Habits) o si un archivo de hábito no se cargó.
Selección automática
En cada petición nueva, Ingot puntúa cada playbook frente a lo que estás haciendo:
| Señal | Puntos |
|---|---|
errorRegex coincide con un error del prompt, adjuntos, diagnósticos o terminal | 3 |
una palabra de keywords aparece en el prompt | 2 |
un archivo en contexto coincide con globs | 1 |
Se elige el mejor playbook con al menos 2 puntos, así que un archivo coincidente por sí solo nunca elige uno. El agente también puede cambiar de playbook si la tarea resulta ser otra cosa, y tú puedes elegir o desactivar uno.
La píldora "Using habit"
Con un playbook activo, una píldora sobre el compositor muestra Using habit: Payments bug y por qué se eligió (por ejemplo keyword "refund"). Ábrela para ver la lista en vivo: el agente marca los pasos según avanza y, antes de terminar, revisa los criterios de finalización y se le recuerda una vez si queda alguno. Elige Habit off para dejar de seguirlo en este chat.
Guardar una ejecución como hábito
Cuando el agente resuelve algo que volverás a ver, elige Save as habit en la ejecución terminada. Ingot redacta un playbook a partir de lo que pasó:
- steps de las llamadas a herramientas de la ejecución (hasta 10; las lecturas seguidas se agrupan en un paso)
- keywords y globs de tu prompt y de los archivos que editó
- doneCriteria de las comprobaciones que ejecutó, como tests, lint o build
Revisa el borrador, edítalo y guárdalo en el proyecto o en tus hábitos globales.
Ajustes
| Ajuste | Por defecto | Qué hace |
|---|---|---|
ingot.habits.playbooks.enabled | false | Habits (Settings › Features, y Use habits en la página Habits): el agente lee los archivos de tipo que encajan con la tarea y sigue los playbooks que coinciden. Desactivado, los archivos se quedan pero el agente los ignora y Save as habit se oculta |
ingot.habits.knowledge.autoSave | true | Agent adds what it learns to the type files: las líneas HABIT: de las respuestas se añaden a .ingot/habits/<type>.md. Desactivado, el agente solo lee los archivos |
ingot.habits.playbooks.autoSelect | true | Elegir automáticamente un playbook por sus keywords, globs y patrón de error. Desactivado, un playbook solo se usa cuando tú o el agente lo elegís |
ingot.habits.playbooks.disabled | [] | Playbooks que desactivaste para ti en la página Habits, con ids como project:payments-bug; los archivos del repositorio no cambian |
ingot.habits.enabled | false | Learn habits: detecta lo que repites y ofrece convertirlo en una regla, un comando o un hook |
ingot.habits.threshold | 3 | Cuántas veces se repite un patrón antes de que Ingot lo sugiera |
Desde el terminal
ingot habits lee y escribe la misma carpeta que la página Habits, así que puedes gestionarla en scripts y CI. Nunca llama a un modelo.
npx @ingotide/cli habits # los archivos de tipo con sus entradas, y los playbooks; --json
npx @ingotide/cli habits init # crea los archivos de tipo por defecto que falten
npx @ingotide/cli habits add "Always add a regression test before fixing a crash"
# Added to .ingot/habits/bug.md (bug: keyword "crash", keyword "regression"): …
npx @ingotide/cli habits add "Use the shared date helper" --type refactor
npx @ingotide/cli habits classify "Never log access tokens" # .ingot/habits/security.md (keyword "access token")
npx @ingotide/cli habits relevant "the checkout crashes on an empty cart" # los archivos y el texto que recibe el agente
npx @ingotide/cli habits read bug # imprime un archivo de tipo
npx @ingotide/cli habits new-type i18n --keyword locale --keyword translation
npx @ingotide/cli habits types # descripciones, keywords y número de entradas; --json
Para los playbooks:
npx @ingotide/cli habits show "Payments bug" # los pasos, herramientas y criterios de finalización
npx @ingotide/cli habits new "Release" --when "Shipping a release" \
--step "Bump the version" --step "Update the changelog" --step "Tag the commit" --keyword release
npx @ingotide/cli habits validate # sale con 1 si un playbook tiene errores; en CI
npx @ingotide/cli habits match "refund fails with CardDeclined" --file services/payments/refund.ts
npx @ingotide/cli habits prompt "Release" # lo que recibe el agente con el playbook activo
npx @ingotide/cli habits remove "Release"
new también acepta --glob, --error, --tool, --done y --notes, escribe en ~/.ingot/habits con --global y no sobrescribe un playbook sin --force. match puntúa los playbooks como el IDE; añade --error-line para la salida del terminal.
Hábitos aprendidos
Aparte de la carpeta, Ingot puede detectar lo que repites y ofrecer guardarlo. Activa Learn habits en Settings › Tools › Habits (desactivado por defecto).
| Detecta | Tarjeta de ejemplo |
|---|---|
| la misma instrucción en tus prompts | You often ask to use the shared Button component. |
| el mismo comando de terminal | You often run npm test. |
| ediciones del agente que rechazas una y otra vez | You often reject edits that add console.log calls. |
Cuando un patrón se repite 3 veces (ajuste ingot.habits.threshold), aparece una tarjeta en el chat con Make it a rule, Make it a command, Make it a hook (para comandos) y Not now. Al guardar se escribe un archivo normal que puedes editar: una regla en .ingot/rules/, un comando en .ingot/commands/ o un hook stop en .ingot/hooks.json.
---
description: Learned habit: ask to use the shared Button component
alwaysApply: true
---
Use the shared Button component.
Lo que Ingot ha aprendido se guarda en .ingot/habits.json del proyecto. Git lo ignora y nunca sale de tu máquina.
La nota Saved to Habits
Beta Cada vez que algo se guarda en tus hábitos, aparece una pequeña nota plateada en el chat abierto en lugar de una ventana emergente:
Saved to Habits| Aparece cuando | Detalle de la nota |
|---|---|
| el agente añade una entrada a un archivo de tipo | bug.md: Always add a regression test before fixing a crash |
| un patrón llega al umbral | Learned: use the shared Button component |
| eliges Make it a rule, Make it a command o Make it a hook | use the shared Button component → .ingot/rules/use-the-shared-button-component.md |
| guardas un playbook | Payments bug → .ingot/habits/payments-bug.md |
Haz clic en la nota para abrirlo en la página Habits de Settings, donde aparece resaltado; un archivo de tipo se abre en el editor.
Undo en la nota deshace el guardado:
| Undo tras | Resultado |
|---|---|
| una entrada en un archivo de tipo | la entrada se quita del archivo; el resto del archivo queda igual |
| un patrón aprendido | el patrón se olvida |
| Make it a rule o Make it a command | se borra el archivo (solo si lo creó este guardado) y vuelve la tarjeta de sugerencia |
| Make it a hook | el comando se quita de stop en .ingot/hooks.json |
| guardar un playbook | se borra el archivo del playbook |
La nota pasa a decir Removed from Habits. Las notas solo aparecen con un chat abierto; los patrones aprendidos también necesitan Learn habits activado.