Workflow Multi-Agente : Handoff : Feedback Loop

Agent Teams.
Una vera squadra tech, scriptata.

AgentsRoom Teams concatena i tuoi agenti IA di coding come una vera squadra di sviluppo. Un Fullstack Dev rilascia la feature, un QA Engineer la valida, un PM la approva. Ogni ruolo e scriptato, il workflow e visuale e ogni handoff trasporta il riassunto della feature, il diff, i rischi e gli hint di test. Niente piu un singolo agente che fa tutto male.

Costruisci il tuo team di sviluppo IA ideale su un canvas visuale, come un workflow n8n. Collegamenti condizionali, cicli di feedback, rami di revisione paralleli, quality gate verificati dalla macchina, tetto max-cycles. Salvalo una volta, lancialo su ogni ticket e guarda i tuoi agenti passarsi il testimone come dei senior.

AgentsRoom Teams: editor visuale di workflow multi-agente, handoff automatico tra agenti Claude Code, feedback loop Dev verso QA, comunicazione inter-agente basata su MCP.

Agent Teams e la risposta di AgentsRoom a una verita brutale sugli agenti IA di coding: un singolo agente che cerca di fare tutto finisce per fare tutto male. L'agente Fullstack che codifica, testa, fa la review, deploya e scrive la spec contemporaneamente dimentica meta delle istruzioni a meta strada. La risposta giusta, quella usata da ogni squadra software seria al mondo, e dividere il lavoro per ruoli. Uno sviluppatore codifica. Un QA engineer valida. Un product manager approva. Un security reviewer fa l'audit. Ogni ruolo ha il suo contesto, il suo focus, i suoi tool.

E esattamente cio che Agent Teams porta in AgentsRoom. Trascini nodi su un canvas infinito (costruito su React Flow, lo stesso engine di n8n, Make, Retool e Pipedream), ogni nodo e un agente che gira su Claude, Codex, GitHub Copilot CLI, Cursor o una qualsiasi delle altre 10 CLI di agenti supportate da AgentsRoom, assegnato a un ruolo specifico, e li colleghi tra loro. Esegui il team su un ticket dal tuo backlog, oppure collegalo a qualsiasi nuovo agente. AgentsRoom orchestra la catena: avvia il primo agente, attende l'handoff, riassume il lavoro, avvia l'agente successivo con quel riassunto come contesto in entrata, ripete fino a quando il team raggiunge il nodo finale.

Altri tool cercano di farlo con un singolo super-agente e prompt astuti. Lo abbiamo provato, non funziona oltre tre step. I ruoli vanno alla deriva, il contesto si perde, l'agente dimentica cosa doveva verificare. Agent Teams tratta gli agenti come veri compagni di squadra: ognuno ottiene una sessione pulita, un system prompt focalizzato, un payload di handoff strutturato e uno scratchpad condiviso per parlare con gli altri. Questo e il workflow di squadra IA di sviluppo che vuoi davvero.

Editor visuale di workflow AgentsRoom Agent Teams: nodi per ruoli Dev, QA, PM, Security e DevOps connessi su un canvas infinito con edge condizionali e feedback loops

Editor AgentsRoom Teams: trascina nodi per ogni ruolo, collegali, aggiungi condizioni, salva il team, eseguilo su qualsiasi ticket.

Orchestrazione multi-agente che scala davvero

Ogni nodo sul canvas e un agente. Scegli il suo ruolo (Fullstack, Frontend, Backend, QA, Security, DevOps, PM, Architect, Mobile, Marketing, Git, SEO, Localization o qualsiasi ruolo custom che hai creato), il suo modello (Opus, Sonnet, Haiku, GPT-5, o3, Antigravity Pro, ecc.), la sua modalita di handoff (auto via Stop hook, o manuale via pulsante) e qualche riga di istruzioni specifiche per lo step. Tutto qui. Niente cerimonia di prompt engineering, niente file YAML da scrivere.

Gli edge collegano i nodi. Un edge semplice significa: quando il primo agente finisce il suo step, passa al successivo. Un edge condizionale porta un check di flag, ad esempio qaPassed equals true. L'agente QA imposta quel flag nel suo payload di handoff, il runner sceglie l'edge corrispondente. Cosi costruisci feedback loops: il QA finisce, qaPassed equals false, l'edge rimanda al Dev con gli hint di test e i rischi. Il Dev corregge, fa di nuovo l'handoff. Loop fino a quando il QA passa o finche scatta il max-cycles guard.

