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

Contexto compartido del proyecto

Los agentes anotan lo que aprenden de tu proyecto, y cada agente y compañero futuro lo reutiliza en lugar de redescubrirlo.

Un agente que tardó diez minutos en descubrir que las pruebas necesitan npm run build:packages antes, o que el dinero se guarda en céntimos enteros, lo escribe en una línea. Se confirma en .ingot/context/ junto con el resto del código, así que el siguiente agente, en cualquier máquina y cualquier rama, empieza sabiéndolo.

Respuesta de un agente de Ingot con una nota plateada Shared with the team debajo y el aprendizaje guardado, con UndoRespuesta de un agente de Ingot con una nota plateada Shared with the team debajo y el aprendizaje guardado, con Undo
Respuesta de un agente de Ingot con una nota plateada Shared with the team debajo y el aprendizaje guardado, con Undo

Cómo comparten los agentes lo que aprenden

Cada chat de agente recibe una instrucción breve: cuando descubre algo duradero del repositorio (cómo compilarlo, probarlo o ejecutarlo, dónde está cada cosa, una convención, una trampa, la solución a un error confuso), añade una línea a su respuesta:

LEARNING: [test] Unit tests run with npm test and need no build first (paths: src/, package.json)

La línea no se muestra en la respuesta. Ingot la guarda y muestra una nota plateada Shared with the team con Undo. Lo que solo importa para esta tarea, las preferencias personales y todo lo que parezca una clave, un token o una contraseña no se comparte: los secretos se sustituyen por [redacted] antes de escribir el archivo.

Si un agente escribe un aprendizaje que ya existe, lo confirma en lugar de añadir una copia: la nota dice Confirmed in shared context y sube el contador de confirmaciones. Los aprendizajes confirmados ganan cuando solo caben unos pocos en el prompt.

Proyectos sin contexto compartido

Los agentes solo escriben aprendizajes en un proyecto que ya tiene la carpeta .ingot/context/, así que una tarea nunca deja en git status archivos que no pediste. En un proyecto sin ella, el aprendizaje se queda en el chat: la nota dice Learned, not shared yet y tiene Share. Share crea .ingot/context/ con el aprendizaje y un README; desde entonces los agentes de este proyecto escriben sus aprendizajes al momento. Add Learning to Shared Context…, + Add en Settings e ingot learnings add también crean la carpeta.

Una respuesta del agente de Ingot con una nota plateada: Learned, not shared yet, el aprendizaje y un botón ShareUna respuesta del agente de Ingot con una nota plateada: Learned, not shared yet, el aprendizaje y un botón Share
Una respuesta del agente de Ingot con una nota plateada: Learned, not shared yet, el aprendizaje y un botón Share

Un archivo de aprendizaje

Un archivo Markdown por aprendizaje, así dos agentes en dos ramas nunca entran en conflicto. El nombre del archivo es el id del aprendizaje.

---
topic: test
paths: src/, package.json
status: shared
author: agent (Claude Sonnet 4.5)
created: 2026-11-03T09:12:00.000Z
updated: 2026-11-03T09:12:00.000Z
confirmations: 2
---
Unit tests run with npm test and need no build first.
ClaveQué significa
topicbuild, test, layout, convention, gotcha u other
pathsarchivos, carpetas o globs de los que trata; sin rutas es de todo el proyecto
statusshared (los agentes lo reciben), proposed (espera a una persona) u outdated (retirado)
authorel agente y su modelo, un compañero o cli
confirmationscuántas veces un agente o una persona escribió lo mismo
reasonpor qué se marcó como obsoleto

Un archivo sin front matter es un aprendizaje de todo el proyecto, así que también puedes escribirlos a mano. Confirma la carpeta como cualquier otro código y revisa los aprendizajes en los pull requests.

Qué recibe cada agente

Antes de que un agente empiece, Ingot añade los aprendizajes relevantes a su prompt de sistema bajo Shared project context, cada uno con su id. Si caben todos (8 por defecto, hasta 30 en Ajustes) se envían todos los compartidos. Si no, primero van los que tratan de los archivos en contexto y después los que comparten palabras con tu mensaje.

  • Los aprendizajes propuestos y obsoletos nunca se envían.
  • Un aprendizaje está caducado (stale) cuando ya no existe ningún archivo o carpeta que nombra (los globs nunca lo caducan). Se marcan en Ajustes y no se envían hasta que corrijas sus rutas.
  • Ingot cuenta cuántas veces llegó cada aprendizaje a un agente en tu máquina ("used 3×"). Ese contador es local y nunca se confirma.

