Tutorial Kanban — Colaboração Multiagente

Imagine uma cozinha movimentada onde cada chef tem uma especialidade diferente. Se você tivesse que gritar instruções uma de cada vez e esperar cada prato ficar pronto antes de começar o próximo, o serviço desmoronaria. Hermes Kanban é o quadro branco na parede dessa cozinha — cada tarefa, seu status e quem está travado em quê fica anotado para qualquer um ver de relance.

O Que É Kanban?

Kanban é um quadro de tarefas compartilhado que todos os agentes Hermes podem ler e escrever. Cada tarefa é um registro simples armazenado em um único arquivo: ~/.hermes/kanban.db. Cada agente é um trabalhador independente com sua própria identidade e memória — não um temporário anônimo, mas um funcionário regular que conhece as regras da casa.

Duas Portas, Uma Sala

O quadro tem duas interfaces, mas ambas apontam para o mesmo banco de dados, então nada fica dessincronizado:

1. Agentes usam ferramentas — o modelo lê e atualiza tarefas via ferramentas kanban_* como kanban_show (ver tarefa), kanban_complete (finalizar tarefa) e kanban_block (marcar como travada).
2. Você usa o terminal — digite hermes kanban ... ou use comandos de barra /kanban ..., ou abra o painel web.

# Criar uma tarefa
hermes kanban create "Research competitor pricing" --assign researcher-1

# Listar todas as tarefas
hermes kanban list

# Marcar uma tarefa como concluída
hermes kanban complete 42

Qual a Diferença Para o delegate_task?

delegate_task é como uma ligação telefônica: você chama uma pessoa, espera a resposta e desliga. Kanban é como um grupo de chat: você posta uma mensagem, todo mundo vê, quem está livre pega a tarefa e reporta quando termina.

Aspecto	delegate_task	Kanban
Estilo de trabalho	Síncrono — espera pelo resultado	Dispare e esqueça
Identidade do agente	Temporário anônimo	Nomeado, com memória
Tratamento de falhas	Perdido em caso de erro	Marcado como bloqueado, tenta de novo depois
Multi-agente	Um de cada vez	Vários agentes em revezamento

Para Que o Kanban É Bom?

A documentação oficial destaca vários padrões:

• Pipelines de pesquisa: vários pesquisadores buscam em paralelo → um analista resume → um redator escreve
• Tarefas agendadas: gerar automaticamente um briefing matinal, acumulando em um log de longo prazo
• Gêmeos digitais: assistentes persistentes como inbox-triage que aprendem suas preferências com o tempo
• Engenharia: dividir tarefas → desenvolvimento paralelo → revisão de código → merge

Cola de Comandos Principais

# Adicionar um comentário (humanos podem entrar na conversa)
hermes kanban comment 42 "Price data needs updating to latest version"

# Marcar como bloqueada (aguardando entrada externa)
hermes kanban block 42 "Waiting for client to confirm requirements"

# Desbloquear
hermes kanban unblock 42

# Mostrar detalhes da tarefa
hermes kanban show 42

Dica de Profissional: Deixe Humanos Intervirem

A melhor parte do Kanban é que humanos podem intervir a qualquer momento. Quando um agente fica preso, ele marca a tarefa como block. Você vê, deixa um comentário ou desbloqueia diretamente. É como dizer a um chef “tem mais peixe na geladeira” — ele pega e continua.

Official Screenshots

Resumo

Kanban transforma a colaboração multi-agente de “ligações telefônicas” em “olhar o quadro branco” — mais flexível, mais confiável, mais transparente. Cada tarefa é registrada, cada falha pode ser tentada novamente, e qualquer pessoa (humano ou agente) pode continuar de onde outro parou.

Experimente isto: comece pequeno — crie dois agentes (digamos, researcher e writer). Faça o researcher investigar um tópico e postar os resultados no quadro. O writer vê a nova tarefa, pega e escreve o artigo. Você vai sentir a mágica da colaboração com quadro branco em minutos.

---