Boas Práticas — 10 Dicas

Pense no Hermes Agent como um chef em uma cozinha movimentada. Você não deixaria todos os cozinheiros cortando vegetais na mesma tábua enquanto montam sobremesas — você daria a cada um sua própria estação. A mesma lógica se aplica ao seu código.

---

1. Um Worktree por Experimento

Imagine que você está pintando uma casa. Você não pintaria a sala e o banheiro ao mesmo tempo com o mesmo pincel — você estragaria os dois. Os worktrees do Git permitem que você dê a cada tarefa do Hermes sua própria “sala” para trabalhar.

Em vez de deixar o Hermes editar arquivos diretamente na sua pasta principal do projeto, crie um espaço de trabalho separado para cada experimento. Isso mantém seu código principal seguro e suas alterações organizadas.

2. Nomeie as Branches de Acordo com o Experimento

Dê às suas branches nomes claros e descritivos para que você (e o você do futuro) saiba para que cada uma serve:

git checkout -b feature/hermes-checkpoints-docs

Nada de branch-1 ou test-fix. Seja específico — você vai se agradecer depois.

3. Faça Commits com Frequência

Pense em commits como salvar seu progresso em um videogame. Você não quer jogar por três horas e perder tudo porque não salvou.

Faça commits em marcos importantes:

git add .
git commit -m "Add checkpoint documentation"

Para edições menores e orientadas por ferramentas entre esses marcos, use os checkpoints do Hermes e o /rollback como uma rede de segurança.

4. Evite Rodar a Partir da Raiz do Repo

Ao usar worktrees, não rode o Hermes a partir da pasta original do repositório. Em vez disso, use cd para entrar no diretório do worktree. Isso dá a cada agente um escopo claro e previne contaminação cruzada acidental.

5. Use hermes -w para Worktrees Automáticos

Não quer configurar worktrees manualmente? O Hermes tem um atalho embutido:

cd /path/to/your/repo
hermes -w

Isso cria automaticamente um worktree descartável com sua própria branch. Você pode até combiná-lo com uma única consulta:

hermes -w -z "Fix issue #123"

6. Rode Agentes em Paralelo com Segurança

Quer que vários agentes do Hermes trabalhem ao mesmo tempo? Basta abrir vários terminais e rodar hermes -w em cada um. Cada sessão ganha seu próprio worktree e branch isolados automaticamente. Chega de agentes pisando nos pés uns dos outros.

7. Use Checkpoints + /rollback

Erros acontecem. Tudo bem. O Hermes permite que você crie checkpoints durante uma sessão e volte a eles se algo der errado. É como ter um botão “desfazer” para as ações do seu agente.

8. Combine Worktrees, Branches e Checkpoints

Aqui está a fórmula vencedora:

• Worktrees = checkouts limpos para cada sessão
• Branches = histórico de alto nível dos experimentos
• Checkpoints + /rollback = recuperação rápida de erros

Juntos, eles te dão iteração rápida, recuperação fácil e pull requests limpos.

9. Lide com o Desenvolvimento de UI de Forma Inteligente

Se você está trabalhando no TUI ou no aplicativo desktop em vários worktrees, você vai precisar de node_modules para cada um. Isso é muita duplicação de arquivos. Confira os helpers htui / hgui que compartilham uma única instalação via symlink — isso economiza espaço em disco e tempo de configuração.

10. Mantenha Sua Branch Principal Limpa

O objetivo de todas essas práticas é manter sua branch principal estável e pronta para produção. Só faça merge das branches dos worktrees quando elas estiverem testadas e completas.

---

Resumo

Pense nos worktrees como mesas separadas em um escritório. Cada agente do Hermes ganha sua própria mesa com suas próprias ferramentas, para que ninguém estrague o trabalho do outro. As branches são seu sistema de arquivamento, e os checkpoints são seus post-its de “eu estive aqui”.

Dica prática: Comece apenas com hermes -w na sua próxima tarefa. É a maneira mais fácil de obter isolamento sem configuração manual. Quando estiver confortável, adicione checkpoints e rollback ao seu fluxo de trabalho. Você vai se perguntar como trabalhou sem eles.

---