Suggerimenti e autoverifica

La conoscenza di un team invecchia. I percorsi vengono rinominati, le milestone vengono rilasciate, le versioni fissate delle dipendenze si spostano, una regola smette di corrispondere a qualsiasi cosa. La risposta di Pathrule è l'attività di aggiornamento: un segnale su una memoria o una regola che sembra obsoleta, con una motivazione in linguaggio semplice, che il tuo assistente sistema sotto il tuo controllo.

La proprietà fondamentale: un'attività di aggiornamento si limita sempre a suggerire. Pathrule non modifica né elimina mai di sua iniziativa le tue memorie, regole o skill.

Cosa controlla l'autoverifica

La verifica avviene là dove ci si accorge del disallineamento, cioè nel lavoro stesso. Un assistente che legge il tuo codice è il primo a notare che una memoria descrive un file che è stato spostato, o che una regola contraddice ciò che il codice fa adesso. Quando succede durante il suo normale lavoro, segnala la voce con lo strumento MCP pathrule_request_refresh, indicando la memoria o la regola e il motivo per cui sembra sbagliata. Motivi tipici:

• Disallineamento. La voce descrive uno stato che non corrisponde più al codice, per esempio un file citato è stato spostato o non esiste più.
• Contraddice il codice. La voce dice una cosa e il codice ne fa chiaramente un'altra.
• Duplicato. Un'altra memoria o regola copre già lo stesso argomento, e meglio.
• Troppo specifica. La voce si applica solo a un caso che non esiste più da tempo.
• Poco chiara. Non si riesce a capire che cosa chieda la voce.

La segnalazione è idempotente: segnalare due volte la stessa voce restituisce la stessa attività, così sessioni ripetute non accumulano duplicati. Gli assistenti hanno l'indicazione di segnalare solo i disallineamenti che hanno effettivamente notato, senza andarli a cercare.

Un'attività di aggiornamento non memorizza nulla del tuo codice sorgente. Indica la voce e riporta la motivazione; l'assistente che in seguito la sistema legge il codice attuale con i propri strumenti di accesso ai file.

Esaminare i suggerimenti

Un'attività di aggiornamento è uno spunto per prendere una decisione, non un'azione. Su un workspace Pathrule Cloud puoi gestirle dal terminale:

pathrule refresh list
pathrule refresh claim <refresh-id>
pathrule refresh resolve <refresh-id> --status applied

list mostra le attività in sospeso del workspace corrente, claim restituisce le istruzioni complete di un'attività e la contrassegna come in corso, e resolve la chiude come applied o rejected. Un assistente fa lo stesso tramite MCP con pathrule_list_pending_refreshes, pathrule_get_refresh_brief e pathrule_resolve_refresh.

Per ogni attività puoi lasciare che sia il tuo assistente ad applicare la correzione (vedi sotto), modificare tu stesso la voce oppure rifiutare l'attività se la voce è ancora corretta.

Correzione tramite il tuo assistente

Pathrule non corregge automaticamente la tua conoscenza. Chiedi al tuo assistente di occuparsi delle attività di aggiornamento in sospeso. A quel punto l'assistente:

1. Elenca le attività in sospeso e ne prende in carico una, contrassegnandola come in corso così che un'altra sessione non la prenda contemporaneamente.
2. Esamina il codice attuale e la voce segnalata con i propri strumenti di accesso ai file.
3. Prepara l'aggiornamento e lo salva tramite gli strumenti di scrittura di Pathrule. Passando l'id dell'attività insieme all'aggiornamento, l'attività viene chiusa come applicata.
4. In caso contrario, contrassegna esplicitamente l'attività come applicata o rifiutata.

Il controllo resta tuo a entrambe le estremità: la correzione passa dal tuo assistente e la modifica è una normale modifica versionata che puoi esaminare. Consulta il riferimento degli strumenti MCP per gli strumenti di aggiornamento usati dall'assistente.

Niente è irreversibile

Una correzione è una normale modifica versionata. Ogni modifica conserva la propria cronologia e, su un workspace Pathrule Cloud, una voce eliminata resta nell'archivio del workspace finché non viene eliminata definitivamente, e un owner o un admin può ripristinarla dalle impostazioni della console web. In VS Code, un'eliminazione offre subito Undo. Se una correzione si rivela sbagliata, puoi annullarla come qualsiasi altra modifica.