Hermes Kanban: il centro di controllo per i tuoi agenti AI

Ecco la traduzione in italiano del testo fornito, seguendo tutte le linee guida specificate.

Una guida completa a Hermes Kanban: il modello di coordinamento, la condivisione del contesto tra agenti e la creazione di un team software di 4 agenti (PM, backend, frontend, tester) in circa 20 minuti.

Gli agenti AI avrebbero dovuto funzionare come una squadra.

Tu descrivi l'obiettivo. Loro dividono il lavoro. Ognuno riprende da dove l'altro ha lasciato.

Questa è la premessa. Quello che accade in realtà è l'opposto. Gli agenti iniziano con una tabula rasa. Un agente non sa cosa hanno costruito gli altri, quali file sono stati modificati o che aspetto ha l'API. Ogni passaggio è un avvio a freddo e il lavoro si degrada nel momento in cui passa da un agente all'altro.

Hermes Kanban risolve questo problema. Ogni attività sopravvive a crash e riavvii. Ogni briefing contiene esattamente ciò di cui il prossimo agente ha bisogno. Ogni fallimento viene salvato, così il tentativo successivo sa cosa si è rotto.

Ecco come appare la tua sala di controllo:

Dashboard Kanban

La parte migliore è che l'intero team funziona dal tuo telefono. Crei e gestisci le attività tramite Telegram, e gli agenti le raccolgono mentre sei lontano dalla scrivania.

Guarda qui:

In questo articolo costruiamo questa configurazione completa da zero: il modello di coordinamento, i briefing e un team software di 4 membri che funziona sul tuo hardware in circa 20 minuti.

Per dimostrarlo, ho creato un clone funzionante di Google Docs, completo di funzionalità AI e backend pronto per la produzione, costruito proprio da questo team di agenti.

Demo del clone di Google Docs

Quindi, senza ulteriori indugi, iniziamo.

Perché un singolo agente non basta

Supponiamo, ad esempio, che tu voglia aggiungere la funzionalità di reimpostazione della password. Il lavoro si divide in tre ambiti:

• Uno sviluppatore backend che costruisce l'API REST
• Uno sviluppatore frontend che legge quell'API e costruisce l'interfaccia utente
• Un tester che verifica l'intero flusso end-to-end

1 vs 3 Agenti

Puoi eseguire tutti e tre tramite un singolo agente, ma la finestra di contesto si riempie e l'agente perde traccia di ciò che ha fatto tre passaggi prima. Passi più tempo a gestirlo di quanto te ne faccia risparmiare.

Dividere il lavoro tra agenti che possiedono ciascuno un dominio crea un problema diverso: come fa lo sviluppatore frontend a sapere cosa ha costruito lo sviluppatore backend? Questo problema di contesto condiviso è ciò che Hermes Kanban risolve.

Il modello mentale: una bacheca delle attività, ma con agenti dietro le colonne

Un'attività ha un titolo, una descrizione, un responsabile e uno stato. Qualcuno la prende in carico, la sposta attraverso la bacheca e la chiude. La bacheca è l'unica fonte di verità.

Hermes Kanban mantiene quel modello e mette gli agenti dietro ogni colonna invece degli umani.

Bacheca Hermes Kanban

Ogni attività è una riga che sopravvive a crash e riavvii. Quando un agente finisce, scrive un riepilogo: file modificati, cosa ha costruito, cosa deve sapere il prossimo agente. L'agente successivo legge quel riepilogo prima di iniziare.

Quel riepilogo è l'intuizione fondamentale. È ciò che trasforma un gruppo di agenti in una squadra, invece che in estranei.

Il vocabolario

Abbiamo 6 diverse colonne sulla bacheca Kanban:

