Vai al contenuto
Pathrule

documentazione

Come cresce la conoscenza nel tempo

Pathrule è un ciclo, non un archivio. Il contesto arriva prima del lavoro, la conoscenza si raccoglie durante il lavoro con scritture che puoi vedere e annullare, la conoscenza dedotta aspetta una persona e la priorità impara che cosa aiuta davvero.

In questa pagina

Viene facile pensare a Pathrule come a un posto in cui archiviare a mano memorie, regole e skill. È la parte più piccola. Il punto è un ciclo che gira sul lavoro reale e migliora quanto più il team lo usa.

Il ciclo ha tre fasi: consegnare, raccogliere, valutare. Si ripetono a ogni sessione.

Consegnare prima del lavoro

Prima che l'assistente inizi ad agire, la porzione di conoscenza del team legata al percorso è già nel contesto. Non devi incollarla tu e l'assistente non deve andarla a cercare. Lavorando in /apps/api/payments emerge ciò che è fissato lì, più ciò che viene ereditato dai percorsi superiori. In Claude Code e Codex un hook sul prompt la consegna prima della prima chiamata a uno strumento; Cursor e GitHub Copilot la ricevono tramite hook di sessione e di strumento, Windsurf tramite il suo file di regole e MCP. È il lato della consegna, quello che la maggior parte delle persone nota per primo, ed è descritto in Come funzionano gli hook.

Raccogliere durante il lavoro

La conoscenza non va per forza scritta in un momento separato. Gran parte si accumula dal lavoro stesso.

Mentre lavora, l'assistente tiene d'occhio ciò che vale la pena conservare: una decisione appena presa, la soluzione a un problema in cui continuava a imbattersi, una convenzione che gli è stata spiegata, un tranello che ha fatto perdere tempo. Quando ne trova uno, propone di salvarlo come memoria, regola o skill sul percorso a cui appartiene e lo salva con gli strumenti di scrittura di Pathrule. Puoi anche chiedergli direttamente di salvare qualcosa.

Qui contano due proprietà:

  • Puoi vedere e annullare ogni scrittura. Una scrittura fatta da un assistente è contrassegnata come tale, versionata e reversibile. Pathrule non modifica né elimina la tua conoscenza di sua iniziativa: la conoscenza obsoleta o in conflitto viene segnalata come attività di aggiornamento, che risolvi tu o il tuo agente.
  • La manutenzione resta vicina allo zero. Poiché la raccolta avviene insieme al lavoro normale, la base di conoscenza cresce senza il secondo lavoro di scrivere documentazione. Puoi comunque scrivere direttamente con la CLI, nell'estensione per VS Code o tramite un client MCP, quando vuoi.

Che cosa viene scritto automaticamente e che cosa aspetta una persona

Alcune scritture avvengono senza un passaggio di conferma; le elenchiamo qui perché nessuna sia una sorpresa:

  • Le scritture dell'assistente stesso. Di solito un assistente prima propone e poi salva quando sei d'accordo. Pathrule non aggiunge un proprio passaggio di conferma prima di queste scritture; le rende invece tutte visibili e reversibili.
  • Il registro del lavoro. Che cosa è stato consegnato, che cosa ha consultato l'assistente e com'è andato il turno vengono registrati mentre il lavoro procede, perché alimentano la priorità. Vedi cosa calcola Pathrule.
  • Un seme iniziale una tantum, su un workspace Cloud. La prima volta che un agente chiede un contesto approfondito, Pathrule salva le coppie di percorsi di file ricavate dalla cronologia git recente, il punto di partenza dei file che cambiano insieme, e alcune brevi memorie sulle tecnologie alla radice del workspace, riconosciute dai nomi dei file. Per questo non vengono letti né il contenuto dei file, né i diff, né i messaggi di commit.
  • L'apprendimento del progetto. Una conclusione a cui un agente è arrivato leggendo il tuo codice viene salvata insieme ai file su cui si basa e condivisa con tutti gli agenti del workspace, senza passaggio di revisione. Arriva come consiglio da verificare, mai come regola, e solo finché le sue fonti restano invariate in quel checkout; una conclusione che si rivela sbagliata può essere ritirata per tutti in un colpo solo. Vedi Apprendimento del progetto.