La comunicazione inter-agente e robusta by design. AgentsRoom include un MCP server dedicato (agentsroom-team) che fornisce a ogni agente del run un set di tool: leggere il contesto del team, leggere lo scratchpad NOTES.md condiviso, postare una nota per i compagni, mandare una domanda a un altro ruolo, leggere l'inbox, leggere la timeline, leggere il git diff rispetto alla baseline del run, e completare lo step con un payload strutturato. Questi tool vengono re-iniettati nella sessione Claude a ogni turno, quindi sopravvivono alla compaction del contesto. Anche dopo un /compact o un /clear, l'agente vede ancora i suoi tool del team.

In piu, un hook UserPromptSubmit ricorda all'agente eventuali nuove note dei compagni prima di ogni messaggio dell'utente. Un file NOTES.md nel workspace e append-only e sopravvive a crash, restart e reboot della macchina. Uno schema di payload di handoff validato lato server impedisce agli agenti di fare handoff con payload vuoti o spazzatura. Questa e la parte che la maggior parte delle demo multi-agente salta in silenzio, ed e il motivo per cui la maggior parte di esse cade a pezzi al ciclo 3.

Tutto quello che ti serve per gestire una squadra IA di sviluppo

Workflow visuale, handoff vero, feedback loops veri, comunicazione inter-agente vera. Costruito per spedire una feature in un ping Slack invece di cinquanta.

Canvas visuale di workflow

Canvas infinito zoomabile basato su React Flow, lo stesso engine dietro n8n, Retool, Pipedream e Make. Trascina nodi, collegali, salva il team. Niente codice, niente YAML.

14 ruoli di agente integrati

Fullstack, Frontend, Backend, DevOps, QA, Security, PM, Architect, Mobile, Marketing, Git Expert, SEO, i18n, Brainstormer. Più qualsiasi ruolo custom che hai già salvato sul tuo progetto.

Modello e prompt per nodo

Ogni nodo sceglie il suo provider, il suo modello e le sue istruzioni di step. Usa Opus per l'Architect, Haiku per il QA, Codex per il backend pesante, Antigravity per il frontend economico. Mix and match.

Handoff automatico

Quando un agente chiama team_complete_step, AgentsRoom costruisce il payload di handoff (riassunto della feature, file modificati, rischi, hint di test, flag) e avvia il nodo successivo con quel payload come contesto iniziale.

Opzione handoff manuale

Preferisci validare ogni step? Imposta il nodo in modalita manuale. L'agente attende, tu clicchi 'Hand off' quando sei soddisfatto del risultato. Il meglio dei due mondi.

Edge condizionali

Ogni connessione può portare un controllo di flag o più di uno, combinati con E oppure O. Se la QA passa si va al PM, se la revisione fallisce si torna al Dev, se falliscono revisione E analisi ci si ferma per un umano. Quando due connessioni corrispondono insieme, vince quella con più condizioni.

Feedback loops

Dev verso QA verso Dev verso QA. Quando il QA rimanda indietro il ticket, l'agente Dev originale viene riutilizzato con la memoria completa del ciclo precedente, cosi corregge davvero la regressione invece di ricominciare da capo.

Quality gate verificati dalla macchina

Fissa un comando di controllo su un nodo (npm test, un lint, una build). Il runner lo esegue quando l'agente si dichiara pronto: exit code 0 porta il flag di instradamento a true, qualsiasi altro a false. Il risultato misurato sostituisce sempre la dichiarazione dell'agente.

Rami di revisione paralleli

Traccia due collegamenti senza condizione da un nodo e le due destinazioni girano insieme: QA e Security rivedono lo stesso diff fianco a fianco, poi un nodo di giunzione fonde i loro report. Basta un ramo rosso per tenere il gate chiuso.

Chiedi all'umano, poi vai avanti

Un nodo Await è una pausa, non una fine: il run si ferma, ti fa la domanda che hai scritto sul nodo e, appena rispondi, riparte da solo con la tua risposta passata allo step successivo. Un agente bloccato viene instradato lì invece di chiudere il run, e la notifica ti arriva sul telefono.

Skill fissate per passo

Collega voci della tua Skills Library a un nodo. L'agente le carica prima di iniziare il passo: la tua checklist di review o il tuo runbook di deploy viene applicato a ogni esecuzione, non solo quando l'agente se ne ricorda.

Max-cycles guard

Cap configurabile (default 3). Evita loop infiniti QA-rejects-Dev. Quando si raggiunge il cap, il run si mette in pausa su awaiting-finalization e decidi cosa fare.

Le esecuzioni sopravvivono ai riavvii

Chiudi l'app a meta esecuzione, riaprila: l'esecuzione riprende dal passo in cui era. Stato, note e timeline vivono su disco; l'orchestratore riprende il lavoro invece di lasciare uno zombie.

Libreria di team sul tuo account

