Visibilità della Flotta

Principio operativo nella gestione di una Flotta di Agenti secondo cui, una volta che gli agenti sono autonomi e le pipeline validano il risultato, far eseguire il lavoro non è più la parte difficile: vedere cosa sta facendo la flotta lo è, poiché un manager non può delegare, sbloccare o revisionare ciò che non vede. ¹

L'agente di approvazione in GitHub Actions

Sul piano dell'esecuzione e della verifica (vedi anche Cerimonia Proporzionata al Rischio), il processo scala fino a produrre 18 pull request aperte in poche ore mentre l'umano è assente. ¹ Ogni pull request attraversa lo stesso flusso: i bot e gli agenti di review esaminano il codice, i workflow validano le build e i test, e infine interviene un agente di approvazione (approval agent) in esecuzione in GitHub Actions. ¹

Il compito dell'agente di approvazione è confermare che tutti i check siano verdi e che ogni rilievo (finding) sollevato dai reviewer sia stato risolto: solo a quel punto appone l'approvazione, lasciando una pull request completa di tutti i controlli e delle approvazioni necessarie, in attesa unicamente che qualcuno decida se farla entrare. ¹

La visibilità come collo di bottiglia: da tab separate a un'unica vista

A rompersi, crescendo di scala, non sono gli agenti né l'hardware, ma la visibilità. ¹ Finché un singolo team lavora su una sola macchina, aprire Agent Deck nel terminale mostra chiaramente chi sta lavorando, chi ha finito e chi aspetta; ma quando la flotta si divide tra un team sul mini PC, uno sul server InMotion Cloud e alcuni agenti sul laptop, ogni istanza conosce solo se stessa. ¹

Ogni macchina diventa una tab separata nel terminale e l'umano finisce a rimbalzare da una tab all'altra sperando di non essersi perso l'agente che aspettava una risposta da un'ora: un assetto che crolla già dopo un paio di macchine, perché più la flotta cresce, meno se ne riesce a vedere. ¹ Come un manager con team distribuiti in più uffici ha bisogno di un solo posto da cui vederli tutti e raggiungere subito chi richiede attenzione, così l'autore ha costruito la versione desktop di Agent Deck: il terminale resta il posto giusto per lavorare in profondità con un singolo agente, ma per rispondere alla domanda "cosa sta succedendo all'intera flotta?" serve un'unica app che riunisca i 45 agenti su tutte e tre le macchine (12 in esecuzione: gli agenti di investigazione sul laptop, 7 attivi e 19 in attesa sul mini PC, 5 attivi e 11 in attesa sul server InMotion Cloud). ¹

In attesa (waiting) vs in attesa di input (waiting for input)

Nella vista unificata è essenziale distinguere perché un agente non sta eseguendo codice: ¹

• In attesa (waiting): non significa che l'agente sia bloccato (stuck), ma che ha portato a termine il proprio lavoro ed è in attesa che il manager revisioni quanto fatto. ¹
• In attesa di input (waiting for input): identifica in modo distinto un agente che si è fermato perché ha una domanda per l'umano e ha bisogno di una risposta per proseguire. ¹

In entrambi i casi gli agenti richiedono l'intervento del manager, e la vista centrale è il punto in cui lo si scopre senza dover ispezionare ogni macchina a mano. ¹

Principio di non invasività: sessione reale, mai wrapper

La scelta di design fondamentale per ottenere visibilità senza perdere efficacia operativa è la non invasività: quando dalla vista centrale si apre un agente per lavorarci, nel terminale si apre la sessione reale dell'agente, la stessa che si avrebbe collegandosi via SSH attraverso il daemon di Agent Deck su quella macchina, senza che l'app metta una propria interfaccia in mezzo tra l'utente e l'agente. ¹ Slash command, skill, hook e key binding funzionano esattamente come sempre. ¹

L'autore evita deliberatamente i tool che avvolgono (wrap) gli agenti nella propria UI: Claude Code, Codex, OpenCode e gli altri rilasciano miglioramenti ogni settimana, ogni giorno o più volte al giorno, per cui il wrapper è sempre un passo indietro. ¹ Agli agenti manca solo la panoramica complessiva su tutte le macchine, mentre la conversazione è ciò che sanno già fare meglio di chiunque altro; l'app centrale deve quindi limitarsi a portare l'utente alla sessione reale e togliersi di mezzo ("se pensi di poter fare meglio, costruisci un agente migliore; non costruire un wrapper attorno a quello di qualcun altro"). ¹

L'ordine dei colli di bottiglia: dopo la visibilità, l'umano stesso

Ripercorrendo l'evoluzione della flotta, i colli di bottiglia emergono in un ordine preciso: ¹

1. La visibilità (primo collo di bottiglia): superata la sfiducia iniziale grazie a istruzioni migliori e alla pipeline, e distribuito il lavoro su più macchine tramite i dispatcher, il problema cessa di essere gli agenti e diventa vedere cosa fanno. ¹
2. Il manager umano (secondo collo di bottiglia): una volta ottenuta la visibilità sull'intera flotta, il collo di bottiglia successivo diventa l'autore stesso (vedi Siamo Tutti Manager Adesso). ¹ Quando una o due settimane di lavoro vengono compresse in poche ore di pull request, inizia il lavoro vero: tutte quelle PR vanno mergiate; anche con molta automazione, il merge di una pull request crea conflitti nelle altre e risolvere quei conflitti invalida le approvazioni, innescando un ciclo continuo (mentre mergiare e rilasciare istantaneamente ogni PR appena è pronta comporta altre complicazioni). ¹ Per non bloccare tutto, l'autore non rilegge più ogni riga di ogni PR — cosa che definisce folle, visto che altri agenti l'hanno già fatto — ma concentra l'attenzione sulle parti che contano e che gli utenti vedono, soprattutto UX e documentazione (sul perché la review umana e il ciclo di feedback restino comunque indispensabili per preservare l'apprendimento e la comprensione del sistema, vedi Slice Sottili e Ciclo di Feedback). ¹
3. L'isolamento tra macchine (terzo limite): i team su macchine diverse non comunicano tra loro e i dispatcher sono isolati, costringendo il manager a ripartire manualmente gli issue nei prompt finché non sarà implementato il passaggio di lavoro diretto tra macchine. ¹

Vedi anche: Agent Deck, Flotta di Agenti, Cerimonia Proporzionata al Rischio, Siamo Tutti Manager Adesso

Fonti e Riferimenti