Introduzione

Pathrule è il livello di intelligenza per i tuoi agenti di programmazione.

Conserva ciò che un progetto, uno sviluppatore e un team hanno imparato, lega questa conoscenza ai percorsi del codice e consegna ciò che serve a ogni attività all'agente di programmazione che usi già. Project Intelligence contiene il funzionamento di una codebase: le decisioni, i vincoli, i requisiti di verifica, le correzioni e le procedure che un repository accumula attorno al proprio codice. User Intelligence contiene il tuo modo di lavorare preferito, salvato sulla tua macchina. Team Intelligence, su Pathrule Cloud, analizza le evidenze del team e le trasforma in pattern che arrivano agli agenti solo dopo la verifica di una persona.

Pathrule non è un modello di programmazione, un IDE o un runtime per agenti. Claude Code, Codex, Cursor, GitHub Copilot, Windsurf e gli altri client compatibili con MCP restano i motori di esecuzione, ciascuno con il proprio fornitore di modelli. Pathrule è il punto da cui partono, ed è per questo che cambiare agente non azzera ciò che si sa del lavoro.

Per avere tutta l'architettura in un unico posto, leggi la panoramica dell'architettura.

Cosa scrivi tu e cosa ne ricava Pathrule

Ci sono tre tipi di contenuto che il tuo team scrive intenzionalmente. Sono input e costituiscono la superficie di scrittura: sono ciò che una persona modifica e discute, non ciò che un agente riceve.

• Memoria: una breve nota in Markdown che registra una decisione, un'insidia dello schema, un postmortem o una convenzione. È associata a un percorso del workspace, così emerge solo quando si lavora lì vicino.
• Regola: un vincolo che l'assistente deve rispettare quando lavora in un certo ambito. Le regole hanno una priorità (alta, media, bassa) che stabilisce con quanta forza emergono. Una regola viaggia come contesto; una regola il cui vincolo eseguibile è stato approvato da una persona può anche bloccare una modifica corrispondente nei client i cui hook lo supportano.
• Skill: una procedura con un nome che l'assistente può richiamare invece di ricostruire i passaggi da capo. È utile per lavori ricorrenti come rieseguire un webhook, rigenerare una fixture o seguire una checklist di rilascio.

Cosa Pathrule non fa: analizzare o caricare automaticamente il tuo codice sorgente. Ciò che legge da una copia di lavoro è circoscritto e dichiarato. In un workspace Cloud, la prima volta che un agente chiede un contesto approfondito, il runtime locale legge i percorsi dei file dalla cronologia git recente per capire quali file cambiano insieme, e i nomi dei file vicini alla radice dell'albero delle cartelle per riconoscere le tecnologie in uso. Le coppie di percorsi di file e alcune brevi memorie sulle tecnologie vengono salvate nel workspace, senza chiedere conferma; contenuti, diff e messaggi di commit non vengono letti a questo scopo. In modalità Cloud l'inizio di ogni prompt viene inviato per dare priorità alla conoscenza, e pathrule snapshot, quando lo esegui tu o il tuo agente, carica una panoramica del progetto. Cosa calcola Pathrule elenca con precisione cosa viene letto e cosa viene conservato.

Ciò che un agente riceve è più ristretto di questi documenti. Per una determinata attività, Pathrule seleziona le voci che si applicano al percorso e alla richiesta, assegna loro una priorità e le fa rientrare in un budget per prompt; ciò che non ci sta viene elencato per titolo, così l'agente può recuperarlo deliberatamente. Una regola arriva come requisito e una correzione memorizzata arriva come consiglio, invece che come due paragrafi di pari peso. Agent IR descrive il contenuto del pacchetto consegnato.

E cosa ne deriva

Quei tre tipi di contenuto sono ciò che scrive il tuo team. Rappresentano la metà più piccola di ciò che il livello contiene.