I team globali sono sincronizzati con il tuo account e ti seguono da una macchina all'altra; i team di progetto viaggiano con la room. Entrambi tengono una cache offline, e le modifiche fatte offline vengono riprodotte alla riconnessione.

Scratchpad NOTES.md condiviso

Ogni agente nel run legge e scrive un file markdown nel workspace. Sopravvive a compaction, crash, restart. Unica fonte di verita per il ragionamento del team.

Inbox da ruolo a ruolo

Hai bisogno che il QA chieda qualcosa all'Architect a metà run? team_ask posta un messaggio nell'inbox del ruolo. Il prossimo agente di quel ruolo lo legge e risponde. Vera chat tra agenti, per la durata del run : l'inbox permanente che sopravvive al run è la messaggistica tra agenti.

Comunicazione inter-agente via MCP

Tutti i tool del team sono esposti tramite un MCP server. I tool sopravvivono alla compaction del contesto Claude (Anthropic li reinvia a ogni turno). Resilienti a /clear, /compact e loop lunghi.

Riassunto di handoff con Haiku

Se un agente non scrive il proprio riassunto della feature, una piccola chiamata Haiku ne genera uno dal git diff. Economico, veloce, e l'agente successivo arriva sempre con contesto.

Propagazione del Browser MCP

Un nodo del team con verifyInBrowser passa automaticamente il suo agente in modalita browser-access. Il nodo QA arriva con tutti i tool browser (navigate, click, type, screenshot, get logs).

Agenti effimeri per run

Ogni run del team avvia agenti freschi e li distrugge al dismiss. La lista agenti del tuo progetto resta pulita. Il team e il workflow, gli agenti sono il runtime.

Team globali e di progetto

Salva team riutilizzabili nella tua libreria globale (~/.agentsroom/teams) o agganciali a un progetto specifico (committati con la room). Stesso editor, scope diverso.

Quattro modelli di team inclusi

Costruire e verificare, Specificare costruire verificare, Caccia al bug (riprodurre, correggere, dimostrare) e Scudo di release con QA e Security in parallelo. Duplica, modifica, lancia. Pronto in 30 secondi.

UI della timeline del run

Ogni handoff appare come una card nella timeline del run: quale ruolo ha appena finito, cosa dice il riassunto, quali file sono cambiati, quali flag sono stati impostati. Auditabile, replayabile.

Esegui su qualsiasi ticket del backlog

Trascina un ticket su un team e la catena parte su quel ticket. Il primo agente legge titolo e corpo del ticket, il resto del team prende da li.

14 ruoli specializzati, pronti per essere collegati

Ogni ruolo ha il suo system prompt, le sue aree di focus e task di esempio. Mixali sul canvas. Aggiungi i tuoi ruoli custom in qualsiasi momento.

Fullstack
End-to-end implementation
Frontend
UI, components, design tokens
Backend
API, database, performance
DevOps
CI/CD, infra, deployment
QA
Tests, edge cases, regression
Security
Audit, OWASP, secrets, auth
Architect
System design, refactor
PM
Specs, priorities, scope
Mobile
iOS, Android, React Native
Marketing
Copy, landing, SEO
Git Expert
Branches, rebase, history
SEO
Rankings, structured data
Localization
i18n, l10n, 14 languages
Custom
Bring your own role

Perche una vera squadra batte un super-agente

Orchestrazione multi-agente sembra una buzzword. Ecco la differenza pratica, su una feature che spediresti davvero.

Scenario: aggiungere un flusso di checkout Stripe a un sito e-commerce

Super-agente solitario

  • Legge il ticket. Scrive 600 righe tra API, form React, webhook, migration e test.
  • Dimentica la idempotency key sul webhook. Dimentica di testare il path di errore. Dimentica la env var di staging.
  • Dice 'Done'. Passi due ore a cacciare bug in produzione.

Agent Team (Dev verso Security verso QA)

  • L'agente Fullstack rilascia l'implementazione, committa, fa l'handoff con un riassunto e una lista di rischi che segnala il cambio di auth.
  • L'agente Security legge il diff, fa l'audit del check di firma del webhook, scrive hint di test per il QA nel payload di handoff.
  • L'agente QA esegue gli hint di test nel browser integrato, becca un bug di idempotency, imposta qaPassed equals false, rimanda il ticket al Dev con la riproduzione esatta.
  • Il Dev corregge, fa di nuovo l'handoff. Il QA passa. Il PM finalizza. Il run va a done.

Stesso ticket, stessi modelli, stesso progetto. Forma del lavoro diversa. L'approccio team prende cio che il super-agente solitario manca, perche ogni ruolo ha un brief focalizzato e un handoff strutturato.

Due modi di eseguire lo stesso team

