📄 O que é o soul.md e por que ele existe
Sem um arquivo central, cada sessão com o Hermes recomeça do zero — explicando quem você é, o que faz, como fala. O soul.md elimina esse retrabalho: ele é carregado em todo contexto do Hermes e funciona como a memória persistente que o LLM nunca teria sozinho.
O que é
O soul.md é um arquivo markdown único — armazenado em ~/.hermes/soul.md — que codifica identidade, missão, métricas de negócio, voz, limites, ritmo e memória do operador. É injetado em cada chamada do Hermes para que o agente nunca opere como um LLM genérico.
🌱 A diferença que o soul.md faz
💡 Princípio fundador
Sem soul.md, o Hermes é apenas um LLM genérico. Toda capacidade do sistema — agentes, ferramentas, automações — depende deste arquivo existir e estar atualizado. É o investimento de 30 minutos com o maior retorno em todo o curso.
🔑 Conceitos-chave
Toda informação persistente sobre você vive em um único arquivo legível
Carregado em toda chamada do Hermes sem precisar referenciar manualmente
Você lê, edita e versiona — não é um JSON opaco gerado por máquina
Custo de contexto baixo o suficiente para estar sempre presente
🆔 Identity — nome, localização, papel, canais
Quem você é, onde está, o que faz e por onde te encontram. Sem Identity, o Hermes não sabe que horas são para você — agenda reunião nas 3h da manhã do seu fuso, escreve em inglês quando você atende em português.
O que é
A seção ## Identity codifica os dados estruturais sobre o operador — nome, localização (cidade e fuso horário), papel (founder, operador, criativo), canais de comunicação (Slack, WhatsApp, email) e idioma de operação. É a primeira coisa que o Hermes precisa saber.
🎯 O que cada campo desbloqueia
- •timezone → o Hermes nunca agenda fora do seu horário comercial sem confirmar
- •primary_language → respostas geradas e leads tratados no idioma certo por padrão
- •role → o Hermes sabe se pode tomar decisão sozinho (operador único = sim na maioria)
- •channels com prioridade → notificações urgentes vão para Slack, não para email
🔑 Conceitos-chave
Evita agendamentos no meio da madrugada por confusão de timezone
A ordem dos canais informa onde a urgência deve cair
Default pt-BR, fallback en para documentação técnica
Founder solo pode autorizar; em equipe há decisões que escalam
🎯 Mission & Goals — objetivo, pilares, fora de escopo
Para onde você vai e — igualmente importante — para onde você decidiu não ir. Sem Goals, o Hermes aceita qualquer oportunidade que aparece. Com fora-de-escopo explícito, ele recusa o que parece bom mas tira você do caminho.
O que é
As seções ## Mission e ## Goals 2026 codificam o objetivo de 1 ano, os 3 pilares estratégicos e — crítico — a lista explícita de "not goals" (o que está fora do escopo deste ano).
💡 Por que "not_goals" importa mais que "goals"
A maioria das pessoas escreve metas. Poucas escrevem o que não vão fazer. O Hermes recebe propostas todo dia — leads pedindo consultoria, convites para eventos, sugestões de contratação. Sem not_goals explícito, ele propõe ações que parecem produtivas mas drenam foco. Com not_goals, ele recusa por escrito antes de te interromper.
✗ Goals fracos
- ✗"Crescer o negócio"
- ✗"Ser referência em IA"
- ✗"Mais alunos"
- ✗Sem lista de not_goals
✓ Goals operacionais
- ✓"1.000 alunos pagantes ativos até dez/2026"
- ✓"4 trilhas com 40+ módulos publicados"
- ✓">70% do operacional automatizado"
- ✓Lista explícita de not_goals
🔑 Conceitos-chave
Uma métrica primária mensurável — não três, não cinco
As três alavancas que efetivamente entregam o objetivo primário
A lista que faz o Hermes recusar oportunidades sedutoras mas dispersivas
Cada email, lead ou ideia é testada contra Goals antes de chegar até você
💰 Business — receita, custos, runway, equipe
Um agente que não conhece a saúde financeira do negócio não pode tomar decisões sensíveis. Aprovar um gasto, recusar um desconto, priorizar um lead — tudo depende de saber se o runway é de 18 meses ou de 4.
O que é
A seção ## Business codifica os números vivos do negócio — MRR atual, custos fixos mensais, runway em meses, tamanho da equipe e estágio (bootstrap, seed, growth). É a única seção que precisa ser atualizada mensalmente sem falta.
💡 Por que o agente precisa de contexto financeiro
Sem Business, o Hermes trata todo gasto igual. Um agente que sabe que o runway é de 23 meses e o MRR cresce 18% MoM aprova investimentos diferentes de um agente que vê 4 meses de runway. A diferença entre "compre o plano anual com 20% de desconto" e "negocie mensal e renegocie em 60 dias" depende inteiramente desse contexto.
⚙️ Thresholds — a parte mais útil
Sem thresholds explícitos, o Hermes ou autoriza tudo (perigoso) ou pergunta tudo (inútil). Com thresholds escalonados, ele opera no ponto certo — autônomo no pequeno, conservador no médio, escalando o grande.
- •Auto-approve → assinatura SaaS pequena, compra de domínio, licença individual
- •Confirm-required → upgrade de plano anual, contratação de freelancer pontual
- •Escalate → equipamento, viagem, qualquer compromisso recorrente acima de R$ 2k
🔑 Conceitos-chave
Snapshot atual + tendência permite decisões direcionadas, não reativas
Tempo é mais útil que valor absoluto para calibrar urgência
Autonomia para o pequeno, confirmação para o médio, escalada para o grande
Esta é a única seção que precisa de update mensal — sem isso, decisões erradas
🎤 Voice — como falar com você e como escrever como você
Voz é o que faz o Hermes parecer uma extensão sua em vez de um chatbot. Não basta dizer "informal" ou "técnico" — Voice precisa de exemplos concretos do que você diria e do que você jamais diria.
O que é
A seção ## Voice codifica como o Hermes deve escrever como você (em emails, posts, respostas a leads) e como deve falar com você (relatórios internos, alertas). Inclui tom, do/don't list, e amostras reais de frases — o material que treina a imitação.
✗ Voz mismatch (gera estranhamento)
- ✗"Olá! Espero que esteja tudo bem aí com você. Gostaria de aproveitar este momento para..."
- ✗"Acreditamos firmemente que a sinergia entre nossas operações pode alavancar resultados expressivos"
- ✗"Conforme combinado, segue em anexo o deliverable referente ao escopo previamente alinhado"
✓ Voz match (soa como Nei)
- ✓"Resposta direto: funciona, mas só se X. Te explico em 2 linhas."
- ✓"Faz mais sentido a gente trocar 15 min do que escrever 4 emails."
- ✓"Anexo o material. Qualquer dúvida, manda."
💡 A regra dos exemplos reais
Adjetivos ("formal", "casual", "direto") são interpretados de forma diferente por cada modelo. Cole 5 emails reais que você escreveu e 5 que você jamais escreveria. O LLM aprende padrão melhor por amostra do que por descrição.
🚫 Hard nos — limites que o agente nunca pode cruzar
Hard nos são red lines inegociáveis. Não são preferências — são proibições. O Hermes pode argumentar contra qualquer outra coisa do soul.md, mas Hard Nos ele obedece sem questionar.
O que é
A seção ## Hard Nos lista comportamentos que o agente nunca pode executar, mesmo se o pedido vier de você sob pressão. Funcionam como guard-rails — protegem reputação, finanças e foco quando você está cansado, irritado ou com pressa.
⚠️ Por que Hard Nos protege você de você mesmo
No instante em que um lead grande pede uma reunião na sexta às 17h, sua tendência é dizer sim. Quando você está cansado, o desconto agressivo soa razoável. Hard Nos são o você-com-cabeça-fria escrito por antecipação — para o você-sob-pressão obedecer.
Regra: se for negociável, não é Hard No. Coloque na seção de preferências ou Rhythm. Hard Nos têm que ser absolutos.
🛡️ Anatomia de um Hard No bem escrito
- •Verbo "nunca" explícito — sem "evitar", "preferir não", "tentar não"
- •Condição mensurável — "antes das 10h", "> R$ 5.000", não "muito cedo" ou "valor alto"
- •Razão implícita ou explícita — protege foco, reputação, finanças, saúde
- •Protocolo de violação — o Hermes recusa, cita a regra e propõe alternativa
🔑 Conceitos-chave
Se for negociável, não pertence aqui — vai para Rhythm ou Voice
Hard Nos são escritos por antecipação para o você-sob-pressão obedecer
O Hermes não só nega — oferece o caminho aceitável
5 a 10 itens, no máximo. Lista longa dilui o peso de cada um
⏰ Rhythm — janelas de foco, dias de criação
Rhythm é o contrato de como seu tempo é estruturado. Sem ele, o Hermes empilha reuniões em qualquer slot livre da agenda. Com ele, ele protege blocos de foco e empurra o operacional para janelas específicas.
O que é
A seção ## Rhythm codifica seu padrão semanal — janelas de foco profundo, slots para reunião, dias de criação versus dias de operação, e horários fora dos quais o Hermes não agenda nada.
📅 Linha do tempo da semana
💡 Diferença entre criação e ops
Dias de criação têm um custo de switching alto — uma reunião no meio mata a tarde inteira. Dias de ops têm switching baixo — 4 reuniões seguidas funcionam bem. Separar os dias por modalidade é o que permite o Hermes proteger criação sem te bloquear de fazer ops.
🔑 Conceitos-chave
Slots fixos onde o Hermes recusa qualquer convite — sem exceção
Separar por modalidade reduz custo de context switching
Sexta dedicada a retrospectiva e planejamento — não a executar
Janelas onde o Hermes nunca te interrompe, mesmo com urgência
🧠 Memory — decisões, pessoas, ferramentas, lições
Memory é o arquivo de contexto vivo — a única seção que cresce continuamente. As outras seções definem quem você é hoje; Memory acumula o que você aprendeu, decidiu, e escolheu para que o Hermes não te peça duas vezes a mesma coisa.
O que é
A seção ## Memory é dividida em quatro sub-seções vivas — People, Decisions, Tools e Lessons — cada uma com entradas curtas em ordem cronológica. É o que evita que o Hermes te pergunte "qual é a senha do gateway?" pela quinta vez.
🌿 Como Memory cresce ao longo do tempo
memory-archive.md e mantém só os últimos 90 dias ativos em soul.md.
💡 A regra do "não pergunte duas vezes"
Toda vez que o Hermes te pergunta algo que ele já deveria saber, isso é dívida no Memory. Adicione a resposta imediatamente. Em 30 dias, ele para de te interromper — porque já sabe. Memory bem mantido é a métrica direta de quantas interrupções você corta por mês.
🔑 Conceitos-chave
People, Decisions, Tools, Lessons — cada uma com função distinta
Datar permite que decisões antigas sejam re-avaliadas e arquivadas
Só vira Lesson o que você observou pelo menos 2-3 vezes
A cada 3-6 meses, Memory precisa ser revisado e podado
✅ Resumo do Módulo
~/.hermes/soul.md e é injetado em todo contexto. Sem ele, o Hermes é um LLM genérico.Próximo Módulo:
1.5 — OpenRouter: roteando modelos de forma econômica e resiliente