Conocimiento

La pestaña Conocimiento muestra la memoria compartida de un proyecto como un único mapa. La memoria es lo que el código no puede contarte: la trampa con la que alguien se encontró en producción, la convención que acordó un equipo, la nota que dejó un agente al terminar una sesión de trabajo. Las personas la escriben desde la aplicación; los agentes, a través del harness (remember, finish_work_session). Todo acaba en el mismo sitio y todo se entrega al siguiente agente que toque la misma parte del sistema.
Ábrela desde la cabecera del proyecto (Conocimiento), desde la paleta de comandos o con un enlace que alguien haya compartido.
Leer el mapa
- Los elementos son los anillos: los sistemas, contenedores y componentes C4 de los que trata el conocimiento. Cada memoria se sitúa alrededor del elemento al que está anclada.
- Las memorias son los puntos, coloreados según su tipo: trampa, convención, nota. Un punto con un anillo interior claro lo escribió una persona; los demás vienen de agentes.
- Las decisiones (ADR) son cuadrados, a los que se llega cuando una memoria enlaza una con
[[ADR-12]]. - Los fantasmas discontinuos son enlaces que nadie ha escrito todavía: una memoria menciona
[[Rate limits]]y ninguna memoria tiene ese título. Haz clic en uno para escribirlo.
El mapa sigue siendo legible con miles de memorias. Las memorias que afirman el mismo hecho se pliegan en un solo punto, marcado con ×3 cuando lo dicen tres copias. Los resultados de sesión están ocultos por defecto y se cuentan en su elemento; actívalos con el botón de sesiones de la barra de herramientas. La leyenda de tipos sirve también de filtro, y la línea de tiempo de abajo reproduce cómo fue creciendo el conocimiento.
Haz clic en un punto para leer la memoria completa, con sus enlaces y retroenlaces. Haz clic en un elemento para ver todo lo que tiene anclado y escribir la siguiente memoria sobre él.
Teclado: / busca, N escribe una memoria, F encuadra todo el mapa, Esc retrocede un paso.
Hacer una pregunta

Escribe una pregunta en el cuadro de búsqueda y pulsa Preguntar (o Enter después de un signo de interrogación). La respuesta se escribe solo a partir de las memorias del proyecto, con la misma recuperación que usan los agentes: palabras y significado, más las memorias enlazadas a los mejores resultados. Cada afirmación cita su fuente con un número; haz clic en él para encontrar esa memoria en el mapa, donde las memorias citadas aparecen resaltadas.
Cuando la memoria no contiene nada sobre el tema, la respuesta lo dice en lugar de adivinar. Ese es el momento de escribir el hecho: la siguiente persona y el siguiente agente lo encontrarán. Si no hay ningún proveedor de IA disponible, obtienes las memorias más cercanas en lugar de una respuesta. Preguntar no cuenta como memorias entregadas a un agente, así que no distorsiona las cifras de uso que se describen más abajo.
Las respuestas usan el proveedor de IA de tu organización, como las demás funciones del harness.
Contradicciones

Cuando escribes una memoria que se lee casi igual que una existente sobre los mismos elementos pero da cifras distintas («reintentado 8 veces» frente a «reintentado 3 veces»), Archyl se detiene antes de cerrar el diálogo y muestra las dos. Dos memorias activas que se contradicen son lo peor que se le puede entregar a un agente, así que eliges tú:
- Reemplazar la antigua: la memoria antigua pasa al historial. Los agentes dejan de verla, y el mapa la conserva como fantasma enlazado a su reemplazo.
- Conservar ambas: cuando las dos son ciertas (dos entornos, dos tenants), consérvalas y haz explícita la diferencia.
- Descartar la mía: la equivocada era tu memoria.
Volver a escribir palabra por palabra un hecho que ya existe no guarda una segunda copia: en su lugar se confirma la memoria existente, y el diálogo lo indica. Los agentes reciben el mismo trato a través de la API, en los campos deduplicated y conflicts de remember.
Enlazar cualquier hecho
Cada memoria y cada elemento tiene su propia dirección. El enlace del panel de lectura la copia; pégala en una pull request, un ADR o un hilo de Slack, y abrirá el mapa en esa memoria con sus vecinas. Los enlaces a una memoria siguen funcionando después de fusionarla con un duplicado, y un enlace a una memoria que se reemplazó después abre la vista del historial, para que siempre llegue a algún sitio.
Duplicados
Cuando los agentes escriben el mismo hecho de varias formas, el botón de duplicados muestra cada grupo. Fusionar en una conserva la copia más confirmada, retira las demás y traslada sus enlaces. Fusionar siempre es decisión tuya: una redacción parecida sobre dos elementos distintos, o con cifras distintas, nunca se propone como duplicado.
Por revisar

La memoria que nadie revisa se equivoca sin hacer ruido. La lectura Por revisar del mapa deja con toda su intensidad solo las memorias que necesitan que una persona las mire, y las lista:
- Su elemento cambió: el código bajo el elemento se desvió después de la última confirmación de la memoria. Los agentes la siguen recibiendo, marcada como pendiente de verificar. Si sigue siendo cierta, Sigue siendo cierto la confirma y quita la marca; si no, ábrela para corregirla o reemplazarla.
- Los agentes nunca la usan: se entregó a cinco sesiones o más y ninguna dijo que le sirviera. Ábrela para precisarla, anclarla al elemento correcto o eliminarla.
Nada de esta lista se elimina automáticamente. Los mismos elementos llegan al equipo en el resumen semanal, para que la lista no dependa de que alguien abra la pestaña.
Uso

La lectura Uso dimensiona cada memoria según el número de sesiones de agentes a las que se entregó. Los puntos sólidos se usaron al menos una vez (un agente los nombró en usedMemories al terminar su sesión), los huecos se entregaron y nunca se usaron, y los tenues nunca se entregaron. Responde de un vistazo a dos preguntas: qué conocimiento sostiene de verdad el trabajo de los agentes y cuál es ruido.
Permisos
Cualquiera que pueda ver el proyecto puede leer el mapa y hacer preguntas. Escribir, confirmar, fusionar, reemplazar y eliminar memorias requiere permisos de edición en el proyecto.