Il grafo dice chi fa cosa. La modalità dice come quei ruoli vengono incarnati, e la scegli quando costruisci il team. Una conserva il contesto, l'altra conserva l'indipendenza. Non esiste una versione che faccia entrambe le cose, quindi la scelta è tua, team per team.

Un solo agente, tutti i ruoli

Modalità staffetta

Una sola sessione manda avanti tutto il team. Interpreta il primo ruolo, passa il lavoro, poi diventa il successivo, nella stessa console, senza mai ripartire. Tra due ruoli non viene riassunto nulla, perché tra loro non si perde nulla.

Cosa guadagni
Cosa guadagni: Continuità piena. Il ruolo QA sa già perché il ruolo Dev ha deciso così, fin dentro il ragionamento, quindi nessuno rispiega una decisione presa venti minuti prima.
Quanto costa
Quanto costa: È un solo agente che cambia cappello. La sessione che ha scritto il codice è quella che lo rivede, e un'autorevisione coglie meno di uno sguardo nuovo.

Scegli questa per una pipeline in cui la continuità conta più di un secondo parere: un refactor, una migrazione, una feature lunga in cui il contesto è il lavoro.

Come funziona il morphing di ruolo

Un agente per ruolo, che si parlano

Modalità team

Ogni ruolo ha la sua sessione, e sono vivi nello stesso momento. Si scrivono mentre lavorano: il tester dice allo sviluppatore front-end cosa si è rotto, lo sviluppatore front-end chiede allo sviluppatore back-end com'è fatto davvero il payload. Un compagno a cui nessuno si è ancora rivolto parte nell'istante in cui qualcuno gli scrive.

Cosa guadagni
Cosa guadagni: Secondi pareri veri. A rivedere il codice è qualcuno che non l'ha scritto, e un compagno che entra a run avviato parte da una lettura neutra del diff invece che dal ricordo di averlo scritto.
Quanto costa
Quanto costa: Il contesto si paga, non si eredita. Un compagno che entra legge le note condivise e il diff per mettersi in pari, e questo costa token e tempo che la staffetta non spende mai.

Scegli questa quando vuoi che la revisione sia reale: un passaggio di sicurezza, una critica di design, una caccia ai bug, tutto ciò in cui le cose vanno storte proprio quando il passo precedente viene approvato senza metterlo in discussione.

Come funziona la messaggistica tra agenti

Conversazione libera, o seguire il grafo

La modalità team ha un secondo interruttore, perché un team che può parlare in una sola direzione è una coda con qualche passo in più. Lascialo disattivato e un compagno scrive solo ai ruoli verso cui punta il suo nodo: il grafo resta il contratto, che è quello che vuoi quando un quality gate non deve poter essere aggirato.

Attivalo e chiunque scrive a chiunque, in qualsiasi direzione e a più ruoli insieme. Il tester informa il designer e lo sviluppatore back-end nello stesso messaggio; lo sviluppatore back-end risponde direttamente al designer invece di ripassare dal lead. Il grafo continua ad avviare il run e a chiuderlo, ma smette di decidere chi ha diritto di parola.

La fiducia si misura, non si dichiara

Un agente che corregge il proprio compito finira per promuoversi da solo. Agent Teams tiene onesta la pipeline con due meccanismi.

Decide l'exit code

Qualsiasi nodo puo dichiarare un comando di controllo: npm test, un lint, una build, qualunque cosa restituisca un exit code. Quando l'agente chiama team_complete_step, il runner esegue il comando nel workspace e scrive il risultato misurato nel flag di instradamento. Verde: l'esecuzione avanza. Rosso: l'output d'errore atterra in cima al contesto dell'agente successivo, con il vero stderr. Un agente che sostiene che tutti i test passano mentre la suite e rossa viene instradato dalla suite rossa, non dalla sua affermazione.

Quattro occhi, nello stesso momento

Dividi un nodo in rami paralleli: QA percorre i flussi mentre Security controlla il diff, ciascuno nel proprio agente, cieco alle conclusioni dell'altro. Un nodo di giunzione aspetta ogni ramo, fonde riepiloghi, rischi e flag, e instrada sul risultato combinato. I conflitti booleani si risolvono a false per costruzione: un solo revisore bocciato basta a trattenere la release.

Dev → [ QA ∥ Security ] → Release gate

Come funziona un run di team

01

Apri la tab Teams

Nella vista progetto, la scheda Teams elenca quattro modelli inclusi (Costruire e verificare, Specificare costruire verificare, Caccia al bug, Scudo di release) piu i team gia salvati. Duplica un modello o clicca su 'New team'.

02

Costruisci il workflow sul canvas

