Conhecimento

A aba Conhecimento: todas as memórias do projeto, reunidas em torno dos elementos C4 a que se referem

A aba Conhecimento mostra a memória compartilhada de um projeto como um único mapa. Memória é o que o código não consegue dizer: a armadilha em que alguém caiu em produção, a convenção que uma equipe combinou, a nota que um agente deixou ao final de uma sessão de trabalho. As pessoas a escrevem pelo app; os agentes, pelo harness (remember, finish_work_session). Tudo vai para o mesmo lugar, e tudo é entregue ao próximo agente que mexer na mesma parte do sistema.

Abra-a pelo cabeçalho do projeto (Conhecimento), pela paleta de comandos ou por um link que alguém compartilhou.

Lendo o mapa

  • Os elementos são os anéis: os sistemas, contêineres e componentes C4 de que o conhecimento trata. Cada memória fica em torno do elemento ao qual está fixada.
  • As memórias são os pontos, coloridos por tipo: armadilha, convenção, nota. Um ponto com um anel interno claro foi escrito por uma pessoa; os outros vêm de agentes.
  • As decisões (ADRs) são quadrados, alcançados quando uma memória aponta para uma delas com [[ADR-12]].
  • Os fantasmas tracejados são links que ninguém escreveu ainda: uma memória menciona [[Rate limits]] e nenhuma memória tem esse título. Clique em um para escrevê-la.

O mapa continua legível com milhares de memórias. Memórias que afirmam o mesmo fato se dobram em um único ponto, marcado com ×3 quando três cópias dizem a mesma coisa. Os resultados de sessão ficam ocultos por padrão e são contados no seu elemento; ative-os com o botão de sessões na barra de ferramentas. A legenda de tipos também funciona como filtro, e a linha do tempo na parte inferior reproduz como o conhecimento cresceu.

Clique em um ponto para ler a memória completa, com seus links e backlinks. Clique em um elemento para ver tudo o que está fixado nele e escrever a próxima memória sobre ele.

Teclado: / pesquisa, N escreve uma memória, F enquadra o mapa inteiro, Esc volta um passo.

Fazer uma pergunta

Uma resposta escrita apenas a partir da memória do projeto, com as memórias em que se apoia destacadas no mapa

Digite uma pergunta na caixa de pesquisa e clique em Perguntar (ou pressione Enter depois de um ponto de interrogação). A resposta é escrita apenas a partir das memórias do projeto, com a mesma recuperação que os agentes usam: palavras e significado, mais as memórias ligadas aos melhores resultados. Cada afirmação cita sua fonte com um número; clique nele para encontrar essa memória no mapa, onde as memórias citadas ficam destacadas.

Quando a memória não tem nada sobre o assunto, a resposta diz isso em vez de chutar. É a hora de registrar o fato: a próxima pessoa e o próximo agente vão encontrá-lo. Se nenhum provedor de IA estiver disponível, você recebe as memórias mais próximas em vez de uma resposta. Perguntar não conta como memórias entregues a um agente, então não distorce os números de uso descritos abaixo.

As respostas usam o provedor de IA da sua organização, como os demais recursos do harness.

Contradições

Escrevendo um fato que discorda de outro que o projeto já tem

Quando você escreve uma memória quase igual a uma existente sobre os mesmos elementos, mas com números diferentes ("tentado novamente 8 vezes" contra "tentado novamente 3 vezes"), o Archyl para antes de fechar o diálogo e mostra as duas. Duas memórias ativas que se contradizem são a pior coisa que se pode entregar a um agente, então você escolhe:

  • Substituir a antiga: a memória antiga vai para o histórico. Os agentes deixam de vê-la, e o mapa a mantém como fantasma ligado à sua substituta.
  • Manter as duas: quando as duas são verdadeiras (dois ambientes, dois tenants), mantenha-as e deixe a diferença explícita.
  • Descartar a minha: a sua memória era a errada.

Reescrever palavra por palavra um fato que já existe não armazena uma segunda cópia: a memória existente é confirmada no lugar, e o diálogo avisa. Os agentes recebem o mesmo tratamento pela API, nos campos deduplicated e conflicts de remember.

Link para qualquer fato

Cada memória e cada elemento tem seu próprio endereço. O link no painel de leitura o copia; cole-o em um pull request, em um ADR ou em uma thread do Slack, e ele abre o mapa nessa memória com suas vizinhas. Links para uma memória continuam funcionando depois que ela é mesclada com uma duplicata, e um link para uma memória que foi substituída depois abre a visão do histórico, para que ainda chegue a algum lugar.

Duplicatas

Quando agentes escrevem o mesmo fato de várias formas, o botão de duplicatas mostra cada grupo. Mesclar em uma mantém a cópia mais confirmada, retira as outras e move os links delas. Mesclar é sempre decisão sua: redação parecida sobre dois elementos diferentes, ou com números diferentes, nunca é oferecida como duplicata.

A revisar

Memórias cujo elemento mudou desde que foram confirmadas, e memórias que os agentes nunca usam

Memória que ninguém revisa fica errada em silêncio. A leitura A revisar do mapa deixa em plena intensidade apenas as memórias que precisam de um olhar humano, e as lista:

  • O elemento dela mudou: o código sob o elemento mudou depois da última confirmação da memória. Os agentes continuam recebendo-a, marcada como a verificar. Se ainda for verdadeira, Continua verdadeiro a confirma e remove a marca; caso contrário, abra-a para corrigi-la ou substituí-la.
  • Os agentes nunca a usam: ela foi entregue a cinco sessões ou mais e nenhuma disse que ajudou. Abra-a para deixá-la mais precisa, fixá-la no elemento certo ou excluí-la.

Nada nesta lista é removido automaticamente. Os mesmos itens chegam à equipe no resumo semanal, para que a lista não dependa de alguém abrir a aba.

Uso

Memórias dimensionadas pela frequência com que foram entregues aos agentes; as vazadas foram entregues e nunca usadas

A leitura Uso dimensiona cada memória pelo número de sessões de agentes às quais ela foi entregue. Pontos sólidos foram usados pelo menos uma vez (um agente os citou em usedMemories ao encerrar a sessão), os vazados foram entregues e nunca usados, e os apagados nunca foram entregues. Ela responde a duas perguntas num relance: qual conhecimento realmente sustenta o trabalho dos agentes e qual é ruído.

Permissões

Qualquer pessoa que possa ver o projeto pode ler o mapa e fazer perguntas. Escrever, confirmar, mesclar, substituir e excluir memórias exige permissão de edição no projeto.