Saltar a contenido

Las páginas sin traducir se abren en inglés y se indican como inglés.

El original en inglés ha cambiado desde esta traducción automática. Consulta la página en inglés para ver las instrucciones actuales.

Esta página es una traducción automática de la página en inglés, que prevalece. Machine-translated from the English page, which is authoritative.

Memoria vinculada al código para agentes de programación

Loom vincula las memorias de los agentes de programación con las funciones, clases y archivos que nombran, las mantiene a través de las refactorizaciones y marca una memoria cuando su código cambia. Por defecto, la búsqueda deja fuera una memoria cuyo código ha desaparecido por completo, salvo que una persona la haya fijado, bloqueado o verificado, y toda lectura que sirve una lección indica cuándo cambió su código o si ya no existe. Funciona sobre MCP, HTTP y los SDK en los repositorios que indexa un Loom autoalojado (el índice de código, LOOM_CODE_INGEST_ENABLED=true), y el worker memory_code_links que mantiene los vínculos está activado por defecto.

Qué obtienes

  • Lecciones asociadas al código del que tratan. Una memoria etiquetada con repo:<id> (los plugins de Claude Code y Codex etiquetan lo que capturan sus hooks) o escrita en el espacio de nombres de código del repositorio se vincula a cada definición (función, clase u otro símbolo) que nombra entre comillas invertidas, o en cualquier parte de su texto como A::b o una llamada (a.b(), name()), siempre que se resuelva a un único lugar (un nombre sin cualificar necesita cuatro o más caracteres); a las definiciones de los archivos que enumera y que nombra con una palabra suelta en camelCase o snake_case; y a cada archivo que enumera y que no contiene ninguna de ellas. Un nombre cualificado que aún no está en la rama principal se vincula si se fusiona dentro de LOOM_MEMORY_CODE_LINKS_PENDING_DAYS (14 días). Memorias vinculadas al código
  • Vínculos que siguen las refactorizaciones. En cada commit indexado, cada vínculo pasa a fresh, moved, changed (con el commit que lo cambió), unresolved o missing. Un vínculo registra los tokens de la definición, de modo que los espacios en blanco, los comentarios y la mayoría de los cambios de formateador lo dejan en fresh. Estados de los vínculos
  • Memorias obsoletas tratadas como tú elijas. El code_change_policy del espacio de nombres lo decide: retire_removed (el valor por defecto) deja fuera de la búsqueda una memoria cuyo código ha desaparecido por completo y marca el código que cambió; flag solo marca; revise también deja fuera las memorias cuyo código desapareció y hace que el modelo contraste la afirmación de una memoria cambiada con el código antiguo y el nuevo: si sigue siendo válida se vuelve a anclar, y si se contradice se sugiere una corrección. Una memoria que una persona fijó, bloqueó o verificó nunca se deja fuera. Con cualquier política, la búsqueda suele situar una memoria cuyo código cambió por debajo de los tres resultados siguientes en lugar de ocultarla; una memoria retenida y una fila encontrada por nombre conservan su posición. Loom nunca reescribe la memoria en sí. Políticas
  • Lecciones dondequiera que el agente lea código. code.symbol devuelve como lessons las memorias vinculadas a una definición; code.search, code.callers, code.callees, code.impact, code.outline y el code.context_pack de una tarea adjuntan las lecciones de los archivos que devuelven; cada lección lleva el estado de su vínculo. Los hooks de Claude Code y Codex muestran las memorias de un archivo (memory.for_file) antes de que un agente lo edite, y los hooks de Cline cuando lo lee o lo edita. code.symbol · Plugin de Claude Code · Plugin de Codex · Hooks de Cline (experimental)
  • Compartido con el equipo. Las lecciones se leen del espacio de nombres de código del repositorio y de los espacios de nombres que nombra la llamada (sobre MCP, por defecto el del propio llamante), de modo que una lección guardada en el espacio de nombres de código del repositorio llega a todos los agentes que pueden leer ese espacio de nombres (un token restringido a su propio usuario o sesión no lee ninguna lección). Memorias vinculadas al código
  • Las ramas leen su propio código. En otra rama, una lección se comprueba contra la definición de esa rama, así que una rama de release que aún tiene el texto antiguo muestra fresh (en un host con LOOM_GIT_HISTORY=none, que no tiene espejo de git, una lección lleva el estado de la rama principal). Memorias vinculadas al código
  • Documentos junto al código. Los documentos de una fuente registrada en el espacio de nombres de código del repositorio (el de su rama principal) llevan la etiqueta del repositorio, de modo que las búsquedas sobre el repositorio los leen junto con su código (el worker de sincronización necesita LOOM_KNOWLEDGE_SOURCE_SYNC_ENABLED). Fuentes de documentos
  • Una lista de revisión. namespace.validate enumera las memorias cuyo código cambió, no se volvió a encontrar o ha desaparecido, y el dashboard muestra los vínculos de cada memoria y su estado.

Detalle de una memoria en el dashboard: su código vinculado, una definición actual y otra modificada desde un commit

Primeros pasos

Inicio rápido arranca Loom, y añadir repositorios activa el índice de código para un repositorio. Conecta tu agente de programación con su plugin o sobre MCP (conectar un agente de programación). Guarda una lección que nombre una definición de cuatro o más caracteres entre comillas invertidas o como una llamada (`name()`), o una cualificada como `Reader.run`. Los plugins de Claude Code y Codex etiquetan lo que capturan sus hooks con repo:<id>, y el primer mensaje de la sesión indica el id (cómo se deriva). Una lección que el agente guarda él mismo con loom_memory_set se vincula cuando lleva esa etiqueta (tags: ["repo:<id>"]) o se escribe en el espacio de nombres de código del repositorio; cualquier cliente puede hacer una u otra cosa. Sobre HTTP (o agent.call en el SDK de Python), una lección guardada en tu propio espacio de nombres solo se lee cuando la llamada nombra ese espacio de nombres en lesson_namespaces. Cada pasada de vinculación vincula las escrituras con al menos 60 segundos de antigüedad y las pasadas se ejecutan cada 60 segundos, así que, una vez indexada la rama principal, code.symbol sobre esa definición devuelve la lección en lessons en unos dos minutos.

Algunas operaciones de esta página están marcadas como experimentales en la página de estado.