Tutorial 23: Kanban — Multi-Agent Board | Easy Understand Hermes Agent

Questo fa parte della serie di tutorial ufficiali di Hermes Agent. Vedi tutti i tutorial

Immagina una lavagna bianca in un ufficio condiviso dove diversi colleghi possono appuntare post-it, spostarli e scrivere commenti — solo che i colleghi sono agenti AI, e la lavagna non viene mai cancellata. Questo è Hermes Kanban: una bacheca di attività persistente che permette a più agenti nominati di collaborare senza passaggi di consegne fragili o lavoro perso.

Passo 1: Capisci l’Idea Principale

Kanban è un database condiviso (un singolo file in ~/.hermes/kanban.db) che ogni profilo Hermes può leggere e scrivere. Ogni attività è una riga. Ogni passaggio di consegna è una riga. Ogni worker è un processo OS completo con la propria identità e memoria.

Differenza chiave rispetto a delegate_task:

delegate_task è come una telefonata — chiami, aspetti, riattacchi. Se fallisce, è perso.
Kanban è come una bacheca — pubblichi un’attività, ti allontani, e chiunque può raccoglierla in seguito. Se un worker va in crash, l’attività resta e un altro agente può riprenderla.

Passo 2: Conosci le Due Porte d’Ingresso

Entrambe le superfici usano lo stesso database, quindi non sono mai in disaccordo.

Porta 1 — Gli agenti usano gli strumenti.
Il modello AI parla con la bacheca tramite un set di strumenti dedicato: kanban_show, kanban_list, kanban_create, kanban_complete, kanban_block, kanban_comment e altri. Il dispatcher fornisce questi strumenti automaticamente a ogni worker.

Porta 2 — Tu usi la CLI.
Tu (o script, o cron job) usi hermes kanban … nel terminale, /kanban … come comando slash, oppure la dashboard.

Regola pratica: se dietro c’è un modello, usa gli strumenti. Se è un umano o automazione, usa la CLI.

Passo 3: Prova i Comandi di Base

Ecco come crei e gestisci un’attività dal terminale:

# Create a new task
hermes kanban create "Write blog post" --assign researcher-1

# List all tasks
hermes kanban list

# Show details of a task
hermes kanban show 42

# Mark a task as done
hermes kanban complete 42

# Block a task (waiting on something)
hermes kanban block 42 "Need more data"

# Unblock it later
hermes kanban unblock 42

# Add a comment
hermes kanban comment 42 "Draft is ready for review"

Ogni verbo CLI ha una chiamata strumento corrispondente che il modello usa internamente — stesso database, stesso risultato.

Passo 4: Scopri Cosa Kanban Può Fare Che `delegate_task` Non Può

Ecco i carichi di lavoro per cui questa bacheca è pensata:

Triage di ricerca — diversi ricercatori lavorano in parallelo, un analista revisiona, uno scrittore redige. Un umano può commentare e sbloccare in qualsiasi momento.
Operazioni programmate — un agente per il briefing giornaliero che costruisce un diario nel corso delle settimane.
Gemelli digitali — assistenti persistenti come inbox-triage che accumulano memoria nel tempo.
Pipeline di ingegneria — scomporre una grande funzionalità, implementare in worktree paralleli, revisionare, iterare, poi creare una PR.
Lavoro di flotta — uno specialista che gestisce 50 account social o 12 servizi monitorati.

Passo 5: Ricorda la Distinzione in Una Frase

delegate_task è una chiamata RPC fork-join; Kanban è una coda di messaggi persistente con una macchina a stati.
In parole povere: delegate_task è “chiedi e aspetta,” Kanban è “pubblica e lascia che il team lavori.”

Official Screenshots

Riepilogo

Kanban trasforma Hermes da un assistente a singolo agente in una forza lavoro multi-agente con una memoria condivisa e persistente. Le attività sopravvivono ai crash, gli umani possono intervenire in qualsiasi momento, e più agenti possono toccare la stessa attività nel corso della sua vita. È la differenza tra assumere un temporaneo e costruire un team.

Prossimo passo: Tutorial 24 — Obiettivi Persistenti: mantenere l’agente attivo finché il lavoro non è davvero finito.