plannotator mette un checkpoint umano davanti a ogni diff dell'agente

C'è un momento preciso, nello sviluppo assistito da agenti, in cui le cose peggiorano invece di migliorare. L'agente finisce un compito, stampa un riassunto e ti chiede di accettarlo. Scorri. Il diff è di quattrocento righe. Approvi, perché leggerlo davvero richiederebbe più tempo che scriverlo da solo.
plannotator, un progetto con circa 10.500 stelle che questa settimana sale in fretta, è un tentativo di sistemare quel momento. È una superficie di revisione locale, nel browser, che si aggancia a un agente di codice e si apre quando l'agente ha qualcosa da decidere. Annoti il piano, il documento o il diff, e i tuoi commenti tornano all'agente come input successivo.
Il claim parla di restare nel loop. L'architettura parla di qualcosa di più stretto e più utile: fare dell'attenzione umana un passaggio a sé invece di un'opzione.
Come si aggancia
Non sostituisce il tuo agente. Si innesta su uno. Il README elenca Claude Code, Codex, Copilot CLI, Gemini CLI, OpenCode, Kiro, Droid, Amp, DeepSeek Harness e Pi, e la Inbox funziona anche con assistenti personali come Grok Bot, Muse, Hermes e OpenClaw. La connessione passa per plugin, hook e comandi di ciascun harness, ed è per questo che la profondità dell'integrazione cambia da strumento a strumento.
I comandi hanno la forma nota:
/plannotator-review # uncommitted changes
/plannotator-review <github-pr-url> # a pull request
/plannotator-annotate README.md # a file
/plannotator-annotate https://docs.rs # a URL
/plannotator-last # the agent's last message
plannotator inbox # the queue
Su Codex i comandi slash diventano `!plannotator ...` oppure gli skills impacchettati. La modalità piano non richiede nessun comando: è cablata negli hook di ogni harness, quindi quando l'agente scrive un piano la superficie di revisione si apre da sola. Quel dettaglio conta più di quanto suoni. Un checkpoint che richiede di ricordarsi di invocarlo è un checkpoint che si salta nei giorni in cui sei occupato, e sono proprio i giorni in cui serve.
La revisione copre Git, GitButler, Jujutsu, Perforce, GitHub e GitLab, quindi la superficie non è legata a un solo forge. Commenti righe, proponi codice, e i commenti tornano all'agente invece di finire in un thread di PR che nessuno legge.
La inbox è la parte interessante
La revisione con un solo agente è un problema risolto con una soluzione noiosa: apri un diff, lasci commenti.
La Inbox è quello che il team ha costruito per la situazione in cui si trova davvero la maggior parte delle persone, cioè più agenti in esecuzione insieme. È una finestra locale dove gli agenti lasciano messaggi, domande, file e revisioni guidate mentre continuano a lavorare. Rispondi a una domanda con un clic, annoti un file, premi invio quando ci arrivi. Niente tiene aperta una sessione dell'agente mentre lo fai, e la tua risposta torna alla sessione che ha chiesto.
Quella singola frase risolve uno stallo reale. Il pattern standard dell'human-in-the-loop è che l'agente si ferma e aspetta. Con un agente va bene. Con quattro, sei tu il processo più lento del sistema, e tre di loro bruciano contesto mentre finisci di pranzare. Una inbox asincrona lascia all'agente la possibilità di parcheggiare la domanda invece della sessione.
Claude Code, Pi e OpenCode si collegano via plugin, quindi le risposte arrivano al turno successivo. Tutto il resto lo raggiunge via MCP con `plannotator inbox mcp`, e `plannotator inbox --help` funziona anche da documento che l'agente legge per imparare il protocollo. È un pezzo di design piccolo con un effetto grande: il testo di aiuto è la specifica di integrazione.
Perché un browser, e perché locale
Un diff nel terminale va bene per leggere codice e male per leggere qualsiasi altra cosa. Rivedere una specifica di prodotto, un mockup HTML o un report renderizzato dentro un pager è un esercizio di occhi socchiusi, e gli agenti ormai producono tutte e tre le cose con regolarità. Renderizzarle nel browser e lasciare che chi rivede metta delle puntine sull'output è la superficie giusta per quel tipo di artefatto.

