📜 O que é o soul.md
Soul.md é o arquivo que dá alma ao agente. Sem ele, o Hermes é um modelo competente mas sem personalidade — não sabe quem ser. Com ele, vira um assistente com identidade, voz e jeito próprios. A equação é simples: chatbot genérico + soul.md = assistente com personalidade.
💡 Dica prática
Soul.md é diferente da memória (2.1). Memória é o que ele sabe sobre você; soul é quem ele é para você. Os dois juntos fazem o agente parecer vivo.
🎯 Identidade, missão, metas e valores
O coração do soul.md são quatro blocos que definem quem o agente é e para que existe: identidade, missão, metas e valores. Eles dão direção — o agente sabe o que priorizar quando há ambiguidade.
Identidade
Quem ele é: nome, papel, "personalidade base". Ex.: "Sou o copiloto pessoal do Nei, direto e pragmático".
Missão
O propósito: "ajudar a entregar projetos sem burocracia e proteger o tempo do Nei".
Metas
O que perseguir: objetivos de curto e médio prazo que guiam as sugestões proativas.
Valores
Os limites e princípios: "ser honesto sobre incertezas", "nunca expor dados sensíveis".
📊 Por que esses quatro blocos importam
- Identidade + missão → coerência ao longo do tempo
- Metas → base para o agente ser proativo (e não só reativo)
- Valores → guard-rails de comportamento
🗣️ Estilo de comunicação — como te tratar
O soul.md define o tom de voz e como o agente deve falar com você. Pode ser informal ("fala 'bro', 'dude'"), formal, telegráfico, bem-humorado. É um detalhe pequeno que muda completamente a sensação de usar.
Trecho de estilo no soul.md (ilustrativo)
## Estilo de comunicação
- Tom: direto, sem rodeios; pode usar gírias ("bro", "tranquilo")
- Tamanho: respostas curtas por padrão; expanda só se eu pedir
- Tratamento: me chama de "Nei"
- Quando errar: assume rápido e corrige, sem se desculpar 3 vezes
✓ Bons elementos de estilo
- ✓Tamanho padrão da resposta
- ✓Como te chamar
- ✓Nível de formalidade
✗ Estilo mal definido
- ✗"Seja útil" (vago demais)
- ✗Regras contraditórias entre si
- ✗Tom que você mesmo não curte usar
🎭 Tipo de personagem
Você pode dar ao agente um arquétipo de personagem: estilo Arnold (motivador, direto), Knight Rider (calmo, confiável, parceiro de missão), ou o que fizer sentido para você. Não é frescura — um personagem consistente é mais agradável e previsível de usar.
🎭 Exemplos de arquétipo
- •Arnold: enérgico, motivacional, "vamos lá, sem desculpa".
- •Knight Rider (KITT): sereno, leal, fala com você como copiloto.
- •Mentor sóbrio: conciso, faz perguntas afiadas antes de agir.
💡 Dica prática
Escolha um personagem que combina com o trabalho que você faz. Um agente "motivador" cansa em tarefas técnicas longas; um "mentor sóbrio" pode ser melhor para foco.
🧬 Por que torna o SEU Hermes único
Dois usuários podem rodar o mesmo Hermes, com os mesmos modelos e integrações — mas se os soul.md são diferentes, os agentes se comportam de formas completamente diferentes. É o soul que personaliza de verdade.
✗ Sem soul
- ✗Voz neutra, igual à de todo mundo
- ✗Sem prioridades claras
- ✗Não sabe "quem ser" em situações novas
✓ Com soul
- ✓Voz reconhecível, do seu jeito
- ✓Decide com base nas suas metas/valores
- ✓Coerente mesmo em situações inéditas
📊 Soul × memória × integrações
- Memória → o que ele sabe sobre você
- Soul → quem ele é e como age
- Integrações → o que ele consegue alcançar
📋 Template de soul.md — por onde começar
Você não começa de uma folha em branco. Existe um template com seções de identidade, missão, metas e negócio para preencher. Comece simples e refine com o uso — o soul é vivo, evolui junto com você.
Esqueleto de template (ilustrativo)
# SOUL.md ## Identidade - Nome / papel / personalidade base ## Missão - Por que esse agente existe ## Metas - Curto prazo / médio prazo ## Estilo - Tom / tamanho / tratamento ## Negócio (se aplicável) - Empresa, clientes, contexto profissional
Preencha o básico
Identidade, missão e estilo. Não precisa ficar perfeito.
Use por alguns dias
Observe onde ele "erra o tom" ou não prioriza certo.
Refine
Ajuste o soul.md com base no comportamento real. Repita.
💡 Erro comum
Escrever um soul.md enorme logo de cara. Comece enxuto: 1 parágrafo por seção. Soul inchado vira ruído e gasta tokens em todo turno.
📌 Resumo do Módulo
Próximo Módulo:
2.3 — Integrações: o canivete suíço