Apprendimento del progetto

Quasi tutto ciò che un agente impara sul tuo progetto lo impara leggendo il codice. Perché una coda si ferma al primo errore di rete, quale helper attraversano tutti i percorsi di pagamento, come il team ha chiuso l'ultima discussione sulla gestione degli errori: un agente lo ricava, lo usa e poi la sessione finisce. L'agente successivo, o l'agente di un collega, paga per ricavarlo di nuovo.

L'apprendimento del progetto conserva queste conclusioni. Un agente salva ciò che ha ricavato insieme ai file che ha letto, e ogni agente del workspace parte da lì, finché il codice continua a confermarlo.

Che cos'è una conclusione

Una conclusione è una singola deduzione che un agente ha tratto dal tuo codice, insieme ai file su cui si basa e a ciò che quei file contenevano quando li ha letti. Pathrule confronta i file con quanto c'è su disco prima di accettare la conclusione, quindi una conclusione viene salvata solo su codice che esiste davvero.

Una conclusione non è una memoria, né una regola, né una skill. Non diventa mai una di queste da sola e non blocca mai nulla. Vive in un livello a sé, accanto alla conoscenza scritta dal tuo team.

Come arriva agli agenti

Le conclusioni arrivano nel contesto che un agente chiede a Pathrule, tramite pathrule_get_context. Sono presentate come consigli da verificare, e agli agenti viene detto di trattarle come informazioni e non come istruzioni, così il testo inserito ad arte in un file non può trasformarsi in un ordine permanente.

Una conclusione viene fornita solo finché le sue prove reggono nel tuo checkout:

• Fonti invariate. La conclusione viene fornita.
• Una fonte è cambiata. La conclusione viene trattenuta finché un agente non rilegge il codice e la conferma o la corregge. A nessuno viene data una risposta su codice che non esiste più.
• Due conclusioni non concordano. Vengono trattenute entrambe, invece di tirare a indovinare quale delle due sia giusta.

Questo controllo avviene per singolo checkout, quindi un collega su un branch più vecchio o più recente riceve solo le conclusioni valide per il codice che ha davanti.

Correggere e ritirare

Un agente può correggere una conclusione registrandone una nuova che la sostituisce, con fonti verificate da capo. Una conclusione che si rivela sbagliata può essere ritirata dalla persona il cui agente l'ha registrata. Il ritiro vale subito per l'intero workspace, e un vecchio tentativo ripetuto da una macchina rimasta offline non può mai riportarla in vita.

Gli agenti possono elencare le conclusioni attuali, obsolete e in conflitto, comprese quelle trattenute dal contesto, così una persona può vedere esattamente cosa c'è nel livello e perché qualcosa non è stato fornito.

Imparare dalle revisioni passate

Con l'accesso a GitHub tramite il tuo login gh già esistente, un agente può leggere le discussioni delle revisioni passate sul repository per vedere come il team ha deciso in passato una questione simile, e citarle in una conclusione. Pathrule non memorizza i commenti, e ignora le revisioni dei bot, quelle esterne e quelle respinte. Senza accesso a GitHub, tutto il resto continua a funzionare.

Cosa esce dalla tua macchina

L'apprendimento del progetto non richiede alcun modello locale e non scrive nulla nel tuo repository.

In un workspace locale, le conclusioni restano nel suo archivio locale sulla tua macchina. In un workspace Cloud, Pathrule condivide la conclusione e la sua provenienza, ovvero i percorsi dei file e un'impronta di ciò che ciascun file conteneva, così gli altri checkout possono capire se la conclusione è ancora valida. Il contenuto dei file non viene caricato. Una conclusione registrata offline resta in coda e viene inviata quando la connessione torna disponibile.

Non c'è alcuna revisione

Una conclusione viene condivisa non appena le sue fonti superano il controllo; nessuno deve approvarla prima. È una scelta voluta: le conclusioni sono consigli che vengono ricontrollati sul codice a ogni consegna, non una policy del team. Tutto ciò che deve vincolare ogni agente va comunque in una regola o in una memoria, scritta e revisionata dal tuo team.

Gli strumenti alla base di questa funzione sono elencati nel riferimento agli strumenti MCP.