📐 Regras simples
Manutenção sem regra vira "quando der tempo" — e nunca dá. Com regra simples, vira reflexo. Aqui estão as três que cobrem 90% dos casos:
1. Errou 2× → atualiza skill ou memória
Primeira vez é acaso, segunda é padrão. Quando o agente comete o mesmo erro 2 vezes, você abre a skill (se for procedimento) ou a memória (se for fato) e corrige na hora.
2. Repetiu instrução → vira skill
Se você está dando a mesma orientação ("faz X, depois Y, depois Z") pela 3ª vez, é hora de salvar como skill. "Isso aqui virou skill, salva." O agente cuida do resto.
3. Tom errado → ajusta soul
Quando o agente "sai do personagem" — formal demais, informal demais, frio quando deveria ser caloroso — não é bug, é soul.md desatualizado ou ambíguo. Ajuste 1-2 linhas e teste.
💡Frase mágica
"Isso aqui virou skill, salva." O agente cria SKILL.md no formato correto, salva em ~/.hermes/skills/, e na próxima invocação já está disponível. Você não precisa lembrar a sintaxe.
📖 Leitura periódica
Mensalmente, peça pro agente se auditar. É auditoria barata: você vê em 5 minutos o que está desatualizado, duplicado ou órfão. Sem isso, a memória vira lixão silencioso.
📋 Pedidos mensais
- •"Leia sua memória e me diga o que parece desatualizado"
- •"Leia seu soul e diga se ainda reflete como devo me comportar"
- •"Liste suas skills ativas e indique 3 que não foram usadas no último mês"
- •"Liste crons ativos e diga quais ainda fazem sentido"
⏰Automatize com cron
hermes cron create "1st of every month at 9:00" \
"Faça auditoria de memória, soul, skills e crons. \
Liste 3 itens pra podar. Aguardo aprovação." \
--deliver telegramVocê só aprova ou rejeita. Manutenção sem esforço deliberado seu, mas com você no loop pras decisões.
🧟 Stale memory é o #1
Memória desatualizada é a causa principal de "comportamento estranho" do Hermes. VPS antigo que migrou, projeto morto que continua sendo citado, preferência que mudou. O agente segue a memória — e parece "errado".
⚠️Sintomas de stale memory
- •Agente cita ferramenta que você não usa mais
- •Sugere reuniões/contatos com pessoas antigas
- •Preferências erradas ("você gosta de X" quando agora prefere Y)
- •Caminhos de arquivo errados (servidor antigo, pasta movida)
- •Tom inadequado pra fase atual da sua vida/projeto
📓Memória como diário, não log
Memory.md deve ser editada como diário, com versão atual dos fatos — não como log que acumula tudo. Quando algo muda na sua vida, peça:
"Atualiza memória: agora uso X em vez de Y. Remove referências antigas a Y."
🔍 Antes de qualquer debug
70% dos comportamentos estranhos do Hermes são fato desatualizado em memory.md. Antes de assumir bug do código, abra o arquivo. É o pulo do gato.
🔍 Quando algo quebrar: memory.md antes de tudo
Hermes é 90% Markdown. Skills, memória, soul, configs. Erros frequentemente são instrução antiga ou ambígua, não bug. Tenha um protocolo claro de debug que começa pelo texto.
📋 Protocolo de debug
- memory.md — fato desatualizado é a causa mais comum
- soul.md — tom ambíguo gera resposta errática
- skill envolvida — procedimento desatualizado ou conflitante com outra skill
- logs — só agora abrir
~/.hermes/logs/ - config — config.yaml, .env, plugins
- código — última fronteira; raramente é o problema
💬Frase pra delegar o debug
"Comportamento estranho em X. Audita memory, soul e skill relacionada antes de eu mexer no código. Me lista o que achou de inconsistente."
O agente faz o trabalho de auditoria. Você revisa e aprova mudanças. Economiza horas que iam pra debug em código.
💡 Filosofia do "Markdown first"
O design do Hermes intencionalmente coloca conhecimento em texto editável, não em banco oculto. Isso significa que texto é o primeiro lugar pra olhar. Quando você incorpora isso, debug fica mais barato e mais rápido.
🔐 Rotação e auditoria
Sem cadência, ninguém faz manutenção de segurança. Com cron, vira automático: o agente lembra você. É a diferença entre "tenho intenção de" e "está acontecendo".
🔑 Trimestral: rotação de tokens
Telegram, Gmail, GitHub, OpenRouter, Anthropic. Cada 3 meses, gere novos e revogue antigos. Cron lembra você a cada 90 dias com checklist do que rotacionar.
🧹 Mensal: review de skills
Cron mensal pede ao agente: "liste skills sem uso há 30+ dias, com sugestão de podar". Você aprova arquivamento ou exclusão.
🛡️ Semanal: auditoria de segurança
Skill bundled "auditoria de segurança" verifica portas abertas, processos novos, espaço em disco, logs anormais, chaves SSH. Cron toda 2ª-feira de manhã.
🎯 Por que tokens vencidos importam
Token de Telegram revogado é causa frequente de "gateway parado misteriosamente". Token expirado de provedor de inferência pode parar todos os crons. Rotação programada evita o caos.
🤝 Filosofia: agente é colega que aprende
Aqui vai o resumo filosófico que carrega tudo. Hermes não é uma ferramenta que termina — não é como um app que você instala e está pronto. É um colega: precisa de onboarding, contexto, correção e crescimento.
🎭Os dois jeitos de tratar
❌ Como ferramenta estática
"Instalei e está pronto." Não corrige, não atualiza, não treina. Em 60 dias, ele vira "aquele agente que tem mas eu não uso muito".
✅ Como colega que aprende
Onboarding cuidadoso, correção quando erra, atualização quando contexto muda. Em 60 dias, o agente está mais útil que no dia 1.
👤Mentalidade final
Você é o tech lead. Ele é o estagiário sênior. Cada um tem papel claro:
- •Você: aprova, corrige, ensina, define prioridades, audita
- •Ele: executa, lembra, sugere, automatiza, pergunta o que não sabe
Cada mês, mais alinhamento. Cada correção, mais inteligência. Cada skill nova, mais autonomia.
🌱O que você leva
Se há uma só coisa pra carregar dessas 6 trilhas: agente Hermes não é projeto que termina. É relação que cresce. Quem entende isso tem agente cada vez mais útil. Quem não entende, abandona em 60 dias.
🎯Resumo do módulo
Você concluiu o curso 🎉
Esta foi a última trilha. Agora é colocar em prática: comece com 1 agente, ative as rotinas, e deixe o tempo trabalhar a seu favor.