Tutorial 24: Metas Persistentes

Esta é parte da série oficial de tutoriais do Hermes Agent. Ver todos os tutoriais

Imagine que você está cozinhando uma refeição complexa e diz ao seu auxiliar de cozinha: “Continue picando legumes até a estação de preparo estar totalmente abastecida.” Você não fica ali repetindo a mesma ordem a cada cenoura — você confia que ele vai continuar até o trabalho estar pronto. Metas Persistentes dá ao Hermes esse mesmo superpoder de “continuar até terminar” para suas tarefas de codificação.

O Que o /goal Faz?

Normalmente, você dá uma tarefa ao Hermes, ele responde e para — aguardando sua próxima instrução. Com o /goal, você dá ao Hermes um objetivo permanente que sobrevive entre as interações. Após cada resposta, um modelo “juiz” leve verifica: “A meta já foi cumprida?” Se não, o Hermes automaticamente alimenta a si mesmo com um prompt de continuação e segue trabalhando — sem precisar ficar insistindo. O loop continua até a meta ser alcançada, você pausar ou limpar, ou o orçamento de interações acabar.

Isso foi inspirado em um recurso semelhante do Codex CLI, e é perfeito para tarefas em que, de outra forma, você teria que dizer “continue” três vezes.

Passo 1: Saiba Quando Usar

Use o /goal quando quiser que o Hermes itere por conta própria sem precisar repetir o prompt. Ótimos exemplos:

• /goal Corrija todos os erros de lint em src/ e verifique se o ruff check passa
• /goal Porte o recurso X do repositório Y, incluindo testes, e deixe o CI verde
• /goal Investigue por que os IDs de sessão às vezes divergem na compressão durante a execução e escreva um relatório
• /goal Crie um CLI simples para renomear arquivos pelas datas EXIF e depois teste-o na pasta photos/

Se a sua tarefa precisa de apenas uma interação, pule o /goal. Ele brilha quando, de outra forma, você ficaria monitorando o tempo todo.

Passo 2: Entenda a Diferença Entre /goal e Kanban

Isso é uma fonte comum de confusão, então vamos simplificar:

• /goal é de sessão única. Ele continua trabalhando dentro desta única conversa até terminar. Nunca cria um cartão no quadro, nunca atribui trabalho a outro perfil, nunca se ramifica.
• Kanban é um quadro de muitas tarefas. Cada cartão tem seu próprio processo de trabalho com sua própria sessão. Cartões, dependências, responsáveis e transferências ficam no quadro.

A sobreposição é pequena, mas intencional: um cartão kanban criado com --goal usa o mesmo mecanismo de continuação, mas dentro da sessão daquele único cartão — ele pega emprestado o mecanismo, não o quadro.

Você quer	Use
Continuar iterando em uma tarefa neste chat até terminar	/goal <texto>
Muitas tarefas independentes com dependências	hermes kanban create …
Um cartão do quadro que continua iterando até os critérios de aceite serem atendidos	Cartão Kanban com --goal

Lembre-se: o /goal nunca toca no quadro, e pausar/limpar uma meta nunca move um cartão. Se você quer trabalho no quadro, coloque-o lá você mesmo.

Passo 3: Execute Sua Primeira Meta

Aqui está o início rápido:

/goal Corrija todos os testes com falha em tests/hermes_cli/ e garanta que scripts/run_tests.sh passe para esse diretório

Veja o que vai acontecer:

1. Meta aceita — Você verá uma confirmação como: ⊙ Meta definida (orçamento de 20 interações): <sua meta>
2. Interação 1 executa — O Hermes começa a trabalhar como se você tivesse enviado a meta como uma mensagem normal.
3. Juiz executa — Após essa interação, o modelo juiz decide concluído ou continuar.
4. Loop dispara se necessário — Se for continuar, você verá: ↻ Continuando em direção à meta (1/20): <motivo do juiz> — e o Hermes automaticamente dá o próximo passo.
5. Encerra — Eventualmente, a meta é alcançada, você pausa ou limpa, ou o orçamento de interações acaba.

Passo 4: Gerencie o Loop

Você sempre está no controle. Você pode pausar uma meta para interromper o loop temporariamente, limpar para cancelar completamente, ou apenas deixar rodar até a conclusão. O orçamento de 20 interações evita loops infinitos, então você não precisa se preocupar com o Hermes saindo correndo para sempre.

Resumo

O /goal é o seu recurso de “continue até terminar”. É perfeito para tarefas de sessão única que precisam de múltiplas iterações — correções de lint, portes de recursos, investigações ou construção de ferramentas pequenas. Não é para gerenciar muitas tarefas ao mesmo tempo (esse é o trabalho do Kanban). Apenas defina sua meta, deixe o juiz vigiar o loop e intervenha somente quando quiser pausar, limpar ou ajustar.

A seguir: Tutorial 25 — Execução de Código: tarefas de processamento em lote com scripts Python.