Trascina nodi di agente sul canvas React Flow. Per ogni nodo, scegli il ruolo (Fullstack, QA, Security, PM, ecc.), il provider, il modello e qualche riga di istruzioni di step. Collegali con edge. Aggiungi condizioni sugli edge se ti serve diramare.

Dev → QA → PM
03

Imposta la modalita di handoff per nodo

Auto handoff: l'agente chiama team_complete_step quando il suo lavoro e finito, il runner subentra. Manual handoff: l'agente aspetta che tu clicchi 'Hand off'. Mixali secondo necessita.

04

Esegui il team

Da un ticket del backlog, clicca 'Run with team'. Da uno slot agente vuoto, clicca 'Create as team'. Il primo nodo si avvia come agente effimero nel workspace di progetto.

05

Guarda l'handoff in azione

Quando l'agente N finisce, AgentsRoom costruisce il payload di handoff (riepilogo via agente o via Haiku, diff git, rischi, suggerimenti di test, flag), aggiunge una nota a NOTES.md, sceglie il collegamento in uscita giusto in base ai flag e passa la mano all'agente N+1 con quel payload come contesto d'ingresso. Se il nodo dichiara un comando di controllo, il runner lo esegue prima: e l'exit code misurato, non l'affermazione dell'agente, a impostare il flag di instradamento.

06

Loop, end, finalize

I feedback loops rientrano nell'agente originale (memoria completa preservata). Un nodo Await parcheggia il run su una domanda per te e lo fa ripartire appena rispondi. Il nodo finale attiva awaiting-finalization e ti avvisa, telefono incluso. Clicchi 'Finish run': gli agenti vengono distrutti, le loro PTY liberate e il ticket di backlog da cui è partita l'esecuzione viene chiuso.

Comunicazione inter-agente che sopravvive a tutto

Il dettaglio che la maggior parte delle demo multi-agente salta. Ecco cio che fa reggere Agent Teams su run lunghi e molti cicli.

Gli agenti Claude Code hanno una context window e la compattano. L'errore classico dei sistemi multi-agente e mettere il coordinamento del team solo nel system prompt. Dopo due cicli di /compact, l'agente non ha piu idea di essere in un team. AgentsRoom non fa cosi.

Tutto il coordinamento del team vive in tre posti che sopravvivono alla compaction. Primo, un MCP server (agentsroom-team) espone tool (team_get_context, team_read_notes, team_post_note, team_read_inbox, team_ask, team_read_timeline, team_read_diff, team_complete_step). I tool MCP vengono rimandati a Claude a ogni turno dalla CLI, quindi sono immuni alla compressione del contesto.

Secondo, un hook UserPromptSubmit gira prima di ogni messaggio dell'utente e antepone un piccolo promemoria se ci sono nuove note o nuovi messaggi inbox per quel ruolo. Economico quando non succede nulla, decisivo quando succede.

Terzo, NOTES.md e state.json vivono su disco nel workspace. L'agente puo rileggerli in qualsiasi momento con un semplice Read o con team_read_notes. Sopravvivono a crash, restart, /clear, /compact e reboot della macchina. Il system prompt non e mai la fonte di verita: il disco e i tool MCP lo sono.

Oltre il run

L'inbox del team finisce con il run. L'elenco del progetto no.

Tutto quello che precede è limitato a un run : i ruoli sono nodi di un grafo, l'inbox appartiene al run, ed entrambi spariscono quando finisce. È la forma giusta per una pipeline che rigiochi, e quella sbagliata per una domanda che un agente vorrà fare a un altro martedì prossimo.

La messaggistica tra agenti è l'altro livello. Gli agenti salvati del progetto sono membri permanenti con un proprio indirizzo e una propria inbox, si scrivono per nome da qualsiasi CLI, e un messaggio sopravvive a un riavvio, a un crash e a un agente che era offline al momento dell'invio. Da Agent Teams non è stato tolto nulla : un membro permanente può lanciare un run, e un nodo di run non viene mai promosso a membro permanente.

Vedi la messaggistica tra agenti

Cosa costruisce la gente con Agent Teams

Pipeline Dev verso QA

Il classico. Il Fullstack rilascia la feature. Il QA la valida nel browser integrato, esegue gli hint di test, approva. Team a due nodi, gira su ogni ticket del backlog.

Dev verso QA con feedback loop

Come sopra, ma con un edge condizionale: qaPassed equals false rimanda il ticket al Dev con gli hint di test. Max 3 cicli. Becca le regressioni prima che arrivino a un reviewer umano.

Dev verso Security verso QA

Per feature che toccano auth, pagamenti o PII. L'agente Security rivede il diff, segnala rischi, scrive hint di test per il QA. Usato da team che spediscono fintech, healthtech e B2B SaaS.

PM verso Architect verso Dev

