Importare un pattern

Puoi adottare qualsiasi pattern in due modi. Puoi incollarne il token in un qualunque assistente IA collegato, lasciando che sia Pathrule a scrivere gli elementi sui percorsi giusti, oppure copiare il bundle a mano dal catalogo.

Il token di riferimento

Ogni pattern ha un token di riferimento nella forma:

::pathrule:package:<slug>

Per esempio, il pattern per Next.js App Router è ::pathrule:package:nextjs-app-router. Il token compare in ogni pagina del catalogo, pronto da copiare.

Il prefisso ::pathrule: è un namespace riservato. Viene riconosciuto prima del percorso di invocazione ::skill-name, quindi un token di pattern non viene mai scambiato per una skill e non avvia mai la ricerca delle skill. Questa separazione vale sia nell'hook del prompt sia nella richiesta di contesto.

Incolla il token come testo semplice. Come per l'invocazione di una skill, un token tra backtick o dentro un blocco di codice viene considerato codice citato e ignorato. Puoi inserire più token in un unico prompt; ogni pattern viene preso in carico una sola volta.

Importare tramite token

Per aggiungere un pattern, incollane il token in un prompt all'interno di un workspace collegato. Da lì al resto pensa Pathrule:

1. Riconosce il token. Quando Pathrule costruisce il contesto per il tuo prompt, rileva il marcatore ::pathrule:package:<slug> e propone una direttiva di importazione per quello slug.
2. Mostra un'anteprima prima di scrivere. Un dry run risolve il pattern e ne restituisce la versione, il problema che risolve, gli elementi e i percorsi che intende usare, senza ancora modificare nulla. L'anteprima riporta anche i percorsi, gli stack e le dipendenze dichiarati dal pattern, così l'assistente può confrontarlo con il tuo progetto reale.
3. Sceglie percorsi adatti alla tua struttura. Un pattern dichiara dei percorsi suggeriti, ma i repository reali sono diversi tra loro. L'assistente sceglie una base coerente con la tua organizzazione e vi riposiziona i percorsi del pattern, in modo che gli elementi finiscano dove devono davvero stare. In un monorepo, le regole /app di un pattern Next.js possono finire sotto /apps/web/app.
4. Chiede conferma in caso di mancata corrispondenza. Se il pattern è pensato per uno stack che il tuo progetto non sembra usare, per esempio un pattern React Native in un progetto senza Expo, l'assistente si ferma e ti chiede se e dove aggiungerlo, invece di importarlo alla cieca.
5. Scrive il bundle. Dopo la conferma, ogni elemento viene creato attraverso il normale percorso di scrittura: una memoria diventa una memoria, una regola diventa una regola con il suo tipo di ambito e la sua priorità, e una skill diventa una skill invocabile, contrassegnata con il pattern da cui proviene. I nodi mancanti lungo ciascun percorso vengono creati quando servono.

L'assistente riporta poi un riepilogo di una riga, per esempio quante regole, memorie e skill sono state importate, quante erano già presenti e quante non sono andate a buon fine.

Dopo l'importazione, gli elementi sono normale contenuto del workspace. Emergono attraverso gli stessi hook e lo stesso recupero di qualsiasi cosa tu abbia scritto, e li modifichi allo stesso modo. Una regola importata arriva come consultiva: viene inclusa come contesto e non blocca una modifica a meno che una persona non approvi per essa un vincolo eseguibile (vedi Le regole come guardrail).

L'importazione scrive a tuo nome. Ogni elemento passa per lo stesso controllo di accesso di qualsiasi altra scrittura, quindi in un team ti serve l'accesso in scrittura al workspace di destinazione: un Viewer non può importare. Vedi Ruoli e permessi.

Importare tramite copia manuale

Non ti serve il token per usare un pattern. Ogni pagina del catalogo ha un'azione "Manual copy (full bundle)" che copia l'intero bundle come Markdown semplice, con ogni elemento etichettato per tipo e percorso di destinazione, e ogni regola etichettata con il suo ambito e la sua priorità. Incollalo nel tuo assistente, o nei tuoi appunti, e ricrea gli elementi dove preferisci. Funziona senza alcuna configurazione e senza account.

Ogni pattern è disponibile anche come Markdown grezzo su /patterns/<slug>/raw, comodo quando vuoi che un assistente legga l'intero bundle partendo da un link.

Un punto di partenza, non un abbonamento