• Triage: Le idee grezze finiscono qui, utile per "Voglio limitazione del rate per l'autenticazione" prima di avere una specifica completa.
• Da fare: Attività creata ma in attesa di una dipendenza. Non si sposterà finché la sua attività padre non sarà completata.
• Pronto: Dipendenze soddisfatte, in attesa che un agente la prenda in carico.
• In Corso: Un agente è attivamente al lavoro.
• Bloccato: L'agente ha incontrato un ostacolo e lo ha segnalato a un umano. Niente viene eseguito finché non lo sblocchi.
• Completato: Finito, con cronologia completa dell'esecuzione, riepilogo e metadati preservati.

L'orchestratore: un agente che gestisce gli altri

Pensa all'agente orchestratore come al project manager che legge un obiettivo di alto livello, controlla quali agenti esistono, suddivide l'obiettivo in attività collegate e si fa da parte. Non scrive mai codice né esegue test. Coordina.

L'agente orchestratore

L'unica regola che conta: controlla quali profili esistono prima di creare le attività. Il sistema salta silenziosamente qualsiasi attività il cui assegnatario non corrisponde a un profilo reale, quindi il passo zero è sempre kanban_list.

Ecco un tipico turno del project manager, che scompone una richiesta "costruisci un flusso di reimpostazione password" in una pipeline collegata:

1kanban_show()
2
3be = kanban_create(title="Backend reimpostazione password", assignee="backend-developer",
4    body="Flusso password dimenticata/reimpostata + invalidazione sessione")
5
6fe = kanban_create(title="UI reimpostazione password", assignee="frontend-developer",
7    parents=[be], body="Flusso di reimpostazione Next.js usando l'API backend")
8
9qa = kanban_create(title="Test E2E reimpostazione password", assignee="tester",
10    parents=[fe], body="Convalida tutti i criteri di accettazione")
11
12kanban_complete(summary="Creata pipeline di dipendenza backend → frontend → QA")

Dopo questo, la bacheca gestisce la promozione e i briefing gestiscono il contesto. Quando tutti e tre finiscono, il project manager si risveglia, legge i riepiloghi e giudica se il lavoro è completato. Se il tester restituisce "verdict": "FAIL", crea attività di correzione e il ciclo continua.

Ma in realtà, non devi preoccuparti di nulla. Devi solo delegare un'attività da Telegram e l'orchestratore se ne occupa.

Tre schemi che userai costantemente

1. La pipeline: Ogni attività dipende dalla precedente. Solo la prima parte in stato "Pronto". Tutte le altre aspettano il loro turno.

1BACKEND=$(hermes kanban create "Implementa API autenticazione" \
2    --assignee backend-developer \
3    --body "POST /register, POST /login, POST /refresh, POST /logout." \
4    --json | jq -r .id)
5
6FRONTEND=$(hermes kanban create "Costruisci UI autenticazione" \
7    --assignee frontend-developer \
8    --parent $BACKEND \
9    --body "Leggi il passaggio di consegne backend per la forma dell'API. Pagine di login, registrazione, profilo." \
10    --json | jq -r .id)
11
12hermes kanban create "Testa il flusso di autenticazione end-to-end" \
13    --assignee tester \
14    --parent $FRONTEND \
15    --body "Copri percorso felice, password errata, token scaduto, persistenza sessione."

Non lo esegui a mano. Descrivi il progetto al project manager su Telegram e lui crea queste attività per te. Sotto il cofano, assomiglia a quanto sopra.

Quando l'agente backend chiama kanban_complete(), l'attività frontend passa a "Pronto" con il lavoro del backend allegato.

2. Umano nel ciclo: Non tutti i blocchi sono un fallimento. A volte un agente trova un problema reale e si ferma per chiedere.

1kanban_block(reason="revisione-richiesta: controllo forza password mancante, "
2           "i token di reimpostazione non sono monouso (possono essere riutilizzati entro 30 min)")

Vedi il blocco sulla dashboard. Verifichi il problema, lo risolvi e sblocchi l'attività:

1hermes kanban unblock $IMPL

Non lo esegui nemmeno nel terminale; basta commentare nella bacheca Kanban o inviare un messaggio su Telegram, e il sistema lo sblocca.