Workflow spec-first. L'agente PM trasforma il ticket in una spec strutturata. L'Architect sceglie l'approccio. Il Dev implementa. Tre ruoli, separazione pulita, decisioni tracciabili.

Fan-out Frontend, Backend, DevOps

Split sequenziale per feature full-stack. Il Frontend rilascia la UI. Il Backend rilascia l'API. Il DevOps aggiunge la config infra. Ogni ruolo lavora nella sua area, fa l'handoff con un diff pulito.

Marketing verso SEO verso i18n

Si, AgentsRoom Teams non e solo per il codice. Il Marketing scrive la copy della landing. Il SEO inietta le keyword. La Localization traduce in 14 lingue. Un team, un ticket, una spedizione.

Scudo di release: QA e Security in parallelo

Un nodo dev si divide in QA e Security che girano fianco a fianco, poi un release gate fonde i due report. Incluso con l'app come modello. L'intero scudo torna al Dev se uno dei rami segnala un problema.

Caccia al bug: riprodurre prima di correggere

Un agente QA riproduce il bug e annota i passi esatti. Un dev corregge la causa radice. Un secondo QA ripete gli stessi passi per dimostrare la correzione. Basta con il 'sul mio computer funziona'.

Come si confronta con altri approcci multi-agente

L'orchestrazione multi-agente e una buzzword affollata. Ecco cosa sta davvero spedendo, e dove si colloca AgentsRoom Teams.

I Subagents di Anthropic (Task tool, .claude/agents) permettono a una singola sessione Claude di delegare ad agenti helper specializzati. Ottimo per la delega inline, ma la sessione genitore resta il coordinatore e un singolo contesto. AgentsRoom Teams e un livello sopra: ogni nodo del team e una sessione Claude top-level separata, con la sua finestra, il suo stato, il suo scrollback. CrewAI, AutoGen e LangGraph sono ottimi framework Python per flussi multi-agente, ma vivono fuori dal tuo IDE e non eseguono CLI Claude Code, Codex o Antigravity end-to-end sul tuo repo locale. n8n, Make, Pipedream e Retool offrono lo stesso tipo di canvas editor che usiamo, ma sono piattaforme di automazione generaliste, non costruite per agenti IA di coding. AgentsRoom Teams e l'editor di workflow multi-agente in stile canvas, ma cablato specificamente sui tuoi agenti CLI, sul tuo progetto, sul tuo git, sui tuoi terminali e sul tuo browser.

Claude subagentsTask toolCrewAIAutoGenLangGraphn8nMakePipedreamRetoolTemporalAirflowPrefectDagster

Se costruisci sistemi agentici in Python, continua a usare CrewAI o LangGraph per pipeline di produzione. Se spedisci codice con Claude, Codex, GitHub Copilot CLI, Cursor o una qualsiasi delle altre 10 CLI di agenti supportate da AgentsRoom, Agent Teams e il workflow di squadra che gira dove davvero scrivi codice.

FAQ

In cosa differisce dai subagents di Claude Code (Task tool, .claude/agents)?

I subagents di Claude sono delegazioni inline da una singola sessione Claude genitore. Il genitore decide quando chiamare un subagent, il subagent gira in una context window isolata, restituisce un risultato e il genitore prosegue. AgentsRoom Teams e un livello sopra: ogni nodo e una sessione Claude Code top-level con il suo terminale, il suo stato e il suo scrollback. Vedi ogni agente girare live nella sua tab, puoi parlarci in qualsiasi momento, puoi mettere in pausa il team, cambiare il workflow e riprendere. Non e un rimpiazzo dei subagents Claude, puoi assolutamente usare entrambi. Un nodo del team puo usare subagents internamente.

Funziona solo con Claude Code?

Funziona con tutte le 14 CLI di agenti supportate da AgentsRoom (Claude Code, Codex CLI, GitHub Copilot CLI, Cursor e altre 10). Ogni nodo del team sceglie il proprio provider e modello. I tool di coordinamento del team basati su MCP funzionano in modo identico tra provider perche sono esposti tramite il Model Context Protocol standard. Puoi eseguire un team con Codex sul nodo backend pesante e Haiku sul nodo QA se questo e cio che si adatta al tuo budget e alla tua latenza.

Cos'e un payload di handoff?

Un oggetto strutturato che viaggia da un agente al successivo. Campi: featureSummary (una breve descrizione di cio che e appena stato rilasciato), changedFiles (git diff name-status), touchedAreas (UI, API, DB, config), risks (qualsiasi cosa di cui il prossimo agente debba preoccuparsi), testHints (priorita per il QA), flags (boolean come qaPassed, usati dagli edge condizionali). L'agente chiama team_complete_step con questo payload, il runner lo valida server-side, l'agente successivo lo riceve come contesto iniziale.

