PathruleIl livello di contesto
per programmare con l'IA.
Un livello di contesto indicizza per percorso le memorie, le regole e le skill di un team e consegna agli agenti che il team usa solo la parte che si applica, prima della prima chiamata a uno strumento. Ecco i cinque modi in cui i team lo fanno, e come capire quale fa al caso tuo.
Senza un livello di contesto
- L'assistente apre il modulo degli ordini, legge lo schema, segue gli import fino a prezzi e tasse e legge il gestore degli sconti per dedurre dove si applica un coupon.
- Scrive una modifica plausibile che applica lo sconto al totale dell'ordine. Il diff compila. È sbagliato proprio nel modo che il team conosce già.
- Un revisore se ne accorge, spiega di nuovo la convenzione sulla riga d'ordine e il ciclo si ripete. La conoscenza resta nella testa di una persona.
- Molti file letti, molte chiamate agli strumenti, una lunga finestra di input e una strada sbagliata che costa un ciclo di revisione.
Con un livello di contesto
- La porzione corrispondente al percorso degli ordini arriva tramite l'hook, prima di qualsiasi chiamata a uno strumento. Il modello sa già che i coupon stanno sulla riga d'ordine.
- Applica lo sconto alla riga d'ordine al primo tentativo, perché la regola era nel contesto prima che iniziasse.
- Una regola vincolante può bloccare, prima che arrivi nel codice, una modifica che mette lo sconto nel posto sbagliato, così la correzione avviene prima della revisione, non dopo.
- Una finestra di contesto breve e mirata e una modifica precisa, perché sono state iniettate solo le regole di questo percorso.
Cinque modi per dare contesto a un agente.
- File di istruzioni
- sceglilo quando
- Una persona, un repository, poche convenzioni
- la conoscenza arriva
- A ogni turno, tutta intera
- sopravvive a un cambio di strumento
- No, ogni strumento legge il proprio file
- si rompe
- Alla seconda persona o al secondo agente: ogni strumento vuole la sua copia.
- API di memoria
- sceglilo quando
- Stai integrando la memoria nel tuo prodotto
- la conoscenza arriva
- Quando qualcosa la interroga
- sopravvive a un cambio di strumento
- Sì, se controlli tu il punto di chiamata
- si rompe
- Silenzioso per progettazione. Un vincolo su cui nessuno ha chiesto non arriva mai.
- Ricerca vettoriale
- sceglilo quando
- La risposta è scritta, ma non si sa dove
- la conoscenza arriva
- Quando qualcosa la interroga
- sopravvive a un cambio di strumento
- Sì, anche se l'indice devi gestirlo tu
- si rompe
- Non può restituire una decisione che non si trova in nessun file.
- Workspace per agenti
- sceglilo quando
- Il collo di bottiglia sono gli agenti in parallelo
- la conoscenza arriva
- Per sessione, non per percorso
- sopravvive a un cambio di strumento
- Non è questo il punto: è lo strumento stesso
- si rompe
- Un secondo checkout non decide quale conoscenza va dove.
- Livello legato ai percorsi
- sceglilo quando
- Una persona con più motori, o un team su un repository
- la conoscenza arriva
- Prima di qualsiasi chiamata a uno strumento, in base al percorso
- sopravvive a un cambio di strumento
- Sì, la conoscenza vive fuori da ogni strumento
- si rompe
- Eccessivo per una sola persona che usa un solo agente.
Due di questi non sono concorrenti. Un'API di memoria dentro il tuo prodotto e un livello di contesto per i tuoi agenti possono valere entrambi allo stesso tempo.
Quando non ti serve.
Una persona, un repository, un agente e convenzioni che stanno in una pagina: un CLAUDE.md versionato è la risposta giusta e un livello di contesto è un costo in più. Il punto di rottura non sono le dimensioni del repository, e nemmeno quelle del team. È il secondo agente o la seconda persona, a seconda di cosa arriva prima. Un singolo sviluppatore che usa Claude Code e Codex sullo stesso repository ha già il problema: ciò che insegni a uno dei due, l'altro non lo sa, e ciascuno legge un file diverso.
Cosa trasporta un livello di contesto
- MemorieCiò che il team ha imparatoI fatti del tipo "l'abbiamo già provato, non ha funzionato" che spariscono quando lo sviluppatore che li ha imparati se ne va. Associati al percorso in cui si applicano. Altro: memoria persistente per agenti IA di programmazione.
- RegoleCosa fare o evitareRegole consultive e vincolanti. I guardrail rigidi (niente
console.login/apps/web) e le preferenze morbide (preferisci gli export con nome in/packages/ui). Altro: regole per agenti IA di programmazione. - SkillPlaybook in più passaggiProcedure che il team ha messo a punto: come aggiungere una migrazione, come rilasciare un feature flag, come eseguire la revisione di sicurezza. Richiamabili per nome. Altro: skill per agenti IA di programmazione.
- Indicizzata per percorsoLa conoscenza vive vicino al suo lavoroOgni memoria, regola e skill è associata a un percorso. Una regola per
/services/billingnon si attiva mai quando il modello lavora in/apps/mobile.
File singolo vs livello di contesto
- I file di istruzioni nativi possono essere legati a un percorso e condivisi tramite il controllo di versione.
- Il costo in token cresce linearmente con le regole del team.
- Un assistente per file. Cambiare strumento fa perdere conoscenza al team.
- Modificabile da chiunque abbia accesso in push. Nessuna revisione strutturata.
- Conoscenza tramandata a voce, come memoria tribale.
- La porzione legata al percorso della directory in cui lavora il modello.
- Il costo in token cresce con la porzione pertinente, non con l'intero insieme di regole.
- Un livello, molti assistenti. Cambiare strumento non azzera il team.
- Grafo di conoscenza revisionabile, con accesso al workspace controllato lato server e un rilevatore di regole obsolete.
- Conoscenza scritta una volta, consegnata automaticamente alla sessione del prossimo collega.
Assistenti IA di programmazione supportati
Claude CodeCLAUDE.md, hook incluso quello sul prompt, MCP
CodexAGENTS.md, hook incluso quello sul prompt, MCP
Cursor.cursor/rules, hook di sessione e sugli strumenti, MCP
GitHub CopilotFile di istruzioni, hook di sessione e sugli strumenti, MCP
WindsurfFile di regole e MCP, nessun hook- Qualsiasi client MCPMemoria tramite MCP
Domande frequenti.
Che cos'è un livello di contesto per la programmazione con l'IA?
Il livello di instradamento tra la conoscenza tipizzata di un team (memorie, regole e skill) e gli assistenti IA di programmazione che il team usa. Indicizza quella conoscenza per percorso e consegna al modello, tramite gli hook, solo la porzione pertinente, prima di qualsiasi chiamata a uno strumento.
In cosa un livello di contesto è diverso da CLAUDE.md o AGENTS.md?
CLAUDE.md e AGENTS.md sono file piatti che inviano ogni istruzione a ogni turno. Un livello di contesto sta un gradino sopra: conserva la conoscenza in un grafo indicizzato per percorso e instrada verso il modello solo il sottoalbero corrispondente, così ogni istruzione che il modello vede è essenziale per il percorso corrente.
Un livello di contesto è uno strumento IA di programmazione?
No. Un livello di contesto non genera codice, non esegue inferenza e non sostituisce il tuo IDE. È il livello tra il tuo team e qualunque assistente IA di programmazione tu scelga, e rende ogni sessione più intelligente senza vincolare il team a un unico strumento.
Cosa trasporta un livello di contesto?
Tre tipi di conoscenza tipizzata del team: memorie (ciò che il team ha imparato), regole (cosa fare o evitare) e skill (playbook in più passaggi). Non trasporta il tuo codice sorgente né un indice del tuo repository.
Come implementa Pathrule il livello di contesto per la programmazione con l'IA?
Pathrule conserva la conoscenza del team in un grafo indicizzato per percorso, espone un unico server MCP e raggiunge ogni agente nel modo che consente: hook, compreso quello sul prompt, per Claude Code e Codex, hook di sessione e sugli strumenti per Cursor e GitHub Copilot e un file di regole per Windsurf. Al modello viene consegnata solo la porzione che corrisponde alla directory di lavoro corrente.
Un livello di contesto vede il codice sorgente?
Non ne ha bisogno. Pathrule non carica automaticamente il codice sorgente del tuo repository. In modalità cloud, Pathrule Cloud conserva le memorie, le regole e le skill che il team scrive, l'inizio di ogni prompt viene inviato per classificare ciò che si applica e pathrule snapshot, quando lo esegui tu o il tuo agente, carica l'albero dei file, i manifest, brevi estratti della documentazione e i metadati git recenti. In modalità locale non c'è alcun account. Il dettaglio completo è nella pagina Sicurezza.
Quale strumento di contesto dovrei scegliere?
Dipende da quale problema hai davvero. A una persona che usa un agente su un repository basta un CLAUDE.md versionato. Per la memoria dentro il tuo prodotto c'è un'API di memoria. Per la conoscenza scritta ma difficile da trovare, la ricerca vettoriale. Per agenti in parallelo in checkout isolati, un workspace per agenti. Un livello di contesto legato ai percorsi serve dal momento in cui entra in scena un secondo motore o una seconda persona, che per la maggior parte delle persone è il secondo motore. I cinque approcci, e dove ciascuno smette di funzionare, sono descritti sopra.
Che differenza c'è tra un livello di contesto e un'API di memoria?
Il momento della consegna. Un'API di memoria risponde quando viene interrogata, quindi un vincolo su cui l'agente non ha mai pensato di chiedere non arriva mai. Un livello di contesto legge il percorso in cui l'agente sta per lavorare e consegna la conoscenza corrispondente prima di qualsiasi chiamata a uno strumento, che l'agente l'avrebbe chiesta o no.
La RAG vettoriale è un livello di contesto?
No. Il recupero vettoriale trova testo già scritto, ordinato per somiglianza con una query. Un livello di contesto trasporta decisioni che non stanno in nessun file, indicizzate per il percorso che regolano, e può farle rispettare: una regola ha un ambito, una priorità e un livello di applicazione, mentre un archivio restituisce testo. La somiglianza è un'ipotesi sulla pertinenza; un percorso è un fatto. Approfondimento: RAG vettoriale vs contesto legato ai percorsi.
Mi serve un livello di contesto se lavoro da solo?
Il punto non è davvero lavorare da solo. È quanti agenti usi. Una persona con un agente e una pagina di convenzioni è esattamente il caso in cui un file di istruzioni funziona bene. Una persona che usa Claude Code, Codex e Cursor sullo stesso repository ha già il problema che un livello di contesto risolve: ciò che insegni a uno di loro resta lì dentro, e ciascuno legge un file diverso. Per questo Pathrule è gratuito per uso individuale.