La sezione sulla privacy del README è insolitamente concreta per uno strumento di questa dimensione, e vale la pena citarla nella sostanza invece di riassumerla. Non c'è telemetria. Piani, diff, annotazioni, bozze e cronologia restano in locale per impostazione predefinita. Ogni superficie controlla GitHub per l'ultima release al caricamento, e quel controllo non si può disattivare. La revisione Git locale può eseguire `git ls-remote` verso l'origin configurata per individuare il branch predefinito e una base non aggiornata, e quella query parte all'apertura della revisione, al caricamento del diff, al cambio di base e alla pressione di fetch. Una pagina di revisione inattiva non fa nessuna chiamata di rete, che è una promessa più forte di quella della maggior parte degli strumenti.
Il contenuto lascia la macchina solo quando una funzione di rete ne ha bisogno: l'annotazione di URL scarica la pagina, la revisione GitHub usa la tua CLI autenticata, Ask AI manda la domanda selezionata e il contesto al provider configurato, e la condivisione carica testo cifrato su un servizio di paste.
Per uno strumento che sta sopra il codice sorgente, questo livello di trasparenza è l'istinto giusto. Il modo tipico in cui il tooling per agenti si rompe è l'assistente premuroso che manda il tuo repository a un server senza dirlo, e l'unica difesa che ha l'utente è un maintainer che documenta i confini prima che glielo si chieda.
L'implicazione scomoda
Tutto in questo progetto è una scommessa sul fatto che il vincolo del lavoro con gli agenti sia la larghezza di banda di revisione umana, non la capacità del modello.
La scommessa mi pare corretta. Le persone che conosco e che fanno girare più agenti passano la giornata a leggere: piani, diff, output dei test, riassunti di quello che l'agente pensa di aver fatto. La parte di generazione è veloce e sta diventando più veloce. La parte di verifica è limitata dalla velocità con cui una persona legge e decide.
C'è un effetto di secondo ordine che vale la pena nominare. Una superficie di revisione che cattura le decisioni crea un registro delle stesse. plannotator ha un comando archive che sfoglia in sola lettura le decisioni di piano salvate, e le annotazioni restano nella directory dei dati, quindi le revisioni da terminale e quelle dall'app si accumulano nello stesso posto. Quando hai qualche centinaio di piani approvati con i commenti che li hanno plasmati, possiedi qualcosa che nessuna singola sessione contiene: una descrizione di come decide il tuo team.
Quello è l'asset. Il visualizzatore di diff lo può costruire chiunque. La traccia del ragionamento no.
Dove fa ancora male
Due cose, entrambe intrinseche.
La prima è che gli strumenti di revisione migliorano la revisione, e la revisione non è la stessa cosa della correttezza. Un'approvazione ben annotata di un'architettura sbagliata resta l'approvazione di un'architettura sbagliata, e una superficie ordinata fa sembrare approvare un gesto di diligenza. La Inbox in particolare rende facile svuotare una coda, e svuotare una coda è un comportamento diverso dal capirla.
La seconda è che lo strumento aggiunge un browser, un server locale e uno strato di hook a un flusso che prima era un terminale. Sono tre cose in più che si possono rompere, e quando si rompe un hook il guasto è silenzioso: l'agente prosegue senza il checkpoint, e tu lo scopri dopo.
Entrambi sono costi accettabili per quello che si compra, cioè un posto dove stare, per la persona. L'alternativa, che è quello che fanno quasi tutti i team oggi, è leggere un transcript di chat e sperare che le parti importanti ci siano dentro.
Se provi una cosa sola
Lancia `/plannotator-review` sulla tua prossima modifica non committata e commenta tre righe, anche se non hai niente da dire. I commenti sono accessori. Quello che impari è quanto dura una revisione vera quando la superficie è progettata per farlo, e quel numero è il tuo nuovo tetto di throughput. Quasi nessun team lo ha mai misurato.
Articoli correlati
Il consiglio si è costruito un comitato sull'export
In nove giorni il consiglio di Nvidia ha prodotto un'indagine, una presidenza e un comitato sull'export. Solo la trimestrale è finita in prima pagina.
Nvidia non ha mai costruito una seconda fila
Il problema di Nvidia non è lo scandalo, è la struttura: nessun presidente del consiglio fino alla settimana scorsa, nessun vice con mandato aziendale, nessuna successione.
Nvidia ha messo un prezzo al suo fondatore
In nove giorni Nvidia ha cambiato CEO e consiglio senza perdere un trimestre. Il mercato, intanto, ha dato un prezzo a quello che valeva un solo uomo.
Un foglio di calcolo comunitario di tocchi che spegne la pubblicità negli Android cinesi
Non tocca il sistema, non sblocca niente, non flasha niente. Ribalta solo gli interruttori che i produttori hanno già previsto. Il prezzo è una lista che qualcuno deve continuare a scrivere.