COME CHIUDO OGNI ONDATA DI LAVORO DEGLI AGENTI

Serve a chi fa scrivere codice agli agenti AI e vuole che resti pulito e corretto.
Alla fine sai quali due controlli passare, in che ordine e perché.


L'IDEA IN UNA RIGA

Gli agenti scrivono tanto e in fretta.
Prima di dire "fatto" passo due filtri, sempre nello stesso ordine.
Prima tolgo il superfluo, poi cerco gli errori.


COSA SERVE

Claude Code, con due comandi già inclusi:

/simplify

/code-review high


I PASSI

1. L'ondata di lavoro.
Gli agenti lavorano in parallelo, ognuno sui suoi file.
Ogni pezzo finito è un commit (un salvataggio con nome nella storia del progetto).

2. Primo filtro: /simplify.
Rilegge solo il codice appena cambiato e cerca quattro cose.
Pezzi che esistono già e vanno riusati.
Parti scritte in modo troppo complicato.
Lavoro inutile per la macchina.
Codice messo nel posto sbagliato.
Non cerca errori: cerca peso in più.
Regola mia: al massimo due passate.
E accetto solo le correzioni che tolgono o uniscono codice. Se una correzione aggiunge, la scarto.
Le correzioni vanno in un commit tutto loro.

3. Secondo filtro: /code-review high.
Adesso si cercano i bug (gli errori veri).
Cose che si rompono, casi dimenticati, regressioni (una cosa che prima funzionava e ora no).
"high" è il livello di impegno: va a fondo, ma senza riempirti di dubbi.
Ogni rilievo si corregge, oppure si scarta con il motivo scritto.
Anche queste correzioni vanno in un commit tutto loro.

4. Ultimo controllo: la CI (tutte le prove automatiche del progetto).
Si lanciano tutte, non solo quelle del pezzo toccato.
Se una è rossa, l'ondata non è chiusa.


PERCHÉ PROPRIO IN QUESTO ORDINE

Prima semplifico, così la review legge meno codice e guarda solo quello che conta.
La review viene dopo perché controlla anche le modifiche della semplificazione.
Se /simplify ha rotto qualcosa, la review lo prende.
La CI è l'ultima parola: non si fida né del primo né del secondo.


LA REGOLA DEI TAGLI

Si toglie qualcosa solo con una prova.
Valgono tre prove:
1. un doppione dimostrato, cioè la stessa logica in due posti (se ne tiene uno solo);
2. codice che nessuno chiama mai;
3. una funzione che nessuno ha chiesto.
Se c'è un dubbio, non si taglia: si annota.
Quando si toglie un test, si scrive quale altro test controlla la stessa cosa.


SE QUALCOSA NON VA

La review trova troppi rilievi: l'ondata era troppo grande, la prossima volta spezzala.
/simplify propone di aggiungere codice: scarta, non è il suo compito.
La CI è rossa dopo le correzioni: torna all'ultimo commit verde e rifai un pezzo alla volta.


Metodo spiegato per intero su marcomasut.com/risorse/orchestratore-claude-code-sessioni-in-parallelo