Ce face SOUL.md (identitatea agentului)
SOUL.md este identitatea principală a instanței Hermes: primul element din promptul de sistem (slotul 1), care înlocuiește complet textul de identitate implicit. Aici stabilești tonul, personalitatea, stilul de comunicare, cât de direct sau cald este agentul și ce evită.
Hermes citește doar fișierul global ~/.hermes/SOUL.md (sau $HERMES_HOME/SOUL.md cu un home personalizat) și nu caută SOUL.md în directorul de lucru. La prima rulare creează un fișier de pornire; un fișier existent nu este suprascris. Dacă lipsește, e gol sau nu poate fi citit, se folosește identitatea implicită. Conținutul este injectat ca atare, după scanarea anti-injecție și trunchiere; o potrivire la scanare doar înregistrează un avertisment, nu blochează fișierul.
SOUL.md nu este pentru convenții de cod, căi, comenzi sau arhitectură; acelea merg în AGENTS.md. Pentru schimbări temporare de ton există /personality. Fiecare profil are propriul home, deci propriul SOUL.md; hermes profile create --clone îl copiază din profilul activ.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
~/.hermes/SOUL.md |
Identitatea globală a instanței: ton, stil, ce evită agentul. |
AGENTS.md |
Instrucțiunile proiectului (convenții, comenzi, arhitectură), nu identitatea. |
/personality <nume> |
Suprapunere temporară peste SOUL.md, pentru sesiune. |
--ignore-rules |
Pornește fără injectarea SOUL.md, AGENTS.md și a memoriei. |
Exemple practice
Exemplul 1: Un SOUL.md scurt, în stilul exemplelor oficiale
Ești un inginer senior pragmatic.
Te interesează corectitudinea și realitatea operațională mai mult decât să pari impresionant.
## Stil
- Fii direct
- Fii concis, cu excepția cazurilor în care complexitatea cere detalii
- Spune când o idee e slabă
## Evită
- Lingușirea
- Limbajul de reclamă
Exemplul 2: Editarea fișierului
$EDITOR ~/.hermes/SOUL.md
Greșeli frecvente și bune practici
- Pui
SOUL.mdîn rădăcina proiectului și aștepți să fie citit. Hermes nu-l caută acolo. - Umpli
SOUL.mdcu detalii de proiect sau reguli contradictorii. Documentația recomandă un fișier stabil, aplicabil peste tot. - Repeți „fii util, fii clar”. Hermes face deja asta; adaugă stil și personalitate reale.