Um guia completo do Hermes Kanban: o modelo de coordenação, compartilhamento de contexto entre agentes e a criaçã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 realmente acontece é o oposto. Agentes começam do zero. Um agente não sabe o que os outros construíram, quais arquivos foram alterados ou como é a API. Cada passagem de bastão é um começo frio, e o trabalho se degrada no momento em que passa de um agente para o próximo.
O Hermes Kanban resolve isso. Cada tarefa sobrevive a falhas e reinicializações. Cada briefing carrega exatamente o que o próximo agente precisa. Cada falha é salva, para que a repetição saiba o que quebrou.
É assim que sua central de comando se parece:
Painel Kanban
A melhor parte é que todo o time funciona a partir do seu celular. Você cria e direciona tarefas pelo Telegram, e os agentes as assumem enquanto você está longe do computador.
Veja só:
Neste artigo, construímos essa configuração completa do zero: o modelo de coordenação, os briefings e um time de software de 4 membros rodando em 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 por exatamente esse time de agentes.
Demonstração do clone do Google Docs
Então, sem mais delongas, vamos direto ao assunto.
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 testador 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 do que ele economiza.
Dividir o trabalho entre agentes que cada um possui um 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 agentes ficam atrás das colunas
Uma tarefa tem um título, uma descrição, um responsável e um status. Alguém a pega, move-a 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 falhas 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 percepção. É 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 limitação de taxa de autenticação" antes de você ter uma especificação completa.
- A Fazer: Tarefa criada, mas aguardando uma dependência. Não se moverá 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 é executado até que você o 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 típica ação do 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 senha esquecida/redefinição + 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ência 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 testador 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 como pronta. 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, é assim que se parece.
Quando o agente backend chama kanban_complete(), a tarefa frontend passa para pronta com o trabalho do backend anexado.
2. Humano no circuito: 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 repetidos em 30 min)")
Você vê o bloqueio no painel. Você verifica o problema, corrige-o e desbloqueia a tarefa:
1hermes kanban unblock $IMPL
Você também não executa isso no terminal; apenas comente no quadro Kanban ou envie uma 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 vaga 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 vaga2hermes kanban create "autenticação precisa de limitação 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 real.
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 aplicativo de um 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, funções5de 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. Testador em ~/.hermes/profiles/tester/SOUL.md:
1# Alma23Você é o testador de um time de software. Você testa funcionalidades concluídas4de ponta a ponta, verifica se os critérios de aceitação foram atendidos e relata bugs5claramente 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 fazer 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 de backend para agentes usando Habilidades e CLI. Nosso perfil de agente desenvolvedor backend usa essa habilidade para ter um serviço de backend pronto para uso para projetos.
Primeiro, adicione a fonte de habilidades do InsForge:
1hermes skills tap add InsForge/insforge-skills
Em seguida, instale as habilidades de 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 de terceiros).
Veja 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 "Google Docs Clone" 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 de IA, confira o 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 frontend-design. Para o testador, instale 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 cada tarefa, 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 horas por dia, 7 dias por semana, mantém o sistema ativo e torna o gerente de projeto acessível pelo 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 Running (Em Execução) por responsável, para que você possa ver 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 com o histórico completo de execução, o resultado e metadados de cada tentativa, e campos editáveis para título, responsável, prioridade e dependências.
O que observar
Três modos de falha que vale 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 chegará a isso. Com 10+ agentes escrevendo em alta frequência, as coisas ficam lentas. Limite com hermes kanban dispatch --max 4.
2. Exclusão do espaço de trabalho temporário. Arquivos salvos em um espaço de trabalho temporário desaparecem no momento em que a tarefa é marcada como concluída, porque o espaço 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 retarda 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 quadro completo
Cada peça tem um trabalho:
- 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 circuito em qualquer ponto.
Quatro perfis, quatro arquivos SOUL.md, um gateway start. Descreva o que você deseja construir para o gerente de projeto no Telegram e veja o quadro se encher.
Se você aprende melhor com vídeo, um tutorial completo do Hermes Kanban será lançado no YouTube e no X em alguns dias.
Obrigado por ler.