Mantenerlo al día

Cuando un aprendizaje resulta ser falso, el agente sigue al código y lo retira:

OUTDATED: convention-cart-totals-are-float-euros-a1b2 totals moved to integer cents

La nota dice Marked outdated in shared context, con Restore por si el agente se equivocó. También puedes marcar un aprendizaje como obsoleto, editarlo o borrarlo en Ajustes, o con ingot learnings outdated.

Proponer en lugar de escribir

Ajustes › Tools › Shared Context › Agents write decide qué pasa con los aprendizajes de un agente:

AjusteQué pasa
Write at once (por defecto)el aprendizaje se comparte al momento en un proyecto que tiene .ingot/context/ (si no, la nota tiene Share); Undo en la nota del chat lo borra
Propose; a person shares themse guarda como proposed; la nota tiene Share y Discard, y los agentes no lo reciben hasta que alguien lo comparte
Offlos agentes no escriben aprendizajes (siguen leyendo los compartidos)

Desactiva Agents read it para dejar de enviar el contexto compartido a los agentes de este proyecto.

Ajustes › Shared Context

Ajustes de Ingot, página Shared Context: aprendizajes con etiquetas de tema, una insignia Stale, rutas, autores y confirmaciones, con búsqueda y filtrosAjustes de Ingot, página Shared Context: aprendizajes con etiquetas de tema, una insignia Stale, rutas, autores y confirmaciones, con búsqueda y filtros
Ajustes de Ingot, página Shared Context: aprendizajes con etiquetas de tema, una insignia Stale, rutas, autores y confirmaciones, con búsqueda y filtros

Ábrela desde el menú de la cabecera del chat (Shared Context), Find Action › Show Shared Context o Ajustes › Tools › Shared Context. Muestra cada aprendizaje con su tema, rutas, autor, fecha, confirmaciones y cuántas veces se usó, con los propuestos primero.

  • Busca por texto o ruta y filtra por estado (Shared, Proposed, Outdated, Stale) o por tema.
  • + Add escribe un aprendizaje a mano; Edit, Mark outdated, Share, Restore y Delete actúan sobre uno.
  • Learnings sent per request y List the shared context in AGENTS.md for other agents están en la misma página.
AcciónFind ActionAtajo (macOS / Windows y Linux)
Abrir la páginaShow Shared Context⌥⇧⌘; / Ctrl+Alt+Shift+;
Añadir un aprendizajeAdd Learning to Shared Context…⌥⇧⌘= / Ctrl+Alt+Shift+=
Actualizar AGENTS.mdSync Shared Context to AGENTS.md⌥⇧⌘] / Ctrl+Alt+Shift+]

Add Learning to Shared Context… acepta la misma línea que escribe un agente: [build] Run npm run build:packages before typecheck (paths: packages/).

Otros agentes de código (AGENTS.md)

Otros agentes de código no leen .ingot/context. Sync to AGENTS.md escribe los aprendizajes compartidos en un bloque al final de tu AGENTS.md, entre <!-- ingot:shared-context:start --> y <!-- ingot:shared-context:end -->. El resto del archivo no se toca. Activa List the shared context in AGENTS.md for other agents para actualizar el bloque cada vez que cambia un aprendizaje.

Ingot se salta ese bloque al leer AGENTS.md, así que sus agentes nunca reciben el mismo aprendizaje dos veces.

Desde la terminal

ingot learnings trabaja con los mismos archivos. Nunca llama a un modelo.

npx @ingotide/cli learnings                                    # todos los aprendizajes; propuestos primero, caducados marcados
npx @ingotide/cli learnings add "[build] Run npm run build:packages before typecheck (paths: packages/)"
npx @ingotide/cli learnings prompt "fix the users endpoint" --files src/api/users.ts   # exactamente lo que recibe un agente
npx @ingotide/cli learnings check                              # archivos mal formados y secretos fallan (exit 1); caducados y duplicados avisan
npx @ingotide/cli learnings sync --check                       # exit 1 si el bloque de AGENTS.md no está al día

share, outdated <id> --reason, remove y show actúan sobre un aprendizaje. Todas las opciones están en la página del CLI.