Gli agenti possono davvero andare avanti e indietro (Dev verso QA verso Dev)?

Si. Quando un nodo viene rientrato (ciclo maggiore di 1), AgentsRoom non avvia un nuovo agente. Riutilizza l'agente originale del ciclo 1, scrive il nuovo payload di handoff direttamente nel suo terminale esistente, e l'agente mantiene la sua memoria completa della sessione Claude dei cicli precedenti. Questo e critico: un agente Dev che sa gia cosa il QA ha segnalato l'ultima volta corregge il bug. Un agente Dev fresco senza memoria ripeterebbe lo stesso errore.

Cosa succede se il QA continua a rifiutare il Dev all'infinito?

La config del team ha un max-cycles guard, default 3. Quando si raggiunge il cap, il run si mette in pausa con stato 'blocked' e ti aspetta. Puoi finalizzare il run, fare manualmente un altro handoff, o cancellare tutto. Niente loop infiniti, niente fatture a sorpresa nottetempo.

Tutti gli agenti del team condividono lo stesso workspace git?

Si. Il team gira in un singolo workspace e su un singolo branch (o worktree se usi la feature AgentsRoom Worktrees). Ogni agente vede il lavoro del precedente attraverso git. Il payload di handoff include un git diff rispetto alla baseline del run cosi il prossimo agente sa esattamente cosa e nuovo.

Serve un abbonamento extra?

No. I Teams fanno parte di AgentsRoom. Porti le tue chiavi provider (Claude, Codex, GitHub Copilot CLI, Cursor e altre 10 CLI di agenti) e paghi solo i token che usi, come con un singolo agente. Eseguire un team Dev verso QA su un piccolo ticket costa tipicamente come eseguire un singolo agente Fullstack, perche Haiku/Sonnet sullo step QA e economico.

Dove sono memorizzati i team? Sono committati su git?

I team di progetto vivono con la room, sincronizzati con il tuo account e in cache in {project}/.agentsroom/teams-cache.json (gitignored). Anche i team globali sono sincronizzati con il tuo account: la tua libreria ti segue da una macchina all'altra, con ~/.agentsroom/teams/ come cache offline. I modelli inclusi restano locali: ogni macchina li installa nella propria lingua.

E se un agente crasha o l'app si riavvia a meta run?

Lo stato dell'esecuzione e persistito su disco in {workspace}/.agentsroom/team-runs/{runId}/ (state.json, NOTES.md, inbox/, timeline.jsonl), con scritture atomiche e note append-only. Un'esecuzione interrotta riprende al riavvio dell'app: l'orchestratore rientra nel passo attivo, riapre il terminale e l'agente recupera il contesto dalle note e dagli strumenti del team. Un'esecuzione il cui team e stato eliminato viene chiusa automaticamente invece di restare li per sempre.

Posso eseguire piu team in parallelo su ticket diversi?

Si. Ogni esecuzione e indipendente, identificata dal suo runId. Puoi avere tre team diversi attivi su tre ticket dello stesso progetto. Dentro una singola esecuzione, il flusso segue il tuo grafo: sequenziale di default, parallelo dove disegni rami paralleli (per esempio QA e Security che rivedono insieme), sempre con una giunzione deterministica.

Due agenti possono davvero girare nello stesso momento?

Si. Traccia due collegamenti senza condizione da un nodo e le due destinazioni girano come rami paralleli, ciascuno nel proprio agente e terminale. I rami sono profondi un nodo e devono convergere su un nodo di giunzione comune, che l'editor valida prima di lasciarti lanciare. Quando ogni ramo ha finito, la giunzione riceve un payload fuso: riepiloghi etichettati per ruolo, rischi e suggerimenti di test deduplicati, e flag fusi con una regola fail-safe (un conflitto booleano si risolve a false).

Come funzionano esattamente i quality gate?

Scrivi un comando shell sul nodo, per esempio npm test, e se vuoi un nome di flag (checkPassed di default). Quando l'agente segnala la fine del passo, AgentsRoom esegue il comando nel workspace con un tetto di cinque minuti. Exit code 0 scrive true nel flag, qualsiasi altro scrive false, sovrascrivendo cio che l'agente ha dichiarato su di se. In caso di fallimento, gli ultimi kilobyte di output viaggiano verso l'agente successivo: il ritorno indietro atterra con il vero stack trace, e il risultato compare nella timeline dell'esecuzione.

Un passo puo caricare le mie procedure della Skills Library?

Si. Ogni nodo puo fissare skill della tua Skills Library, di progetto o globali. L'agente riceve l'istruzione di caricarle prima di iniziare il passo: una checklist di review, un runbook di deploy o una procedura di test viene applicata a ogni singola esecuzione, invece di dipendere dalla memoria dell'agente.

