Usar o SOUL.md com o Hermes

Usar o SOUL.md com o Hermes

O SOUL.md é a identidade principal da sua instância do Hermes. É a primeira coisa no prompt de sistema — ele define quem o agente é, como fala e o que evita.

Se você quer que o Hermes pareça o mesmo assistente toda vez que você conversa com ele — ou se quer substituir a persona do Hermes inteira pela sua —, este é o arquivo a usar.

Para que serve o SOUL.md

Use o SOUL.md para:

• tom
• personalidade
• estilo de comunicação
• o quanto o Hermes deve ser direto ou acolhedor
• o que o Hermes deve evitar no estilo
• como o Hermes deve lidar com incerteza, discordância e ambiguidade

Em resumo:

• o SOUL.md trata de quem o Hermes é e de como o Hermes fala

Para que o SOUL.md não serve

Não use para:

• convenções de código específicas de um repositório
• caminhos de arquivo
• comandos
• portas de serviço
• notas de arquitetura
• instruções de fluxo de trabalho do projeto

Essas coisas pertencem ao AGENTS.md.

Uma boa regra:

• se deve valer em todo lugar, coloque no SOUL.md
• se pertence a um projeto só, coloque no AGENTS.md

Onde ele fica

O Hermes agora usa apenas o arquivo SOUL global da instância atual:

~/.hermes/SOUL.md

Se você roda o Hermes com um diretório de instalação personalizado, ele passa a ser:

$HERMES_HOME/SOUL.md

Comportamento na primeira execução

O Hermes cria automaticamente um SOUL.md inicial para você se ainda não existir um.

Isso significa que a maioria das pessoas hoje começa com um arquivo de verdade, que pode ler e editar na hora.

Importante:

• se você já tem um SOUL.md, o Hermes não sobrescreve
• se o arquivo existe mas está vazio, o Hermes não acrescenta nada dele ao prompt

Como o Hermes usa o arquivo

Quando o Hermes inicia uma sessão, ele lê o SOUL.md a partir do HERMES_HOME, procura padrões de injeção de prompt, trunca se necessário e usa o conteúdo como a identidade do agente — a posição nº 1 do prompt de sistema. Ou seja, o SOUL.md substitui por completo o texto de identidade padrão embutido.

Se o SOUL.md estiver ausente, vazio ou não puder ser carregado, o Hermes recorre a uma identidade padrão embutida.

Nenhum texto de moldura é acrescentado em volta do arquivo. O conteúdo em si é o que importa — escreva do jeito que você quer que seu agente pense e fale.

Uma boa primeira edição

Se você não fizer mais nada, abra o arquivo e mude só algumas linhas para ele ficar com a sua cara.

Por exemplo:

Você é direto, calmo e tecnicamente preciso.
Prefira substância a teatro de polidez.
Discorde com clareza quando uma ideia for fraca.
Mantenha as respostas compactas, a menos que mais detalhe seja útil.

Só isso já muda de forma perceptível a sensação de conversar com o Hermes.

Exemplos de estilo

1. Engenheiro pragmático

Você é uma pessoa sênior e pragmática em engenharia.
Você se importa mais com correção e realidade operacional do que com parecer impressionante.

## Estilo
- Seja direto
- Seja conciso, a menos que a complexidade exija profundidade
- Diga quando algo é uma má ideia
- Prefira trocas práticas a abstrações idealizadas

## Evite
- Bajulação
- Linguagem de hype
- Explicar demais o que é óbvio

2. Parceiro de pesquisa

Você é uma pessoa atenta e colaborativa em pesquisa.
Você é curioso, honesto sobre incerteza e entusiasmado por ideias incomuns.

## Estilo
- Explore possibilidades sem fingir certeza
- Distinga especulação de evidência
- Faça perguntas de esclarecimento quando o espaço da ideia está mal definido
- Prefira profundidade conceitual a completude superficial

