Revisione e lavoro in parallelo
Modifiche e revisione per rischio
Rivedere quello che gli agenti hanno cambiato: prima i file che contano, il perché guardarli, i commenti sulle righe da mandare all'agente, il diff affiancato e "Scarta".
Il chip N file nella barra del workspace (e in fondo a ogni pannello che lavora in un branch suo) apre Modifiche: tutti i file che git vede cambiati nella cartella, con il loro diff. È il posto dove rivedi il lavoro degli agenti prima di farne un commit.
Prima quello che conta
Con dieci file cambiati, non tutti meritano la stessa attenzione. Modifiche li divide in due:
- Da guardare, in cima: i file che pesano di più;
- Di routine, sotto e più piani: il resto.
Il peso lo danno regole che girano sul tuo computer, senza costi:
| Segnale | Esempi |
|---|---|
| Un'area critica del Brain | I percorsi che hai segnato come critici. |
| Database | Una migrazione, lo schema. |
| Test indeboliti | Asserzioni tolte, test saltati (skip, todo), un only dimenticato, un file di test eliminato. |
| Sicurezza e permessi | File .env, workflow di CI, CODEOWNERS, chiavi, impostazioni dei permessi. |
| Soldi e accessi | Nomi come prezzo, totale, IVA, pagamento, fattura, login, password, token, ruoli. |
| Dimensione | Un file eliminato, più di 300 righe cambiate. |
Sono di routine in ogni caso: un file solo rinominato, un cambio di soli spazi e a capo (tranne dove gli spazi contano, come Python o YAML), i lockfile, la documentazione.
Perché guardarlo
Sopra il diff di un file da guardare c'è una riga Perché guardarlo: subito quella delle regole, poi, in pochi secondi, una più precisa scritta da un modello piccolo (Haiku) che legge il diff e le note del Brain che c'entrano. Quando cita una nota del Brain, la riga è viola e il titolo apre la nota.
Il perché si scrive una volta per ogni versione di una modifica: riaprire Modifiche sullo stesso diff non costa niente.
Correggere il peso
Nella testa del diff:
- È di routine o Da guardare spostano il file: la tua scelta vince sulle regole, e la riga lo dice ("Segnato da te");
- Segna come area critica (con il Brain acceso) scrive il percorso fra le aree critiche del Brain: da lì quel file sarà sempre da guardare, qui e nel Debrief. Togli dalle aree critiche lo toglie.
Il diff
Ogni file si vede affiancato (prima e dopo) o unito, con i colori del codice e le righe aggiunte e tolte. In alto il conto delle righe +/−.
- Scarta butta le modifiche di un file e lo rimette com'era nell'ultimo commit. Te lo chiede prima, perché non si torna indietro.
- La freccia apre il file nel tuo editor.
Commentare le righe
Un clic sul numero di una riga apre un commento sotto quella riga; con Maiusc commenti un intervallo. Scrivi quello che vuoi cambiare, su quanti file e righe vuoi.
In fondo, Manda trasforma tutti i commenti in un messaggio solo per l'agente che scegli: con file, righe e codice citato, così sa esattamente dove mettere le mani. Se l'agente sta lavorando, il messaggio va in coda.
Nel Debrief
Anche il Debrief mostra in cima la fascia Da guardare prima, con i file più pesanti del lavoro che racconta (al più quattro) e il perché delle regole. Un clic apre quel file in Modifiche o nell'editor.