AgentsRoom verifica il grafo del mio team prima di eseguirlo?

Sì. L'editor esegue una serie di controlli sul grafo e separa gli errori bloccanti dagli avvisi. Gli errori fermano l'esecuzione: un nodo Start o End mancante, connessioni duplicate, due connessioni con le stesse condizioni, una connessione le cui condizioni si contraddicono, un fan-out non valido. Gli avvisi no: un nome di flag con spazi all'inizio o alla fine, una condizione su una connessione che esce da Start, un nodo le cui connessioni uscenti sono tutte condizionali, dove l'esecuzione può fermarsi. Entrambi sono elencati in un pannello di controlli e le connessioni colpevoli vengono ricolorate sul canvas, così correggi il grafo prima di perderci un'esecuzione.

Un agente può modificare il team in cui sta girando?

No, ed è voluto. Finché un'esecuzione è attiva, la definizione del team è congelata rispetto alle scritture che arrivano dagli strumenti MCP: nodi, collegamenti, numero massimo di cicli, istruzioni di passo, skill, comando di controllo, ruolo, provider e modello sono in sola lettura per gli agenti, nemmeno una skill caricata dall'esecuzione può essere riscritta, e il blocco non si aggira eliminando e ricreando il team. Un agente non deve riscrivere la regola che lo governa. Tu continui a modificare tutto dall'interfaccia in qualsiasi momento.

Posso lanciare e seguire l'esecuzione di un team dal telefono?

Sì. L'app mobile può avviare un team su un progetto, mostra un banner di esecuzione con l'avanzamento di ogni passo e dà accesso al terminale dell'agente che sta lavorando in quel momento. L'esecuzione vera e propria gira comunque sul tuo desktop, con le CLI reali, esattamente come se l'avessi lanciata da lì.

Meglio la modalità staffetta o la modalità team?

Chiediti su cosa fallirebbe il run. Se fallirebbe perdendo il filo, scegli la staffetta: una sola sessione interpreta ogni ruolo e non si rispiega mai una decisione. Se fallirebbe dandosi ragione da sola, scegli il team: i ruoli girano come agenti separati, quindi chi rivede il codice non è chi l'ha scritto. La staffetta è l'impostazione predefinita perché è già ciò che fa ogni team costruito prima che l'opzione esistesse, non perché sia migliore.

In modalità team, tutti gli agenti partono insieme?

No. Un compagno parte la prima volta che serve, perché il grafo raggiunge il suo passo o perché un altro agente gli scrive, e da lì resta vivo per il resto del run. Così un team di quattro ruoli non brucia quattro sessioni per rispondere a una domanda che ne riguarda solo due, e un ruolo interpellato al terzo ciclo è ancora lo stesso agente che ha risposto al primo.

Un compagno ricorda quello che hanno fatto gli altri?

Solo quello che può leggere. Un compagno che entra a run avviato ha la sua sessione e nessun ricordo del lavoro, ed è esattamente per questo che il suo parere vale qualcosa. Si mette in pari con le note condivise, la timeline del run e il diff git dall'inizio del run, e legge tutto con i suoi strumenti. Quella lettura è il costo della modalità, ed è il motivo per cui la modalità staffetta esiste ancora.

Posso impedire agli agenti di scriversi in qualsiasi ordine?

Sì, ed è il comportamento predefinito. Con la conversazione libera disattivata, un compagno può scrivere solo ai ruoli verso cui punta il suo nodo nel grafo, quindi un quality gate non si aggira chiedendo a qualcun altro. Attivala quando vuoi una squadra vera: chiunque scrive a chiunque, in qualsiasi direzione e a più ruoli insieme. In entrambi i casi il grafo continua ad avviare il run e a chiuderlo.

Approfondimenti

Costruisci la tua squadra IA di sviluppo dei sogni

Quattro modelli inclusi nell'app. Apri AgentsRoom, posiziona i nodi, traccia i collegamenti, lancia su qualsiasi ticket. Il tuo team di ingegneria IA e a un clic.

GratisScarica AgentsRoom

App companion: monitora i tuoi agenti in movimento

Usa Claude, Codex, Antigravity CLI o un altro provider IA.

Installa l'estensione
Chrome Web Store

Invia bug e richieste direttamente nel tuo backlog pubblico.

Uno sguardo ad AgentsRoom in azione.

Multi-progetto
Multi-provider
Multi-agente
Stato in tempo reale
Diff e commit
App mobile
Anteprima live
Team di agenti
Test browser
Dev guidata da backlog
Libreria di prompt
Libreria di skill
Vedi tutte le funzionalità