Conocimiento
El conocimiento es la tercera 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. Guarda hechos verificados sobre tu proyecto, separados de los hábitos. Cada hecho tiene una fuente, una confianza, una versión y una fecha de caducidad, y los agentes reciben los hechos que encajan con la tarea.


Dónde está
.ingot/knowledge/ tiene una carpeta por tipo, y cada entrada es un archivo markdown:
| Tipo | Para |
|---|---|
project | qué es el proyecto, quién lo usa, cómo se compila y se ejecuta |
architecture | capas, límites y dónde está cada cosa |
decision | una decisión que se tomó, y por qué (carpeta decisions/) |
dependency | una biblioteca o servicio, su versión y sus rarezas (carpeta dependencies/) |
history | lo que se probó y lo que pasó: "probamos X, rompió la arquitectura, y este es el motivo" |
Las decisiones y las dependencias están en las carpetas en plural decisions/ y dependencies/. Las entradas de las carpetas antiguas decision/ y dependency/ se siguen leyendo y se actualizan donde están.
---
kind: history
title: Tried a global store for the cart
source: PR 812
confidence: high
version: 2
created: 2026-11-19
updated: 2026-11-20
expires: never
paths: src/cart
---
It broke server rendering because state leaked between requests. Use one store per request.
Haz commit de la carpeta para compartirla con tu equipo.
Fuente, confianza, versión y caducidad
- Fuente: de dónde viene el hecho, como un documento, una pull request,
.ingot/decisions.md, un chat oyou. - Confianza: low, medium o high.
- Versión: guardar una entrada con el mismo tipo y título la actualiza. La versión sube, y la anterior se guarda en
.ingot/knowledge/.history/<id>/v<n>.md. - Caducidad: las entradas de dependencias caducan a los 180 días, y las de proyecto y arquitectura al año. Las decisiones y el historial no caducan nunca. Una entrada caducada no se da a los agentes hasta que la renuevas con
/knowledge renew <nombre>en el chat del agente.
Nunca un secreto
Cada entrada se analiza antes de guardarla, venga del chat, de un comando o de un agente. El análisis busca formas de token, claves privadas, cadenas de conexión con contraseña y valores del tipo password = …. Si encuentra uno, la entrada no se guarda, y el mensaje solo dice qué tipo de secreto encontró.
Los agentes lo usan
- Context Engine: en cada turno, hasta 6 entradas llegan al agente con su tipo, fuente, confianza y versión. Son las entradas sobre los archivos en juego o las palabras de tu mensaje, nunca las caducadas. También aparecen como Knowledge en el Task context debajo de tu mensaje.
- Los agentes añaden lo que verifican: una línea de respuesta como
KNOWLEDGE(history): Tried floats for totals | Floats broke rounding, so totals stay in centsse guarda con el chat como fuente. El chat muestra entonces Saved to Knowledge con Undo y Open. Undo borra una entrada nueva o devuelve la versión anterior de una actualizada. Si la línea parece un secreto, el chat muestra Not saved to Knowledge: it looks like a secret.
Gestionarlo
/knowledge en el chat del agente lista todas las entradas por tipo, con su versión y confianza, y marca las caducadas. /knowledge <palabras> busca en el título, el texto, las etiquetas, las rutas y la fuente. Pulsa una entrada para abrir su archivo. /remember decision: <título> | <texto> (o project:, dependency:, history:) añade una entrada, /forget <nombre> borra una con Undo y /knowledge renew <nombre> renueva una caducada. /knowledge import añade tus decisiones bloqueadas y los aprendizajes del contexto compartido como entradas; si importas otra vez, se actualizan. En Find Action están Show Knowledge (muestra la carpeta), Add Knowledge Entry… e Import Decisions and Learnings into Knowledge. Ajustes › Knowledge solo tiene el interruptor y Open .ingot Folder.
Desactivarlo
| Ajuste | Por defecto | Dónde |
|---|---|---|
ingot.knowledge.enabled | activado | Ajustes › Knowledge, Ajustes › Features › Knowledge |
Desactivado: los agentes no reciben conocimiento ni guardan nada. Los archivos se quedan.
Consulta también Context Engine, Registro de decisiones, Contexto compartido y Hábitos.