Conoscenza

La scheda Conoscenza: tutte le memorie del progetto, raccolte attorno agli elementi C4 a cui si riferiscono

La scheda Conoscenza mostra la memoria condivisa di un progetto come un'unica mappa. La memoria è ciò che il codice non può dirti: la trappola in cui qualcuno è caduto in produzione, la convenzione su cui un team si è accordato, la nota lasciata da un agente alla fine di una sessione di lavoro. Le persone la scrivono dall'app; gli agenti la scrivono tramite l'harness (remember, finish_work_session). Tutto finisce nello stesso posto e tutto viene fornito al prossimo agente che tocca la stessa parte del sistema.

Aprila dall'intestazione del progetto (Conoscenza), dalla palette dei comandi o da un link condiviso da qualcuno.

Leggere la mappa

  • Gli elementi sono gli anelli: i sistemi, i container e i componenti C4 di cui parla la conoscenza. Ogni memoria si dispone attorno all'elemento a cui è agganciata.
  • Le memorie sono i punti, colorati per tipo: trappola, convenzione, nota. Un punto con un anello interno chiaro è stato scritto da una persona; gli altri vengono dagli agenti.
  • Le decisioni (ADR) sono quadrati, raggiunti quando una memoria ne collega una con [[ADR-12]].
  • I fantasmi tratteggiati sono link che nessuno ha ancora scritto: una memoria menziona [[Rate limits]] e nessuna memoria ha quel titolo. Fai clic su uno per scriverla.

La mappa resta leggibile anche con migliaia di memorie. Le memorie che affermano lo stesso fatto si ripiegano in un unico punto, contrassegnato con ×3 quando lo dicono tre copie. Gli esiti di sessione sono nascosti per impostazione predefinita e conteggiati sul loro elemento; attivali con il pulsante delle sessioni nella barra degli strumenti. La legenda dei tipi funziona anche da filtro, e la timeline in basso riproduce come è cresciuta la conoscenza.

Fai clic su un punto per leggere la memoria per intero, con i suoi link e backlink. Fai clic su un elemento per vedere tutto ciò che vi è agganciato e scrivere la prossima memoria che lo riguarda.

Tastiera: / cerca, N scrive una memoria, F inquadra tutta la mappa, Esc torna indietro di un passo.

Fare una domanda

Una risposta scritta solo a partire dalla memoria del progetto, con le memorie su cui si basa evidenziate sulla mappa

Scrivi una domanda nella casella di ricerca e premi Chiedi (o Invio dopo un punto interrogativo). La risposta viene scritta solo a partire dalle memorie del progetto, con lo stesso recupero usato dagli agenti: parole e significato, più le memorie collegate ai risultati migliori. Ogni affermazione cita la propria fonte con un numero; fai clic per trovare quella memoria sulla mappa, dove le memorie citate sono evidenziate.

Quando la memoria non contiene nulla sull'argomento, la risposta lo dice invece di tirare a indovinare. È il momento di annotare il fatto: la prossima persona e il prossimo agente lo troveranno. Se non è disponibile alcun provider di IA, ottieni le memorie più vicine al posto di una risposta. Fare una domanda non conta come memorie fornite a un agente, quindi non altera i dati di utilizzo descritti più sotto.

Le risposte usano il provider di IA della tua organizzazione, come le altre funzionalità dell'harness.

Contraddizioni

Scrivere un fatto che contraddice uno già presente nel progetto

Quando scrivi una memoria quasi identica a una esistente sugli stessi elementi ma con numeri diversi («ritentato 8 volte» contro «ritentato 3 volte»), Archyl si ferma prima di chiudere la finestra di dialogo e le mostra entrambe. Due memorie attive in contraddizione sono la cosa peggiore che si possa fornire a un agente, quindi scegli tu:

  • Sostituisci la vecchia: la vecchia memoria passa nella cronologia. Gli agenti smettono di vederla, e la mappa la conserva come fantasma collegato alla sostituta.
  • Tienile entrambe: quando sono vere tutte e due (due ambienti, due tenant), tienile e rendi esplicita la differenza.
  • Scarta la mia: quella sbagliata era la tua memoria.

Riscrivere parola per parola un fatto già esistente non salva una seconda copia: viene invece confermata la memoria esistente, e la finestra di dialogo lo segnala. Gli agenti ricevono lo stesso trattamento tramite l'API, nei campi deduplicated e conflicts di remember.

Link a qualsiasi fatto

Ogni memoria e ogni elemento ha il proprio indirizzo. Il link nel pannello di lettura lo copia; incollalo in una pull request, in un ADR o in un thread di Slack e aprirà la mappa su quella memoria con le sue vicine. I link a una memoria continuano a funzionare dopo che è stata unita a un duplicato, e un link a una memoria poi sostituita apre la vista della cronologia, così arriva comunque da qualche parte.

Duplicati

Quando gli agenti scrivono lo stesso fatto in modi diversi, il pulsante dei duplicati mostra ogni gruppo. Unisci in una mantiene la copia più confermata, ritira le altre e sposta i loro link. Unire è sempre una tua decisione: una formulazione simile su due elementi diversi, o con numeri diversi, non viene mai proposta come duplicato.

Da ricontrollare

Memorie il cui elemento è cambiato da quando sono state confermate, e memorie che gli agenti non usano mai

La memoria che nessuno ricontrolla diventa sbagliata in silenzio. La lettura Da ricontrollare della mappa lascia in piena evidenza solo le memorie che richiedono uno sguardo umano, e le elenca:

  • Il suo elemento è cambiato: il codice sotto l'elemento è cambiato dopo l'ultima conferma della memoria. Gli agenti continuano a riceverla, segnata come da verificare. Se è ancora vera, Ancora vera la conferma e toglie il segno; altrimenti aprila per correggerla o sostituirla.
  • Gli agenti non la usano mai: è stata fornita a cinque sessioni o più e nessuna ha detto che sia servita. Aprila per renderla più precisa, agganciarla all'elemento giusto o eliminarla.

Niente in questo elenco viene rimosso automaticamente. Gli stessi elementi arrivano al team nel digest settimanale, così l'elenco non dipende da qualcuno che apra la scheda.

Utilizzo

Memorie dimensionate in base a quante volte sono state fornite agli agenti; quelle vuote sono state fornite e mai usate

La lettura Utilizzo dimensiona ogni memoria in base al numero di sessioni degli agenti a cui è stata fornita. I punti pieni sono stati usati almeno una volta (un agente li ha indicati in usedMemories al termine della sessione), quelli vuoti sono stati forniti e mai usati, quelli sbiaditi non sono mai stati forniti. Risponde a colpo d'occhio a due domande: quale conoscenza regge davvero il lavoro degli agenti e quale è rumore.

Permessi

Chiunque possa visualizzare il progetto può leggere la mappa e fare domande. Scrivere, confermare, unire, sostituire ed eliminare memorie richiede i permessi di modifica sul progetto.