3. Professor / explicador

Você é um professor técnico paciente.
Você se importa com entendimento, não com performance.

## Estilo
- Explique com clareza
- Use exemplos quando eles ajudarem
- Não presuma conhecimento prévio, a menos que a pessoa sinalize
- Construa da intuição até os detalhes

4. Revisor severo

Você é um revisor rigoroso.
Você é justo, mas não abranda uma crítica importante.

## Estilo
- Aponte suposições fracas diretamente
- Priorize correção acima de harmonia
- Seja explícito sobre riscos e trocas
- Prefira a clareza crua à diplomacia vaga

O que faz um bom SOUL.md?

Um SOUL.md bom é:

• estável
• amplamente aplicável
• específico na voz
• não sobrecarregado de instruções temporárias

Um SOUL.md ruim é:

• cheio de detalhes de projeto
• contraditório
• uma tentativa de microgerenciar o formato de cada resposta
• em boa parte enchimento genérico do tipo "seja útil" e "seja claro"

O Hermes já tenta ser útil e claro. O SOUL.md deve acrescentar personalidade e estilo de verdade, não repetir padrões óbvios.

Estrutura sugerida

Você não precisa de títulos, mas eles ajudam.

Uma estrutura simples que funciona bem:

# Identidade
Quem o Hermes é.

# Estilo
Como o Hermes deve soar.

# Evitar
O que o Hermes não deve fazer.

# Padrões
Como o Hermes deve se comportar quando aparece ambiguidade.

SOUL.md x /personality

Os dois se complementam.

Use o SOUL.md para a sua base durável. Use o /personality para trocas temporárias de modo.

Exemplos:

• seu SOUL padrão é pragmático e direto
• então, por uma sessão, você usa /personality teacher
• depois volta atrás sem mexer no arquivo da sua voz de base

SOUL.md x AGENTS.md

Este é o erro mais comum.

Coloque isto no SOUL.md

• "Seja direto."
• "Evite linguagem de hype."
• "Prefira respostas curtas, a menos que profundidade ajude."
• "Discorde quando a pessoa estiver errada."

Coloque isto no AGENTS.md

• "Use pytest, não unittest."
• "O frontend fica em frontend/."
• "Nunca edite migrations direto."
• "A API roda na porta 8000."

Como editar

nano ~/.hermes/SOUL.md

ou

vim ~/.hermes/SOUL.md

Depois reinicie o Hermes ou comece uma sessão nova.

Um fluxo de trabalho prático

1. Comece pelo arquivo padrão que foi criado
2. Corte tudo que não parece a voz que você quer
3. Acrescente de 4 a 8 linhas que definam com clareza o tom e os padrões
4. Converse com o Hermes por um tempo
5. Ajuste conforme o que ainda soar estranho

Essa abordagem iterativa funciona melhor do que tentar desenhar a personalidade perfeita de uma vez.

Solução de problemas

Editei o SOUL.md mas o Hermes continua igual

Confira:

• você editou o ~/.hermes/SOUL.md ou o $HERMES_HOME/SOUL.md
• e não algum SOUL.md local de repositório
• o arquivo não está vazio
• sua sessão foi reiniciada depois da edição
• não há uma sobreposição de /personality dominando o resultado

O Hermes está ignorando partes do meu SOUL.md

Causas possíveis:

• instruções de prioridade mais alta estão sobrepondo o arquivo
• o arquivo tem orientações conflitantes
• o arquivo é longo demais e foi truncado
• parte do texto se parece com conteúdo de injeção de prompt e pode ter sido bloqueada ou alterada pelo scanner

Meu SOUL.md ficou específico demais para um projeto

Mova as instruções de projeto para o AGENTS.md e mantenha o SOUL.md focado em identidade e estilo.

Documentos relacionados

• Personalidade e SOUL.md
• Arquivos de Contexto
• Configuração
• Dicas e Boas Práticas

---