Tutorial Kanban — Collaborazione Multi-Agente

Immagina una cucina affollata dove ogni chef ha una specialità diversa. Se dovessi gridare le istruzioni una alla volta e aspettare che ogni piatto sia pronto prima di iniziarne un altro, il servizio crollerebbe. Hermes Kanban è la lavagna su quel muro di cucina — ogni attività, il suo stato e chi è bloccato su cosa è scritto lì, così che tutti possano vederlo a colpo d’occhio.

Cos’è Kanban?

Kanban è una bacheca attività condivisa che tutti gli agenti Hermes possono leggere e su cui possono scrivere. Ogni attività è un semplice record salvato in un unico file: ~/.hermes/kanban.db. Ogni agente è un lavoratore indipendente con la propria identità e memoria — non un collaboratore anonimo, ma un impiegato fisso che conosce le regole della casa.

Due Porte, Una Stanza

La bacheca ha due interfacce, ma puntano allo stesso database, quindi nulla va fuori sincrono:

Gli agenti usano gli strumenti — il modello legge e aggiorna le attività tramite strumenti kanban_* come kanban_show (visualizza attività), kanban_complete (completa attività) e kanban_block (segna come bloccata).
Tu usi il terminale — digita hermes kanban ... o usa i comandi slash /kanban ..., oppure apri la dashboard web.

# Crea un'attività
hermes kanban create "Ricerca prezzi concorrenza" --assign researcher-1

# Elenca tutte le attività
hermes kanban list

# Segna un'attività come completata
hermes kanban complete 42

In Cosa È Diverso da `delegate_task`?

delegate_task è come una telefonata: chiami una persona, aspetti la sua risposta, poi riattacchi. Kanban è come una chat di gruppo: pubblichi un messaggio, tutti lo vedono, chi è libero lo raccoglie e riferisce quando ha finito.

Aspetto	`delegate_task`	Kanban
Stile di lavoro	Sincrono — aspetta il risultato	Lancia e dimentica
Identità dell’agente	Collaboratore anonimo	Nominativo, con memoria
Gestione errori	Persa in caso di errore	Segnata come bloccata, riprovata dopo
Multi-agente	Uno alla volta	Più agenti in staffetta

A Cosa Serve Kanban?

La documentazione ufficiale evidenzia diversi modelli d’uso:

Pipeline di ricerca: più ricercatori cercano in parallelo → un analista riassume → uno scrittore redige
Attività programmate: genera automaticamente un briefing mattutino, accumulandolo in un registro a lungo termine
Gemelli digitali: assistenti persistenti come inbox-triage che imparano le tue preferenze nel tempo
Ingegneria: suddividi le attività → sviluppo parallelo → revisione del codice → merge

Prontuario dei Comandi Principali

# Aggiungi un commento (gli umani possono intervenire)
hermes kanban comment 42 "I dati sui prezzi vanno aggiornati all'ultima versione"

# Segna come bloccata (in attesa di input esterno)
hermes kanban block 42 "In attesa che il cliente confermi i requisiti"

# Sblocca
hermes kanban unblock 42

# Mostra i dettagli dell'attività
hermes kanban show 42

Consiglio da Pro: Lascia Intervenire gli Umani

La parte migliore di Kanban è che gli umani possono intervenire in qualsiasi momento. Quando un agente si blocca, segna l’attività come block. Tu la vedi, lasci un commento o la sblocchi direttamente. È come dire a uno chef “c’è altro pesce nel frigo” — lui riprende e continua.

Official Screenshots

Riepilogo

Kanban trasforma la collaborazione multi-agente da “telefonate” a “guardare la lavagna” — più flessibile, più affidabile, più trasparente. Ogni attività è registrata, ogni errore può essere ritentato e chiunque (umano o agente) può riprendere da dove un altro ha lasciato.

Prova questo: inizia in piccolo — crea due agenti (ad esempio researcher e writer). Fai sì che il ricercatore indaghi su un argomento e pubblichi i risultati sulla bacheca. Lo scrittore vede la nuova attività, la raccoglie e scrive l’articolo. Sentirai la magia della collaborazione tramite lavagna in pochi minuti.