Clases de hábitos
Los hábitos son la segunda parte del sistema operativo de ingeniería de .ingot: las reglas dicen lo que debe ser, los hábitos aprenden cómo trabajamos y el conocimiento recuerda. Las clases de hábitos guardan cada hábito en una carpeta, indican qué tipo de hábito es y registran cuánta confianza tiene Ingot y por qué. Ingot escribe ahí lo que aprende por su cuenta, y el chat te lo dice, con Undo.


Dónde vive
.ingot/habits/ tiene cuatro carpetas. En coding, architecture y workflow, cada hábito es un archivo Markdown; learned tiene tres archivos JSON (ver más abajo):
| Carpeta | Para |
|---|---|
coding | cómo se escribe el código: nombres, tipos, componentes, estilos |
architecture | dónde vive cada cosa, capas y límites |
workflow | comandos, ramas, revisiones, versiones |
learned | patrones que funcionaron, enfoques que fallaron, problemas que se repiten |
---
title: Run scripts with pnpm
class: convention
confidence: 0.8
status: active
source: CONTRIBUTING.md
created: 2026-11-02
updated: 2026-11-02
---
Install and run scripts with pnpm.
## Evidence
- CONTRIBUTING.md says pnpm
- pnpm-lock.yaml at the root
Los archivos por tipo (bug.md, tests.md, …) y los playbooks de la raíz de .ingot/habits funcionan como antes. Haz commit de la carpeta para compartirla con tu equipo.
Hábitos aprendidos: tres archivos JSON
.ingot/habits/learned/ tiene un archivo JSON por resultado, y cada hábito es un elemento dentro de él:
| Archivo | Para |
|---|---|
successful-patterns.json | patrones que funcionaron |
failed-approaches.json | enfoques que fallaron |
recurring-issues.json | problemas que se repiten |
{
"version": 1,
"items": [
{
"id": "retry-flaky-checkout-x1y2",
"title": "Retry the flaky checkout test once",
"text": "The checkout e2e times out on slow CI; one retry until the timer is fixed.",
"class": "workaround",
"confidence": 0.4,
"status": "active",
"source": "learned from your work",
"evidence": ["e2e checkout timed out 3 times this week"],
"created": "2026-11-03",
"updated": "2026-11-03"
}
]
}
Los campos son los mismos que en un archivo de hábito. Puedes editar, añadir o borrar un elemento a mano; Ingot conserva los elementos y campos que no conoce. Si un archivo no es JSON válido, Ingot no lo toca hasta que lo arregles. Los archivos learned/*.md antiguos se siguen leyendo, y se pasan al archivo JSON de su resultado la primera vez que se abre el proyecto.
habits.config.json
.ingot/habits/habits.config.json guarda el umbral de aprendizaje (cuántas veces se repite un patrón antes de convertirse en hábito) y el orden en que las clases llegan al agente:
{
"version": 1,
"threshold": 3,
"classOrder": ["mandatory", "convention", "preference", "workaround"]
}
Una clase que no esté en classOrder va después de las que sí están. Sin el archivo, el umbral es 3 y el orden es el de abajo. Un proyecto sin .ingot recibe los tres archivos JSON vacíos y este archivo la primera vez que se abre.
Clases
| Clase | Significa |
|---|---|
mandatory | un requisito: síguelo siempre |
convention | cómo lo hace este proyecto |
preference | cómo te gusta a ti; otros pueden preferir otra cosa |
workaround | temporal; quítalo cuando se arregle la causa |
El agente recibe los hábitos agrupados en este orden, salvo que classOrder en habits.config.json diga otra cosa. Un hábito obligatorio gana a una convención, una convención gana a una preferencia, y un workaround se marca como temporal.
Confianza y evidencia
Cada hábito tiene una confianza de 0 a 1 y una lista Evidence con su origen: prompts, comandos, ediciones rechazadas o archivos. Un hábito que escribes tú tiene confianza 1. Un hábito aprendido empieza en 0.3 y sube 0.1 cada vez que se repite, hasta 0.95.
Los hábitos aprendidos se guardan solos
Con Learn habits activado, un patrón que repites (3 veces por defecto, o el threshold de habits.config.json) se escribe en la carpeta que le corresponde como preferencia, con tus ejemplos como evidencia. Queda activo enseguida: el agente lo sigue desde el siguiente turno y nada espera aprobación. Las repeticiones suman evidencia y confianza, pero nunca cambian la clase.
El chat muestra una línea corta por cada hábito nuevo:


- Undo borra el archivo y olvida el patrón. Para un hábito de
learned/, Undo quita solo su elemento; el resto del archivo JSON se queda. - Open abre el archivo. Para cambiar la clase, el texto o la evidencia, edita el archivo.
Para que el agente deje de usar un hábito, borra su archivo (o su elemento en learned/), o usa /forget <nombre>, que Undo deshace, o pon status: retired para guardarlo como historial. Los archivos de versiones anteriores con status: candidate o status: promoted cuentan como activos. /habits en el chat del agente muestra todos los hábitos, con /remember <texto> escribes uno tú (también con Add Classified Habit… en Find Action) y Show Habit Classes muestra la carpeta. Ajustes › Habit Classes solo tiene el interruptor y Open .ingot Folder.
Desactivarlo
| Ajuste | Por defecto | Dónde |
|---|---|---|
ingot.habits.classes.enabled | activado | Ajustes › Habit Classes, Ajustes › Features › Habit Classes |
Desactivado, el agente no recibe ninguno de estos hábitos y no se escribe nada nuevo. Los archivos se quedan.
Consulta también Hábitos, Conocimiento y Context Engine.