Il sistema riavvia l'agente al ciclo successivo. La seconda esecuzione chiama kanban_show() e vede esattamente perché il primo tentativo è stato bloccato. Sa precisamente cosa risolvere; non ricomincia da capo.

3. Specificatore di triage.

Quando hai un'idea approssimativa invece di una specifica completa, inseriscila nella bacheca e lascia che il sistema la sviluppi prima che un agente la prenda in carico.

1# Inserisci un'idea approssimativa
2hermes kanban create "auth necessita limitazione rate" --triage --assignee backend-developer
3
4# Sviluppala prima che il dispatcher la prenda in carico
5hermes kanban specify $TASK_ID

Il comando specify riscrive il titolo di tre parole in un'attività completa con un obiettivo, un approccio e criteri di accettazione. L'agente che la prende in carico riceve un vero briefing.

Configurazione: quattro profili in circa 20 minuti

Quattro agenti, una bacheca condivisa, il project manager raggiungibile su Telegram.

Passo 1: Crea i profili.

1hermes profile create project-manager --clone
2hermes profile create backend-developer --clone
3hermes profile create frontend-developer --clone
4hermes profile create tester --clone

--clone copia la configurazione del tuo profilo predefinito come punto di partenza.

Passo 2: Dai a ogni agente una personalità

1. Project Manager in ~/.hermes/profiles/project-manager/SOUL.md:

1# Soul
2
3Sei il project manager di un team di sviluppo software. Il tuo compito
4è prendere l'idea di un'app dell'utente, suddividerla in attività chiare,
5assegnarle ai membri del team giusti e monitorare i progressi sulla bacheca Kanban.
6Non scrivi codice tu stesso. Gestisci il lavoro.

2. Backend Developer in ~/.hermes/profiles/backend-developer/SOUL.md:

1# Soul
2
3Sei lo sviluppatore backend di un team software. Costruisci e gestisci
4l'intero backend usando InsForge — database, autenticazione, storage, funzioni
5edge e distribuzione.

3. Frontend Developer in ~/.hermes/profiles/frontend-developer/SOUL.md:

1# Soul
2
3Sei lo sviluppatore frontend di un team software. Costruisci l'interfaccia utente —
4componenti, pagine e flussi utente — e li colleghi al backend
5usando le API e i metodi SDK che lo sviluppatore backend ha configurato.

4. Tester in ~/.hermes/profiles/tester/SOUL.md:

1# Soul
2
3Sei il tester di un team software. Testi le funzionalità completate
4end-to-end, verifichi che i criteri di accettazione siano soddisfatti e segnali
5i bug chiaramente sulla bacheca Kanban in modo che possano essere risolti.

Passo 3: Aggiungi le competenze degli agenti

Le competenze sono guide passo-passo, istruzioni specifiche su come eseguire determinati tipi di lavoro. Pensale come formazione professionale per i tuoi agenti. Elenchiamole una per una:

InsForge

InsForge (open-source, Apache 2.0) funge da livello di ingegneria del contesto backend per gli agenti che utilizzano Skills e CLI. Il nostro profilo agente backend-developer usa questa competenza per avere un servizio backend pronto all'uso per i progetti.

Prima, aggiungi il tap delle competenze InsForge:

1hermes skills tap add InsForge/insforge-skills

Poi installa le competenze backend:

1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force

Allo stesso modo installiamo altre come insforge-cli (comandi infrastruttura), insforge-debug (diagnostica errori) e insforge-integrations (provider di autenticazione di terze parti).

Ecco come l'agente backend-developer usa la competenza per costruire il backend del nostro progetto su InsForge.

Prima l'agente backend-developer crea un progetto chiamato "Google Docs Clone" in InsForge.

La dashboard mostra le statistiche del progetto come il numero di utenti, le tabelle nel database, lo storage e l'elenco delle funzioni edge con codice JavaScript/TypeScript distribuito relativo ad autenticazione, gestione documenti, ecc.

Quindi, se stai costruendo un ingegnere backend AI, dai un'occhiata a InsForge →