Tutto il resto, ciò che è stato dedotto invece che scritto da una persona, aspetta una persona:

  • La scansione del progetto che il tuo agente esegue quando gli chiedi di configurare Pathrule per un progetto propone memorie, regole e skill, e vengono scritte solo quelle che approvi.
  • Team Intelligence, su Pathrule Cloud, trasforma le evidenze del team in pattern suggeriti. Agli agenti arrivano solo le voci verificate da una persona.
  • Le correzioni alla conoscenza obsoleta, in conflitto o duplicata non cambiano nulla finché un'attività di aggiornamento non viene risolta, da te o da un agente a cui chiedi di risolverla.

Valutare, perché emerga prima il meglio

La priorità decide quali tra i candidati pertinenti emergono per una richiesta e in quale ordine. In modalità Cloud, Pathrule tiene anche traccia di quale conoscenza ha davvero aiutato in lavori simili e la usa per ordinare i risultati futuri, così emerge per prima quella più utile. Le sessioni restano mirate invece di riempirsi di rumore, e una voce che un agente trova obsoleta può essere segnalata come attività di aggiornamento da revisionare. Per i dettagli vedi Suggerimenti e autoverifica.

L'apprendimento cambia l'ordine, non l'idoneità. Una voce deve comunque essere pertinente alla richiesta corrente. Una memoria che ha aiutato in diverse migrazioni non può entrare in un turno di design non correlato solo perché ha uno storico forte.

Come il rumore resta fuori dal prompt

Il ciclo è volutamente selettivo. Per impostazione predefinita la documentazione generica viene proposta per la revisione invece di essere importata come istruzione attiva. La conoscenza dedotta aspetta una persona e ogni scrittura è visibile e reversibile. L'ambito del percorso limita dove una voce può emergere, e anche all'interno di quell'ambito vale comunque la pertinenza alla richiesta.

Dopo vengono misurati la consegna e l'uso. La conoscenza che un agente trova obsoleta, smentita dal codice o duplicata viene segnalata per la revisione come attività di aggiornamento. Le correzioni sono versionate e reversibili, quindi il team può migliorare l'insieme senza perderne la cronologia.

Il risultato è un piccolo insieme di decisioni e tranelli circoscritti e revisionabili, non un riversamento di documentazione dell'intero repository. Come Pathrule dimostra le affermazioni impegnative documenta ciascun controllo.

Perché il prodotto è il ciclo

Un file statico o la memoria integrata di un singolo strumento possono occuparsi della consegna. Ciò che si accumula e cresce è il ciclo: ogni attività può lasciare il team un po' più esperto, e la sessione successiva parte da lì.

Questa crescita non è astratta. Ogni giro del ciclo lascia qualcosa che il giro successivo può usare: un registro misurato di che cosa è stato consegnato e di com'è andato il turno, evidenze su che cosa aiuta per ogni tipo di lavoro, una relazione tra due file che continuano a cambiare insieme, un errore associato a un percorso. Cosa calcola Pathrule elenca ciascuno di questi livelli e che cosa lo alimenta. Le sole voci scritte non crescono, perché nulla in esse cambia quando il lavoro va bene o va male.

Poiché la conoscenza vive fuori da qualunque singolo agente, è portabile. Le stesse memorie, regole e skill arrivano a Claude Code, Codex, Cursor, GitHub Copilot e Windsurf tramite la CLI o l'estensione per VS Code, e a qualsiasi client MCP tramite l'MCP locale o il Remote MCP. Una funzione di memoria nativa all'interno di uno strumento non sostituisce tutto questo, perché quella memoria resta dentro quello strumento. Il valore duraturo è la conoscenza accumulata dal team, non una singola regola o un singolo file di prompt.