Vai al contenuto
Pathrule

windsurf

Windsurf agisce.
Pathrule ricorda.

Regole condivise e contesto del team per Windsurf, tramite un file di regole che legge all'avvio della sessione e strumenti MCP che può chiamare per saperne di più. Windsurf non ha hook, quindi lì una regola vincolante arriva come indicazione.

Windsurfesempio
Aggiungi una pagina ordini.

Senza

Fatto. La pagina recupera /api/orders in un useEffect.

Usa fetch dove il team usa il client api.2 tentativi

Con Pathrule

file di regole, letto all'avvio della sessione: 3 note per features/orders

  • Usa il client api, non fetch
  • React Query per i dati
  • Pulsanti condivisi da ui/

Fatto. Gli ordini si caricano tramite il client api con React Query.

In linea con ciò che il team ha già deciso.1 tentativo

Come Pathrule raggiunge Windsurf.

file che legge: sìfile che legge
.windsurf/rules
prima di ogni prompt: noprima di ogni prompt
Nessun hook sul prompt
attorno alle chiamate agli strumenti: noattorno alle chiamate agli strumenti
Nessun hook
quando chiede: sìquando chiede
Locale

Nessun hook: Pathrule compila un file di regole che Windsurf legge, e l'agente raggiunge il resto tramite MCP.

Regole di Windsurf vs Pathrule

Solo le regole di Windsurfindicazioni native
  • Memorie di Cascade, regole con ambito e AGENTS.md
  • Le modifiche seguono i permessi del repository e la sua cronologia Git o delle pull request.
  • Il contesto dipende dai file e dalle indicazioni che il client carica.
  • Legato a Windsurf; gli altri strumenti hanno bisogno dei propri file.
  • L'onboarding segue la configurazione delle istruzioni del repository.
Pathrule + Windsurfper questo percorso
  • Conoscenza del workspace condivisa tramite un file di regole e MCP
  • Regole e skill revisionabili, con accesso al workspace controllato lato server e un'autoverifica.
  • Il costo in token cresce con la porzione pertinente, non con l'intero insieme di regole.
  • Gli stessi contenuti raggiungono Claude Code, Codex, Cursor e GitHub Copilot.
  • Onboarding = "entra nel workspace: le regole giuste compaiono sui percorsi giusti".

Approfondimento: Perché gli assistenti IA di programmazione hanno bisogno di regole con ambito.

Cosa aggiunge Pathrule a Windsurf

  • Contesto generatoAll'avvio della sessionePathrule scrive un file di regole che Windsurf legge all'avvio di una sessione. MCP fornisce letture più approfondite su richiesta.
  • Grafo legato ai percorsiRegole dove si applicanoLa conoscenza è associata ai percorsi, e gli strumenti MCP restituiscono ciò che si applica alla directory per cui Windsurf fa la richiesta. Il file di regole smette di essere un calderone.
  • Conoscenza del team revisionabileMemorie, regole, skillTre tipi di conoscenza, revisionabili in Local Console e VS Code, con scrittura condivisa in Cloud tramite CLI e MCP. Le regole obsolete emergono per essere ripulite, e le modifiche concorrenti generano un conflitto pulito invece di sovrascriversi.
  • Stessi contenuti, ogni agenteUn'unica fonte per ogni agenteClaude Code, Codex, Cursor e GitHub Copilot ricevono la stessa conoscenza legata ai percorsi, così la scelta dell'editor non frammenta ciò che il team sa.

Domande frequenti.

Cosa aggiunge Pathrule a Windsurf?

Un livello di conoscenza legato ai percorsi per Windsurf: un file di regole che legge all'avvio di una sessione e strumenti MCP che può chiamare per ottenere le memorie, le regole e le skill che si applicano alla directory in cui lavora. Windsurf non ha hook Pathrule, quindi la conoscenza non viene iniettata a sessione in corso e le regole sono indicazioni, non un blocco.

Pathrule sostituisce le mie regole di Windsurf?

No. Pathrule è un livello sopra il file di regole di Windsurf. Tieni il file di regole per le costanti valide per tutto il repository; Pathrule porta la conoscenza specifica di un percorso, quella che deve sopravvivere alla persona che l'ha appresa o quella che riguarda come preferisci che il lavoro venga fatto, e Windsurf legge la parte che si applica a dove sta lavorando.

Tutto il mio team può condividere le regole di Windsurf tramite Pathrule?

Sì. In un workspace Pathrule Cloud, regole e skill sono condivise in un grafo indicizzato per percorso con accesso al workspace controllato lato server, e il Windsurf di ogni collega può leggerle, così come Claude Code, Codex, Cursor e GitHub Copilot.

Come si installa Pathrule in Windsurf?

Esegui npm i -g @pathrule/cli, poi pathrule setup nel tuo progetto e scegli Windsurf (aggiungi --local per usarlo senza account). Il setup scrive .windsurf/rules/pathrule-protocol.md e una voce MCP locale. Per Windsurf non c'è alcun hook. Rimuovere il file di regole e la voce MCP rimuove Pathrule.

Pathrule vede il mio codice sorgente?

No. Pathrule non carica automaticamente il codice sorgente del tuo repository. In modalità locale non c'è alcun account e la conoscenza resta sulla tua macchina. In modalità cloud, Pathrule Cloud conserva le memorie, le regole e le skill che il tuo 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. Il dettaglio completo è nella pagina Sicurezza.

Una sola configurazione.
Poi ricorda.