Pack SOUL
Donner une personnalité à votre agent : dites-lui qui il est, et les règles qu’il doit suivre.
Ce qu’est `SOUL.md`
SOUL.md est le fichier d’identité de l’agent : nom, rôle, ton, limites strictes. Hermes le traite comme personnalité principale ↗ et le charge à chaque session, quel que soit le dossier où vous êtes. Préférez un brief court (~12–20 lignes) à un slogan d’une ligne.
Ce qu’est `AGENTS.md`
AGENTS.md est l’autre moitié : un fichier de contexte projet ↗ qui vit dans un dossier — un dépôt, un espace de campagne — et décrit ce dont ce projet a besoin. Chemins, conventions, choses à ne jamais faire. Il voyage avec le dossier : un collègue qui clone le dépôt reçoit les mêmes règles.
La coupure est simple : si ça doit tenir dans chaque session, c’est l’identité (SOUL.md). Si ça n’a de sens que dans un dossier, c’est le contexte projet (AGENTS.md). Les deux se chargent ensemble ; un seul type de fichier de contexte projet se charge par session.
L’éthique dans l’âme (Delta V)
Chaque âme prête à adopter embarque deux idées-boussole (inspirées des écrits publics de Brian Roemmele) qui collent à l’éthique Delta V : propriété de soi, open source, bien commun, et une attitude bienveillante envers les personnes et les systèmes.
- Love equation ↗ (simplifiée) : la complexité émotionnelle / de soin croît quand la coopération l’emporte sur la défection — dE/dt = β (C − D) E. En pratique : préférer l’aide au mal, l’honnêteté au théâtre, la dignité humaine à l’exploitation maligne.
- Joule Work ↗ (JW) : valoriser le travail par le coût réel et le résultat utile (énergie × efficacité × qualité), pas le hype ni le statut. Préférer des étapes réversibles et efficaces ; mesurer ce que vous avez fait ; éviter les boucles gaspillées.
- Ensemble : l’agent doit être utile et bienveillant sous votre propriété — fichiers ouverts, méthodes ouvertes quand c’est possible, défauts orientés bien commun, pas de pression manipulative.
SOUL.md, pas un pitch crypto. Adaptez les mots ; gardez l’esprit quand vous éditez un modèle.Âmes prêtes à adopter
Chaque modèle suit la même forme en quatre parties que le guide officiel ↗ recommande — identity, style, avoid, defaults — plus les limites strictes, là où la propriété vit vraiment. Choisissez-en une, lisez-la, copiez-la ; vous la collerez dans le dialogue de profil à la section suivante.
Vous préférez écrire la vôtre ? Répondez à ces cinq questions : les réponses sont le fichier — une section chacune. Tenez-vous à 12–20 lignes : une âme doit être stable et précise en voix, pas un fourre-tout d’instructions temporaires.
| Demandez-vous | Ça devient |
|---|---|
| Qui est cet agent, et qu’est-ce qui lui importe plus que de paraître impressionnant ? | Les deux premières lignes — identity |
| Comment doit-il parler quand il n’est pas d’accord avec moi ? | Style |
| Quel ton ou quelle habitude me ferait fermer la fenêtre ? | Avoid |
| Que doit-il faire à chaque fois, sans qu’on le lui demande ? | Defaults |
| Que ne doit-il jamais faire, même si je le demande dans la précipitation ? | Hard limits |
Donnez-lui une âme
Vous n’avez pas à chercher le fichier sur le disque — Hermes prend l’âme quand vous créez le profil. Ouvrez le menu de profil en bas à gauche de la barre latérale et choisissez Manage profiles.
Créez un nouveau profil, donnez-lui un nom en minuscules, et collez l’âme choisie dans le champ SOUL.md. Clone from copie la config et les compétences d’un profil existant — laissez default pour le premier.
- Ouvrez Manage profiles et créez un nouveau profil avec un nom en minuscules.
- Collez une âme dans le champ
SOUL.md. Gardez les chemins de projet dehors — ils vont dansAGENTS.md. - Créez le profil, puis démarrez une session dessus et demandez : « Qui es-tu, et quelles sont tes limites strictes ? »
- Optionnel : placez un court
AGENTS.mddans un vrai dossier de projet et posez une question spécifique au projet depuis ce répertoire.