SOUL
Define postura, prioridades, limites e tom.
Aula prática · Hermes Agent
Crie sua primeira agente.
Você não começa pela ferramenta. Começa definindo quem a agente é, quem ela atende, o que ela precisa lembrar e como deve agir em cada projeto.
Uma agente não é um prompt longo.
É um sistema simples de contexto: identidade permanente, perfil da pessoa, memória durável, regras do projeto e procedimentos que podem ser reaproveitados.
USER
Registra preferências duráveis de quem a agente atende.
MEMORY
Guarda fatos operacionais que precisam sobreviver à conversa.
AGENTS
Define escopo, fontes de verdade, aprovações e segurança.
01 · O papel de cada arquivo
Cada informação no lugar certo.
Separar os arquivos deixa a agente mais clara, mais fácil de ajustar e menos dependente de um contexto gigantesco.
SOUL.md
Quem a agente é, como decide e como se comunica. Não use como manual de ferramenta ou diário.
$HERMES_HOME/SOUL.mdUSER.md
Fuso, idioma, preferências e restrições estáveis da pessoa atendida.
$HERMES_HOME/memories/USER.mdMEMORY.md
Convenções, ambiente e aprendizados duráveis. Não guarda tarefas que vencem amanhã.
$HERMES_HOME/memories/MEMORY.mdAGENTS.md
O que fazer, onde consultar, quando confirmar e como entregar naquele trabalho.
pasta-do-projeto/AGENTS.md02 · Critério
O que cabe. O que não cabe.
01
SOUL é identidade
Use para postura, prioridades, limite de autonomia e tom. Não coloque caminhos de arquivos, processos longos, credenciais ou regras de um único cliente.
02
Memória não é histórico
Registre somente o que continua útil daqui a semanas. Conversas, tarefas concluídas e detalhes que vencem rápido ficam fora.
03
AGENTS é instrução local
Use para o trabalho atual. Em uma pasta, o Hermes carrega uma fonte de contexto pela ordem de prioridade. Não duplique a mesma regra em vários arquivos.
04
Skill é procedimento
Se uma tarefa se repete, transforme o passo a passo em skill. Assim você não aumenta a memória nem depende de repetir instruções no chat.
03 · Agora construímos
Primeira configuração, em cinco passos.
Dê nome e mandato
Escreva quem é a agente, para quem ela trabalha e qual problema principal ela ajuda a resolver.
Resultadoum SOUL objetivo
Defina preferências duráveis
Idioma, fuso, tom, objetivo, formato de resposta e limites importantes da pessoa atendida.
Resultadoum USER enxuto
Crie as regras do primeiro projeto
Liste fontes de verdade, alçadas, cuidados de segurança e como a entrega deve ser comprovada.
Resultadoum AGENTS útil
Instale nos lugares certos
Renomeie os dois templates e coloque cada arquivo no caminho indicado no kit.
Resultadocontexto carregável
Teste com trabalho real
Peça uma ação pequena, interna e verificável. Revise o resultado e registre só o aprendizado que se provar recorrente.
Resultadoprimeira evidência
04 · Limites de contexto
Menos contexto. Mais precisão.
O Hermes reserva memória para fatos curados. Mantenha os arquivos bem abaixo dos limites. Use este contador apenas para rascunho local, sem enviar o texto a nenhum servidor.
Contador de memória
Cole um rascunho de USER ou MEMORY para conferir o tamanho antes de instalar.
0 caracteres
USER.md
Até 1.375 caracteres. Preferências da pessoa, não instruções longas.
MEMORY.md
Até 2.200 caracteres. Fatos duráveis, não um backlog.
05 · Teste de aceite