Um guia completo do Hermes Kanban: o modelo de coordenação, compartilhamento de contexto entre agentes e construção de um time de software com 4 agentes (PM, backend, frontend, tester) em cerca de 20 minutos.
Agentes de IA deveriam funcionar como um time.
Você descreve o objetivo. Eles dividem o trabalho. Cada um continua de onde o outro parou.
Essa é a promessa. O que acontece na prática é o oposto. Agentes começam do zero. Um agente não sabe o que os outros construíram, quais arquivos foram alterados ou como está a API. Cada passagem de bastão é um ponto de partida frio, e o trabalho se degrada no momento em que passa de um agente para o outro.
O Hermes Kanban resolve isso. Cada tarefa sobrevive a crashes e reinicializações. Cada briefing carrega exatamente o que o próximo agente precisa. Cada falha é salva, então a nova tentativa sabe o que quebrou.
É assim que sua central de comando se parece:
Painel Kanban
A melhor parte é que o time inteiro roda a partir do seu celular. Você cria e direciona tarefas pelo Telegram, e os agentes as executam enquanto você está longe do computador.
Veja só:
Neste artigo, construímos esta configuração completa do zero: o modelo de coordenação, os briefings e um time de software de 4 membros rodando no seu próprio hardware em cerca de 20 minutos.
Para demonstrar isso, criei um clone funcional do Google Docs, com recursos de IA incluídos, backend pronto para produção, construído exatamente por esse time de agentes.
Demonstração do clone do Google Docs
Então, sem mais delongas, vamos nessa.
Por que um único agente não é suficiente
Digamos, por exemplo, que você queira adicionar um recurso de redefinição de senha. O trabalho se divide em três domínios:
- Um desenvolvedor backend que constrói a API REST
- Um desenvolvedor frontend que lê essa API e constrói a interface sobre ela
- Um tester que verifica tudo de ponta a ponta
1 vs 3 Agentes
Você pode executar todos os três através de um único agente, mas a janela de contexto se enche e o agente perde o controle do que fez três passos atrás. Você gasta mais tempo gerenciando o agente do que ele economiza.
Dividir o trabalho entre agentes que são donos de cada domínio cria um problema diferente: como o desenvolvedor frontend sabe o que o desenvolvedor backend construiu? Esse problema de contexto compartilhado é o que o Hermes Kanban resolve.
O modelo mental: um quadro de tarefas, mas com agentes atrás das colunas
Uma tarefa tem um título, uma descrição, um responsável e um status. Alguém a pega, move pelo quadro e a fecha. O quadro é a fonte única da verdade.
O Hermes Kanban mantém esse modelo e coloca agentes atrás de cada coluna, em vez de humanos.
Quadro Hermes Kanban
Cada tarefa é uma linha que sobrevive a crashes e reinicializações. Quando um agente termina, ele escreve um resumo: arquivos alterados, o que construiu, o que o próximo agente precisa saber. O próximo agente lê esse resumo antes de começar.
Esse resumo é toda a essência. É o que transforma um grupo de agentes em um time, em vez de estranhos.
O vocabulário
Temos 6 colunas diferentes no quadro Kanban:
- Triagem: Ideias brutas chegam aqui, bom para "quero limite de taxa na autenticação" antes de ter uma especificação completa.
- A Fazer: Tarefa criada, mas aguardando uma dependência. Não avança até que sua tarefa pai termine.
- Pronto: Dependências atendidas, aguardando um agente pegá-la.
- Em Andamento: Um agente está executando ativamente.
- Bloqueado: O agente encontrou um obstáculo e sinalizou para um humano. Nada roda até que você desbloqueie.
- Concluído: Finalizado, com histórico completo de execução, resumo e metadados preservados.
O orquestrador: um agente que gerencia os outros
Pense no agente orquestrador como o gerente de projeto que lê um objetivo de alto nível, verifica quais agentes existem, divide o objetivo em tarefas vinculadas e se afasta. Ele nunca escreve código ou executa testes. Ele coordena.
O agente orquestrador
A única regra que importa: verifique quais perfis existem antes de criar tarefas. O sistema ignora silenciosamente qualquer tarefa cujo responsável não corresponda a um perfil real, então o passo zero é sempre kanban_list.
Aqui está uma interação típica de um gerente de projeto, decompondo uma solicitação "construir um fluxo de redefinição de senha" em um pipeline vinculado:
1kanban_show()23be = kanban_create(title="Backend de redefinição de senha", assignee="backend-developer",4 body="Fluxo de redefinição/esqueci a senha + invalidação de sessão")56fe = kanban_create(title="Interface de redefinição de senha", assignee="frontend-developer",7 parents=[be], body="Fluxo de redefinição Next.js usando a API do backend")89qa = kanban_create(title="Teste E2E de redefinição de senha", assignee="tester",10 parents=[fe], body="Validar todos os critérios de aceitação")1112kanban_complete(summary="Pipeline de dependências criado: backend → frontend → QA")
Depois disso, o quadro cuida da promoção e os briefings cuidam do contexto. Quando todos os três terminam, o gerente de projeto acorda, lê os resumos e julga se o trabalho está concluído. Se o tester retornar "verdict": "FAIL", ele cria tarefas de correção e o loop continua.
Mas, na realidade, você não precisa se preocupar com nada. Você só precisa delegar uma tarefa pelo Telegram e o orquestrador cuida do resto.
Três padrões que você usará constantemente
1. O pipeline: Cada tarefa depende da anterior. Apenas a primeira começa em "pronto". Todo o resto espera sua vez.
1BACKEND=$(hermes kanban create "Implementar API de autenticação" \2 --assignee backend-developer \3 --body "POST /register, POST /login, POST /refresh, POST /logout." \4 --json | jq -r .id)56FRONTEND=$(hermes kanban create "Construir interface de autenticação" \7 --assignee frontend-developer \8 --parent $BACKEND \9 --body "Ler o handoff do backend para a forma da API. Páginas de login, registro, perfil." \10 --json | jq -r .id)1112hermes kanban create "Testar fluxo de autenticação de ponta a ponta" \13 --assignee tester \14 --parent $FRONTEND \15 --body "Cobrir caminho feliz, senha errada, token expirado, persistência de sessão."
Você não executa isso manualmente. Você descreve o projeto para o gerente de projeto no Telegram e ele cria essas tarefas para você. Nos bastidores, é como o código acima.
Quando o agente backend chama kanban_complete(), a tarefa do frontend passa para "pronto" com o trabalho do backend anexado.
2. Humano no loop: Nem todo bloqueador é uma falha. Às vezes um agente encontra um problema real e para para perguntar.
1kanban_block(reason="revisão-necessária: verificação de força de senha ausente, "2 "tokens de redefinição não são de uso único (podem ser reutilizados em 30 min)")
Você vê o bloqueio no painel. Verifica o problema, corrige e desbloqueia a tarefa:
1hermes kanban unblock $IMPL
Você também não executa isso no terminal; basta comentar no quadro Kanban ou enviar mensagem no Telegram, e o sistema desbloqueia.
O sistema reinicia o agente no próximo ciclo. A segunda execução chama kanban_show() e vê exatamente por que a primeira tentativa foi bloqueada. Ele sabe precisamente o que corrigir; não está começando do zero.
3. Especificador de triagem.
Quando você tem uma ideia geral em vez de uma especificação completa, coloque-a no quadro e deixe o sistema detalhá-la antes que qualquer agente a pegue.
1# Colocar uma ideia geral2hermes kanban create "autenticação precisa de limite de taxa" --triage --assignee backend-developer34# Detalhar antes que o despachante a pegue5hermes kanban specify $TASK_ID
O comando specify reescreve o título de três palavras em uma tarefa completa com um objetivo, uma abordagem e critérios de aceitação. O agente que a pega recebe um briefing de verdade.
Configurando: quatro perfis em cerca de 20 minutos
Quatro agentes, um quadro compartilhado, o gerente de projeto acessível pelo Telegram.
Passo 1: Criar os perfis.
1hermes profile create project-manager --clone2hermes profile create backend-developer --clone3hermes profile create frontend-developer --clone4hermes profile create tester --clone
--clone copia a configuração do seu perfil padrão como ponto de partida.
Passo 2: Dar uma personalidade a cada agente
1. Gerente de Projeto em ~/.hermes/profiles/project-manager/SOUL.md:
1# Alma23Você é o gerente de projeto de um time de desenvolvimento de software. Seu trabalho4é pegar a ideia de um aplicativo do usuário, dividi-la em tarefas claras, atribuí-las5aos membros certos da equipe e acompanhar o progresso no quadro Kanban.6Você não escreve código. Você gerencia o trabalho.
2. Desenvolvedor Backend em ~/.hermes/profiles/backend-developer/SOUL.md:
1# Alma23Você é o desenvolvedor backend de um time de software. Você constrói e gerencia4todo o backend usando o InsForge — banco de dados, autenticação, armazenamento,5funções de borda e implantação.
3. Desenvolvedor Frontend em ~/.hermes/profiles/frontend-developer/SOUL.md:
1# Alma23Você é o desenvolvedor frontend de um time de software. Você constrói a interface —4componentes, páginas e fluxos de usuário — e os conecta ao backend5usando as APIs e métodos SDK que o desenvolvedor backend configurou.
4. Tester em ~/.hermes/profiles/tester/SOUL.md:
1# Alma23Você é o tester de um time de software. Você testa funcionalidades concluídas4de ponta a ponta, verifica se os critérios de aceitação foram atendidos e relata5bugs claramente de volta ao quadro Kanban para que possam ser corrigidos.
Passo 3: Adicionar habilidades aos agentes
Habilidades são guias passo a passo, instruções específicas sobre como realizar certos tipos de trabalho. Pense nelas como treinamento profissional para seus agentes. Vamos listá-las uma a uma:
InsForge (código aberto, Apache 2.0) atua como a camada de engenharia de contexto do backend para agentes que usam Habilidades e CLI. O perfil do nosso agente desenvolvedor backend usa essa habilidade para ter um serviço backend pronto para uso em projetos.
Primeiro, adicione a fonte de habilidades do InsForge:
1hermes skills tap add InsForge/insforge-skills
Depois, instale as habilidades do backend:
1hermes -p backend-developer skills install InsForge/insforge-skills/insforge --force
Da mesma forma, instalamos outras como insforge-cli (comandos de infraestrutura), insforge-debug (diagnóstico de falhas) e insforge-integrations (provedores de autenticação terceiros).
Aqui está como o agente desenvolvedor backend usa a habilidade para construir o backend do nosso projeto no InsForge.
Primeiro, o agente desenvolvedor backend cria um projeto chamado "Clone do Google Docs" no InsForge.
O painel mostra estatísticas do projeto como o número de Usuários, tabelas no Banco de Dados, Armazenamento e lista de Funções de Borda com código JavaScript/TypeScript implantado relacionado a autenticação, manipulação de documentos, etc.
Então, se você está construindo um engenheiro de backend com IA, dê uma olhada no InsForge →
(não esqueça de dar uma estrela 🌟)
Mais habilidades do Skills Hub
O Hermes também mantém um Skills Hub com 687 habilidades em 18 categorias: 87 integradas, 79 opcionais, 16 da Anthropic (frontend-design, pdf, pptx, docx, mcp-builder e mais) e 505 do LobeHub.
Para o desenvolvedor frontend, instale o frontend-design. Para o tester, instale o webapp-testing. Ambos estão disponíveis no Hub.
Passo 4: Inicializar o quadro e iniciar o gateway.
hermes kanban init cria ~/.hermes/kanban.db, o banco de dados SQLite que armazena todas as tarefas, contexto e histórico de execução.
Em seguida, configure o gateway de chat sob o perfil do gerente de projeto. Obtenha um token de bot do @BotFather no Telegram e seu ID de usuário do @userinfobot, então:
1hermes kanban init2hermes -p project-manager gateway setup3hermes -p project-manager gateway start
A conexão funciona 24/7, mantém o sistema ativo e torna o gerente de projeto acessível no Telegram.
Passo 5: Enviar seu primeiro projeto.
Envie uma mensagem para o gerente de projeto com o que você deseja construir. Ele divide o objetivo em tarefas, cria-as com links de dependência e o sistema as executa em ordem.
O painel
Execute hermes dashboard e abra http://127.0.0.1:9119. Você obtém uma coluna por status e atualizações ao vivo via WebSocket, sem necessidade de recarregar.
0:20
Painel Hermes Kanban
Dois controles valem a pena conhecer. Lanes by profile (Faixas por perfil) sub-agrupa a coluna "Em Andamento" por responsável, permitindo que você veja qual agente possui o quê rapidamente. Nudge dispatcher (Cutucar despachante) executa uma passagem imediatamente, em vez de esperar 60 segundos, o que ajuda logo após desbloquear uma tarefa.
Clique em qualquer cartão para abrir sua gaveta e ver o histórico completo de execução, o resultado e metadados de cada tentativa, além de campos editáveis para título, responsável, prioridade e dependências.
O que observar
Três modos de falha que valem a pena conhecer antes de uma carga de trabalho séria.
1. Sobrecarga do banco de dados. Com 2 a 4 agentes em paralelo, você nunca vai atingir isso. Com 10+ agentes escrevendo em alta frequência, as coisas ficam lentas. Limite com hermes kanban dispatch --max 4.
2. Exclusão do workspace temporário. Arquivos salvos em um workspace temporário desaparecem no momento em que a tarefa é marcada como concluída, porque o workspace temporário é limpo por design. Use worktree para tarefas de codificação ou coloque o caminho da pasta do projeto na descrição da tarefa para que o agente saiba onde salvar.
3. Saturação do modelo local. Contra um modelo local (Ollama, GPU local), o sistema pode lançar vários agentes de uma vez e sobrecarregar a GPU, o que desacelera a geração e aciona a parada automática. Para configurações locais, use hermes kanban dispatch --max 2. Para modelos baseados em API como Claude ou GPT-4o, isso raramente é um problema.
O panorama completo
Cada peça tem uma função:
- SOUL.md é a identidade fixa do agente: quem ele é e como pensa.
- Habilidades são as instruções passo a passo para tipos específicos de trabalho.
- Memória é o que o agente sabe sobre seu ambiente entre as sessões.
- Kanban é a camada de coordenação: estado compartilhado, transferência de contexto e um humano no loop em qualquer ponto.
Quatro perfis, quatro arquivos SOUL.md, um gateway start. Descreva o que você quer construir para o gerente de projeto no Telegram e veja o quadro encher.
Se você aprende melhor com vídeo, um guia completo do Hermes Kanban será lançado no YouTube e no X em alguns dias.
Obrigado por ler.
