PathruleConoscenza condivisa e conflitti
Come Pathrule mantiene sincronizzata la conoscenza del team su un workspace Cloud, rileva le modifiche sovrapposte al salvataggio e ti permette di risolvere un conflitto senza perdere lavoro.
In questa pagina
Pathrule è un livello di conoscenza condiviso, quindi prima o poi due persone modificheranno la stessa memoria, regola o skill nello stesso momento. Le scritture su Cloud sono condivise, le sovrapposizioni vengono controllate al salvataggio e sei tu a decidere come risolverle.
Leggere lo stato corrente
Una memoria, una regola o una skill scritta in un workspace Cloud entra a far parte di quel workspace condiviso. L'attuale backend Cloud non offre una sottoscrizione in tempo reale che invii ogni modifica dei colleghi in una vista già aperta.
Per leggere lo stato corrente aggiorna la vista della conoscenza oppure fai una nuova richiesta di conoscenza. Gli hook locali e i file di istruzioni usano la conoscenza del workspace già preparata; esegui pathrule sync per aggiornare quei file e gli indici. Non dare per scontato che una sessione già preparata abbia ricevuto l'ultima modifica di un collega.
Un workspace locale risiede su una sola macchina. Le altre persone non ricevono le sue modifiche finché non copi la conoscenza in un workspace Cloud condiviso.
Rilevamento delle sovrapposizioni al salvataggio
Pathrule non blocca un elemento mentre qualcuno lo tiene aperto. Un blocco fermerebbe il team per modifiche che in realtà non entrano mai in conflitto. Ogni salvataggio porta invece con sé un token di versione (lo stesso token descritto in Scrivere memorie) e la sovrapposizione viene rilevata solo quando due salvataggi partono dalla stessa versione iniziale.
| Situazione | Cosa succede |
|---|---|
| Salvi e la tua versione di partenza è ancora quella corrente | Il salvataggio avviene normalmente |
| Salvi, ma nel frattempo un collega ha salvato una versione più recente | Si verifica un conflitto, da risolvere con le opzioni descritte sotto. La tua versione non viene salvata finché non scegli |
Poiché il controllo riguarda il singolo elemento, i colleghi che modificano memorie diverse non si bloccano mai a vicenda.
Risolvere un conflitto
In Pathrule per VS Code, una memoria, una regola o una skill è una scheda Markdown. Quando un salvataggio incontra un conflitto, VS Code ti avvisa che il contenuto è stato modificato da remoto e che la tua versione non è stata salvata, e ti propone tre opzioni:
| Opzione | Cosa fa |
|---|---|
| Reload | Carica la versione corrente e scarta le tue modifiche non salvate. |
| Copy My Version & Reload | Copia prima il tuo testo negli appunti, poi carica la versione corrente, così puoi riapplicare ciò che intendevi. |
| Keep Mine (Overwrite) | Salva la tua versione al posto di quella corrente. Questo scarta la modifica dell'altra persona, per cui è una scelta esplicita. |
Nulla viene sovrascritto finché non ne scegli una. Tramite MCP, un assistente può passare la versione che ha letto per ultima; in caso di mancata corrispondenza riceve la versione corrente, la rilegge e integra la propria modifica invece di sovrascrivere.
Cronologia delle modifiche
Ogni modifica a una memoria, una regola o una skill viene versionata e registrata.
- Ogni modifica conserva chi l'ha fatta, quando e se proviene da una persona o da un client IA.
- In VS Code, l'azione Info mostra la versione di un elemento, chi l'ha creato, chi l'ha modificato per ultimo e la sua origine.
La cronologia serve a dare visibilità. Ti dice come un elemento è arrivato allo stato attuale, che è la stessa domanda a cui aiuta a rispondere un'attività di aggiornamento quando la conoscenza inizia a disallinearsi.
Cosa leggere dopo
- Scrivere memorie per capire come funziona il token di versione su un singolo elemento.
- Suggerimenti e autoverifica per capire come viene segnalata la conoscenza obsoleta o in conflitto.
- Panoramica di MCP per capire come i client IA esterni leggono il contesto sincronizzato.