Attorno a essi c'è un livello derivato che nessuno scrive a mano. Ogni voce esiste anche come rappresentazione calcolata del proprio significato, ed è così che un prompt in turco trova una memoria in inglese con cui non ha nessuna parola in comune. Ogni consegna viene misurata: quali voci sono state inviate, quali l'assistente ha effettivamente consultato, quante chiamate a strumenti ha richiesto il turno e quante sono fallite. Queste misurazioni si accumulano e formano un quadro di ciò che aiuta per ogni tipo di lavoro, un grafo dei file che il tuo team modifica insieme, una mappa dei punti in cui un assistente continua a bloccarsi e valutazioni su quali voci il codice ha ormai superato.

Tutto questo nasce da ciò che il tuo team ha messo per iscritto e da ciò che il lavoro ha riportato su se stesso, oltre, in un workspace Cloud, ai percorsi dei file presi dalla cronologia git recente, che indicano quali file cambiano insieme prima ancora che il tuo team abbia registrato molto lavoro. Niente di tutto ciò deriva dalla lettura del contenuto dei tuoi file. È anche il motivo per cui gli stessi tre file lasciati in una directory non si comportano allo stesso modo: una directory non sa cosa è stato consegnato, cosa è servito o quali file si muovono insieme. Vedi cosa calcola Pathrule.

Un'unica intelligenza, ogni punto di accesso

La stessa conoscenza è raggiungibile da ogni superficie:

• CLI: installazione, configurazione Cloud o Local, collegamento dei tuoi agenti di programmazione, lettura e aggiunta di conoscenza dal terminale, scripting e automazione.
• Estensione per VS Code: consulta e modifica la conoscenza accanto ai tuoi file, registra MCP per la modalità agente di GitHub Copilot e collega altri client.
• Server MCP locale: strumenti per il workspace per ogni client supportato, installati con la CLI o con l'estensione per VS Code.
• Remote MCP: un endpoint MCP ospitato per i client che si collegano tramite Streamable HTTP con il tuo account Pathrule.
• Pathrule Cloud: account, organizzazioni, workspace, persistenza e cronologia gestite, Team Intelligence, Remote MCP e fatturazione.
• Self-hosted per le aziende: Pathrule Cloud nel tuo account Cloudflare, tramite il team vendite.

L'indipendenza dall'agente non significa che ogni agente venga raggiunto allo stesso modo. Claude Code e Codex hanno hook che consegnano il contesto quando viene inviato un prompt. Cursor e GitHub Copilot hanno hook di sessione e di strumento. Windsurf non ha hook e funziona con un file di regole più MCP. La panoramica di MCP riporta i dettagli per ogni client.

Com'è una sessione

1. Il tuo team scrive una memoria in un percorso del workspace, per esempio /apps/api/payments.
2. Apri Claude Code in ~/repos/main/apps/api/payments.
3. Quando invii un prompt, l'hook di Pathrule legge la porzione in cache per quel percorso e la passa all'agente prima della sua prima chiamata a uno strumento.
4. L'assistente vede la memoria, le regole pertinenti e le eventuali skill associate a quell'ambito, e si comporta come se le conoscesse già.

Non c'è nessun prompt aggiuntivo da scrivere, nessun giro in più verso MCP a metà attività e nessun file globale che cresce all'infinito. I client senza un hook sul prompt ricevono la conoscenza tramite i propri file di istruzioni, tramite hook di sessione e di strumento dove disponibili, oppure tramite MCP, come descritto nella rispettiva guida.

Cosa leggere dopo

• Panoramica dell'architettura presenta l'intero sistema in una pagina e il vocabolario su cui si basa il resto di questa documentazione.
• Guida rapida ti accompagna nell'installazione della CLI, nel collegamento di un workspace, nella scrittura della tua prima memoria e nell'osservare l'hook in azione.
• Concetti fondamentali spiega la differenza tra memorie, regole e skill, oltre a come funzionano l'ambito per percorso e la priorità.
• Pathrule per VS Code spiega come lavorare con la conoscenza nell'editor.
• Panoramica di MCP descrive gli strumenti MCP che l'assistente usa per leggere e scrivere contenuti.