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

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.

La página Habits de Ingot en Settings: Knowledge by type con la carpeta .ingot/habits/, bug.md con 2 entradas, el resto de archivos de tipo y + Add typeLa página Habits de Ingot en Settings: Knowledge by type con la carpeta .ingot/habits/, bug.md con 2 entradas, el resto de archivos de tipo y + Add type
La página Habits de Ingot en Settings: Knowledge by type con la carpeta .ingot/habits/, bug.md con 2 entradas, el resto de archivos de tipo y + Add type

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 y Ctrl+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.

El botón Habits en la barra de estado de Ingot, activadoEl botón Habits en la barra de estado de Ingot, activado
El botón Habits en la barra de estado de Ingot, activado
Settings de Ingot, página Features con el interruptor de HabitsSettings de Ingot, página Features con el interruptor de Habits
Settings de Ingot, página Features con el interruptor de Habits
La página Habits de Ingot con Use habits desactivado: una nota dice que el agente no lee ni escribe hábitosLa página Habits de Ingot con Use habits desactivado: una nota dice que el agente no lee ni escribe hábitos
La página Habits de Ingot con Use habits desactivado: una nota dice que el agente no lee ni escribe hábitos

Los archivos de tipo

ArchivoQué va en él
bug.mdArreglos de bugs: algo falla, lanza una excepción o da un resultado erróneo
defect.mdDefectos frente a la especificación: funciona, pero no como dicen el ticket o los criterios de aceptación
design.mdUI y UX: diseño, estilos, temas, iconos, accesibilidad
performance.mdVelocidad y recursos: latencia, memoria, renderizado, caché, tamaño del bundle
tests.mdTests unitarios y end-to-end: qué cubrir, cómo escribirlos, tests inestables
security.mdSecretos, autenticación y entradas: nunca filtrar, validar siempre
refactor.mdReestructurar sin cambiar el comportamiento: nombres, extracción, duplicación, código muerto
general.mdTodo 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.

bug.md abierto en la página Habits de Ingot: el editor de .ingot/habits/bug.md con su frontmatter y 2 entradasbug.md abierto en la página Habits de Ingot: el editor de .ingot/habits/bug.md con su frontmatter y 2 entradas
bug.md abierto en la página Habits de Ingot: el editor de .ingot/habits/bug.md con su frontmatter y 2 entradas

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

Add type en la página Habits de Ingot: migrations escrito en el campo de nombre junto a .md, con Cancel y AddAdd type en la página Habits de Ingot: migrations escrito en el campo de nombre junto a .md, con Cancel y Add
Add type en la página Habits de Ingot: migrations escrito en el campo de nombre junto a .md, con Cancel y Add

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.

La tarjeta de sugerencia de Habits sobre el cuadro de chat de Ingot: Keep this in .ingot/habits/bug.md so the agent follows it in every future run, con Enable Habits y un botón para cerrarLa tarjeta de sugerencia de Habits sobre el cuadro de chat de Ingot: Keep this in .ingot/habits/bug.md so the agent follows it in every future run, con Enable Habits y un botón para cerrar
La tarjeta de sugerencia de Habits sobre el cuadro de chat de Ingot: Keep this in .ingot/habits/bug.md so the agent follows it in every future run, con Enable Habits y un botón para cerrar

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.

La página Habits de Ingot: Use habits activado, los archivos de tipo y un playbook Release en Scenario playbooksLa página Habits de Ingot: Use habits activado, los archivos de tipo y un playbook Release en Scenario playbooks
La página Habits de Ingot: Use habits activado, los archivos de tipo y un playbook Release en Scenario playbooks

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.

La tarjeta de sugerencia de Habits sobre el cuadro de chat de Ingot: Save steps like these as a habit, con Enable Habits y un botón para cerrarLa tarjeta de sugerencia de Habits sobre el cuadro de chat de Ingot: Save steps like these as a habit, con Enable Habits y un botón para cerrar
La tarjeta de sugerencia de Habits sobre el cuadro de chat de Ingot: Save steps like these as a habit, con Enable Habits y un botón para cerrar
Un playbook redactado desde un prompt del chat en la página Habits de Ingot: nombre Release, when y los pasos bump the version, update the changelog y tag the commitUn playbook redactado desde un prompt del chat en la página Habits de Ingot: nombre Release, when y los pasos bump the version, update the changelog y tag the commit
Un playbook redactado desde un prompt del chat en la página Habits de Ingot: nombre Release, when y los pasos bump the version, update the changelog y tag the commit

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.
CampoSignificado
namese muestra en el chat (hasta 64 caracteres)
whenel escenario, en palabras sencillas; el agente lo lee para decidir si el playbook encaja
keywordspalabras de tu prompt que apuntan a este playbook
globsarchivos en contexto que apuntan a este playbook
errorRegexun patrón de error que buscar en tu prompt, adjuntos, diagnósticos y salida del terminal
stepsla lista ordenada que sigue el agente (hasta 20)
allowedToolsherramientas que el agente puede usar mientras el playbook está activo, como read_file, ingot/run o github/*; omítelo para permitirlas todas
doneCriteriacomprobaciones 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

CarpetaAlcance
.ingot/habits/*.mdeste proyecto; se comparte con Git
~/.ingot/habits/*.mdtodos los proyectos de esta máquina
.cursor/habits/*.mdse 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ñalPuntos
errorRegex coincide con un error del prompt, adjuntos, diagnósticos o terminal3
una palabra de keywords aparece en el prompt2
un archivo en contexto coincide con globs1

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

AjustePor defectoQué hace
ingot.habits.playbooks.enabledfalseHabits (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.autoSavetrueAgent 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.autoSelecttrueElegir 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.enabledfalseLearn habits: detecta lo que repites y ofrece convertirlo en una regla, un comando o un hook
ingot.habits.threshold3Cuá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).

DetectaTarjeta de ejemplo
la misma instrucción en tus promptsYou often ask to use the shared Button component.
el mismo comando de terminalYou often run npm test.
ediciones del agente que rechazas una y otra vezYou 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 cuandoDetalle de la nota
el agente añade una entrada a un archivo de tipobug.md: Always add a regression test before fixing a crash
un patrón llega al umbralLearned: use the shared Button component
eliges Make it a rule, Make it a command o Make it a hookuse the shared Button component → .ingot/rules/use-the-shared-button-component.md
guardas un playbookPayments 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 trasResultado
una entrada en un archivo de tipola entrada se quita del archivo; el resto del archivo queda igual
un patrón aprendidoel patrón se olvida
Make it a rule o Make it a commandse borra el archivo (solo si lo creó este guardado) y vuelve la tarjeta de sugerencia
Make it a hookel comando se quita de stop en .ingot/hooks.json
guardar un playbookse 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.