Panoramica dei pattern

Un pattern è un pacchetto pronto all'uso di conoscenza di team per uno stack specifico o per uno specifico problema di sviluppo. Invece di partire da un workspace vuoto e scrivere a mano ogni memoria, regola e skill, aggiungi un pattern e il tuo assistente IA inizia il progetto conoscendo già le convenzioni di cui quello stack ha tipicamente bisogno e gli errori che vi si commettono più spesso.

Ogni pattern è un insieme degli stessi tre tipi di contenuto che Pathrule usa già, e ogni elemento arriva già legato al percorso a cui appartiene. Una regola sui server component finisce su /app, una memoria sulla fatturazione finisce sul servizio di billing, una skill di revisione finisce nella radice. Nulla viene riversato in un unico file globale.

Perché esistono i pattern

La maggior parte dei repository si pone le stesse domande iniziali. Come dovrebbe un progetto Next.js App Router suddividere i server component e i client component? Dove tieni le regole di row-level security di Supabase? Qual è il modo sicuro di gestire un webhook di Stripe? Perché una query veloce in sviluppo va in deadlock in produzione? Le risposte sono ben note, ma ogni team le riscopre e le riscrive da capo.

I pattern raccolgono quelle risposte una volta sola, come contenuto Pathrule legato ai percorsi, così un nuovo workspace può adottarle in pochi secondi:

• Già legati ai percorsi, non incollati. Un pattern non è un blocco di prompt. Ogni elemento dichiara il percorso in cui risiede, quindi il tuo assistente lo vede solo dove è pertinente. Una modifica alla UI non deve mai leggere una regola sul database.
• Tipizzati, non a testo libero. Un pattern è composto da memorie, regole e skill, gli stessi tipi che scrivi tu. Una regola importata mantiene il suo tipo di ambito e la sua priorità; una skill importata si può invocare per nome.
• Composti in base all'argomento. Il mix di regole, memorie e skill cambia da pattern a pattern. Un pattern di framework punta sulle regole per le sue convenzioni rigide, un pattern di workflow punta sulle skill da eseguire come checklist.
• Tuoi dopo l'importazione. Importare un pattern è un'inizializzazione una tantum, non un abbonamento attivo. Gli elementi diventano normale contenuto del tuo workspace e li modifichi come qualsiasi altra cosa.

Il catalogo

Il catalogo pubblico si trova su pathrule.io/patterns. Contiene 150 pattern, tutti first-party e pubblicati con licenza Apache-2.0, organizzati in otto categorie:

• Framework per i framework applicativi e di piattaforma, da Next.js App Router, Nuxt, SvelteKit, Astro e React Router fino a Django, Rails, Laravel, Spring Boot, ASP.NET Core, SwiftUI, Flutter, Expo e Unity.
• Frontend per componenti, form, stato, stili, accessibilità, Core Web Vitals, hydration, internazionalizzazione e comportamento offline.
• Backend per accesso ai dati, ORM, code, ricerca, API, autenticazione, multi-tenancy e prestazioni del database.
• Billing per pagamenti, abbonamenti, fatturazione e imposte, checkout, payout, rimborsi e contestazioni.
• Infra per container, runtime serverless, CI/CD, infrastructure as code, osservabilità, caching, DNS e TLS.
• Workflow per code review, debugging, aggiornamento delle dipendenze, workflow Git, release, incidenti e onboarding.
• AI per agenti in produzione, memoria degli agenti, valutazioni, osservabilità, guardrail, fine-tuning e verifica del codice generato dall'IA.
• Security per account takeover e MFA, credenziali di servizio, rate limiting, crittografia, autorizzazione, SSO aziendale e privilegio minimo.

La pagina del catalogo ha una barra laterale con le categorie e una casella di ricerca. Ogni pattern ha una propria pagina che mostra:

• un riepilogo dei contenuti, cioè quante regole, memorie e skill contiene, ricavato dal pacchetto stesso
• una mappa di tutti i percorsi di destinazione e l'elenco completo degli elementi raggruppati per percorso
• il motivo per cui il pattern esiste: il problema che risolve, a chi è destinato e gli errori che evita al tuo assistente
• il token da usare per aggiungerlo, con un pulsante di copia, e una copia manuale dell'intero pacchetto
• la licenza, la versione e la data dell'ultimo aggiornamento, con un link al sorgente

Ogni pattern è disponibile anche in Markdown semplice su /patterns/<slug>/raw (il link "View as markdown" nella pagina), così un assistente IA può leggere l'intero pacchetto direttamente da un link condiviso.

Come si inserisce un pattern nel resto di Pathrule

Un pattern non introduce un nuovo concetto a runtime. È un formato di pacchettizzazione sopra il modello che già conosci:

• Gli elementi sono memorie, regole e skill.
• Il percorso di ogni elemento segue la stessa regola di ambito del percorso del contenuto che scrivi tu.
• Una volta importati, gli elementi emergono tramite gli stessi hook e lo stesso recupero just-in-time del resto del tuo workspace.

L'idea è tutta qui: un pattern è un vantaggio di partenza curato, espresso esattamente nella forma che il tuo assistente legge già.

Cosa leggere dopo

• Anatomia di un pattern analizza il modello di contenuto: elementi, percorsi, versionamento e il pacchetto open source dietro il catalogo.
• Importare un pattern tratta il token, l'anteprima e la rimozione successiva di un pacchetto.
• Concetti fondamentali spiega memorie, regole e skill se il modello è nuovo per te.