(non dimenticare di mettere una stella 🌟)

Altre competenze dallo Skills Hub

Hermes mantiene anche uno Skills Hub con 687 competenze in 18 categorie: 87 integrate, 79 opzionali, 16 da Anthropic (frontend-design, pdf, pptx, docx, mcp-builder e altro) e 505 da LobeHub.

Per lo sviluppatore frontend, installa frontend-design. Per il tester, installa webapp-testing. Entrambi sono inclusi nello Hub.

Passo 4: Inizializza la bacheca e avvia il gateway.

hermes kanban init crea ~/.hermes/kanban.db, il database SQLite che contiene ogni attività, contesto e cronologia delle esecuzioni.

Poi configura il gateway di chat sotto il profilo project-manager. Ottieni un token bot da @BotFather su Telegram e il tuo ID utente da @userinfobot, poi:

1hermes kanban init
2hermes -p project-manager gateway setup
3hermes -p project-manager gateway start

La connessione funziona 24 ore su 24, 7 giorni su 7, mantiene il sistema attivo e rende il project manager raggiungibile su Telegram.

Passo 5: Invia il tuo primo progetto.

Invia un messaggio al project manager con ciò che vuoi che venga costruito. Suddivide l'obiettivo in attività, le crea con collegamenti di dipendenza e il sistema le esegue in ordine.

La dashboard

Esegui hermes dashboard e apri http://127.0.0.1:9119. Ottieni una colonna per stato e aggiornamenti in tempo reale tramite WebSocket senza bisogno di ricaricare.

0:20

Dashboard Hermes Kanban

Due controlli meritano di essere conosciuti. Corsie per profilo raggruppa la colonna "In Corso" per assegnatario, così puoi vedere a colpo d'occhio quale agente possiede cosa. Sollecita dispatcher esegue un passaggio immediatamente invece di aspettare 60 secondi, utile subito dopo aver sbloccato un'attività.

Clicca su qualsiasi carta per aprire il suo cassetto con la cronologia completa dell'esecuzione, il risultato e i metadati di ogni tentativo, e campi modificabili per titolo, assegnatario, priorità e dipendenze.

Cosa tenere d'occhio

Tre modalità di fallimento da conoscere prima di un carico di lavoro serio.

1. Sovraccarico del database. Con 2-4 agenti in parallelo non lo incontrerai mai. Con 10+ agenti che scrivono ad alta frequenza, le cose rallentano. Limitarlo con hermes kanban dispatch --max 4.

2. Cancellazione dell'area di lavoro scratch. I file salvati in un'area di lavoro scratch vengono eliminati nel momento in cui l'attività viene contrassegnata come completata, perché lo scratch viene cancellato per progettazione. Usa worktree per le attività di codifica o inserisci il percorso della cartella del progetto nella descrizione dell'attività in modo che l'agente sappia dove salvare.

3. Saturazione del modello locale. Contro un modello locale (Ollama, GPU locale), il sistema può lanciare diversi agenti contemporaneamente e sovraccaricare la GPU, rallentando la generazione e attivando l'arresto automatico. Per configurazioni locali, usa hermes kanban dispatch --max 2. Per modelli basati su API come Claude o GPT-4o, questo è raramente un problema.

Il quadro completo

Ogni componente ha un compito:

• SOUL.md è l'identità fissa dell'agente: chi è e come pensa.
• Skills sono le istruzioni passo-passo per tipi specifici di lavoro.
• Memory è ciò che l'agente sa del tuo ambiente tra una sessione e l'altra.
• Kanban è il livello di coordinamento: stato condiviso, trasferimento di contesto e un umano nel ciclo in qualsiasi momento.

Quattro profili, quattro file SOUL.md, un avvio del gateway. Descrivi ciò che vuoi che venga costruito al project manager su Telegram e guarda la bacheca riempirsi.

Se impari meglio dai video, una guida completa a Hermes Kanban sarà pubblicata su YouTube e X tra un paio di giorni.

Grazie per la lettura.