Importare un pattern è un'operazione una tantum che fornisce un punto di partenza. Da quel momento la copia nel tuo workspace è tua; non resta collegata al catalogo e non cambierà a tua insaputa. Pathrule non registra quale versione hai importato e non ti avvisa quando ne viene pubblicata una più recente, quindi nessuna sincronizzazione andrà mai a sovrascrivere contenuti che hai già adattato.

Per capire se un pattern è cambiato da quando l'hai importato, confronta la versione e la data di aggiornamento nella sua pagina del catalogo, e leggi il suo changelog nel pacchetto open source. Una nuova importazione non porta le modifiche, perché ogni elemento il cui titolo è già presente viene saltato. Per adottare una versione più recente, rimuovi il bundle e importalo di nuovo, sapendo che così sostituisci le modifiche che hai fatto agli elementi importati. Se ti interessa un solo elemento migliorato, copialo a mano dalla pagina del catalogo.

Reimportare e rimuovere

• Una nuova importazione non crea mai duplicati. Ripetendo la stessa importazione, ogni elemento il cui titolo è già presente viene saltato, e viene riportato cosa è stato aggiunto e cosa c'era già. Una memoria si considera presente quando nel suo percorso esiste una memoria con lo stesso titolo; una regola o una skill si considera presente quando ne esiste una con lo stesso nome in qualunque punto del workspace. Gli elementi saltati restano esattamente come sono, modifiche comprese. Un elemento che hai rinominato dopo l'importazione non viene più riconosciuto, quindi una nuova importazione lo aggiunge di nuovo.
• La rimozione avviene in un solo passaggio. La definizione di un pattern è il suo stesso manifesto di titoli e percorsi, quindi puoi chiedere al tuo assistente di rimuovere il pattern e una sola chiamata annulla l'intero bundle. Se hai importato sotto un percorso di base, indica la stessa base quando rimuovi; gli elementi che non si trovano lì vengono segnalati come non trovati, non trattati come errori.

Cosa tocca la rimozione

La rimozione trova ogni elemento in base al suo titolo nel suo percorso, non ricordando cosa ha creato l'importazione. Questo ha tre conseguenze che conviene conoscere prima di eseguirla:

• Vengono rimossi anche gli elementi modificati. Una memoria, una regola o una skill importata che hai modificato in seguito viene rimossa insieme alle tue modifiche, purché titolo e percorso siano invariati.
• Viene rimosso anche un tuo elemento con lo stesso titolo. Se hai scritto tu una memoria, una regola o una skill con lo stesso titolo di uno degli elementi del pattern, nello stesso percorso, la rimozione elimina anche quella. I titoli vengono confrontati senza distinguere tra maiuscole e minuscole.
• Gli elementi rinominati o spostati restano. Rinominare un elemento o spostarlo in un altro percorso lo mette fuori dalla portata della rimozione: è così che puoi tenere un elemento e rimuovere il resto.

Gli elementi rimossi vengono archiviati, non cancellati. In un workspace Cloud restano nell'archivio del workspace finché non vengono eliminati definitivamente, e un owner o un admin può ripristinarli dalle impostazioni della console web, in Workspace, Archive.

Dove funziona

L'importazione e la rimozione tramite token usano gli strumenti MCP locali via stdio, anche quando quel runtime è collegato a un workspace Cloud. Remote MCP non espone questi strumenti di supporto. Un client remoto può leggere il bundle grezzo e creare le voci che sceglie con gli strumenti di conoscenza a sua disposizione.

L'importazione si comporta allo stesso modo in Claude Code, Codex, Cursor, Windsurf e GitHub Copilot collegati tramite Pathrule CLI o l'estensione per VS Code. Importazione e rimozione funzionano allo stesso modo in un workspace locale e in un workspace Pathrule Cloud. In Claude Code e Codex l'hook del prompt individua il token prima che l'agente agisca. Cursor, GitHub Copilot e Windsurf non hanno un hook del prompt, quindi lì l'assistente apprende lo stesso flusso di importazione e rimozione dalla richiesta di contesto e dalle indicazioni sul protocollo presenti nei suoi file di istruzioni.

Cosa leggere dopo

• Panoramica dei pattern per il quadro generale.
• Anatomia di un pattern per scoprire cosa contiene un bundle e come funziona il versionamento.
• Come funzionano gli hook per capire come vengono forniti gli elementi importati una volta entrati nel tuo workspace.