Hermes-Profile dienen der Zustandstrennung, nicht dem Rollenspiel. Ein Profil ist sinnvoll, sobald eine wiederkehrende KI-Rolle eigenen Speicher, eigene Sitzungen, Skills, eine SOUL.md-Identität, Cron-Ownership oder eine Gateway-Route benötigt.
Ein Assistent kann viele Fragen beantworten. Dauerhaftes Zuhause für Rechercheurteil, Schreibstil, Shell-Logs, Kalenderregeln, geplante Jobs und Nachrichtenrouting gleichzeitig zu sein, sollte er nicht werden.
Schwache Prompts wirken oft wie die Ursache. Geteilter Zustand ist meistens der eigentliche Grund für das Versagen. Dieser Leitfaden zeigt, wann ein Hermes-Profil berechtigt ist, wie man es aus einem funktionierenden Setup heraus anlegt und wie ein kleines Profilteam nicht wieder zum lauten Generalisten verfällt.
- Ein Profil anlegen, wenn Zustand getrennt bleiben soll. Speicher, Sitzungen, Tools, Cron und Gateway-Routen sind stärkere Argumente als Tonalität.
- Prompts für einmaliges Verhalten, Skills für wiederverwendbare Abläufe, Profile für dauerhafte Rollen. Wer diese Ebenen vermischt, häuft Kontext-Schulden an.
- Mit einem Koordinator und zwei Spezialisten beginnen. Scout für Recherche, Scribe für Texte und Forge für Build und Debugging kommen nur dann dazu, wenn die Grenze real ist.
- SOUL.md wie eine Stellenbeschreibung verfassen. Standards, Standardwerte und Ablehnungsregeln gehören hinein, keine vage Persönlichkeit.
- Handoffs definieren, bevor weitere Agenten hinzukommen. Ein Profilteam funktioniert nur, wenn Ergebnisse sauber zwischen den Rollen weitergegeben werden.
Falls KI-Arbeit im Team bereits über Prompts, Chats, Skripte und geplante Aufgaben verstreut ist, kann webvise die erste saubere Profilgrenze kartieren, bevor das System schwerer zu prüfen wird.
Der Fehler: ein Assistent für fünf Aufgaben
Der typische Einstieg ist vernünftig. Ein Assistent recherchiert einen Markt, entwirft einen Beitrag, debuggt ein Skript, fasst ein Meeting zusammen und beobachtet einen Kalender. Am ersten Tag bricht nichts zusammen.
Nach drei Wochen hinterlässt jeder Arbeitsablauf Rückstände. Recherche schreibt Quellenregeln fest, Texte prägen den Ton, Debug-Sitzungen speichern fehlgeschlagene Befehle, Kalenderarbeit fügt Planungsannahmen hinzu. Jede neue Aufgabe muss sich durch all das hindurcharbeiten.
Das ist Kontext-Schuld. Der Assistent wird unzuverlässig, wenn unzusammenhängende Arbeit Speicher, Sitzungen, Tools und Standardwerte teilt.
Hermes-Profile setzen die Grenze. Eine Rolle trägt den Zustand, den sie braucht, ohne ihn jeder anderen Rolle aufzuzwingen.
Profile sind isolierte Umgebungen, keine Kostüme
Eine Persona verändert, wie ein Assistent spricht. Ein Hermes-Profil verändert, was er trägt, erinnert, plant und womit er verbunden ist.
Hermes 0.9.0 führte Profile als isolierte Agentenumgebungen ein. Konfiguration, Sitzungen, Speicher, Skills, Persönlichkeit, Cron-Zustand und Gateway-Zustand lassen sich so trennen. Das macht ein Profil zu einer Laufzeitgrenze, nicht zu einem Schreibstil.
| Ebene | Was die Trennung verhindert |
|---|---|
| Speicher | Rechercheregeln, wiederkehrende Annahmen und alte Entscheidungen, die in unzusammenhängende Arbeit einfließen |
| Sitzungen | Entwürfe, Shell-Logs, Strategiediskussionen und Kalendernotizen, die in einer einzigen Zeitleiste zusammenbrechen |
| Skills | Jede Rolle scannt oder lädt Tools, die sie nicht benötigt |
| Identität | Eine generische Stimme, die gleichzeitig Rechercheur, Redakteur, Operator und Entwickler spielt |
| Cron state | Mehrere geplante Jobs, die dasselbe Ergebnis beanspruchen |
| Gateway state | Die falsche Rolle beantwortet die falsche Telegram- oder Nachrichtenroute |
Der entscheidende Test: Zwei Rollen, die nicht dieselben Fehler, Annahmen oder halbfertigen Aufgaben erinnern sollen, gehören wahrscheinlich in getrennte Profile.
Profil, Prompt, Skill, AGENTS.md oder SOUL.md?
Unübersichtliche Agentensetups entstehen meist daraus, dass eine einzige Ebene für jedes Problem herhalten muss. Profile sind nicht die Antwort auf jeden Anpassungsbedarf.
| Bedarf | Diese Ebene verwenden |
|---|---|
| Verhalten für eine Aufgabe ändern | Prompt |
| Einen Ablauf aufgabenübergreifend wiederverwenden | Skill |
| Projektpfade, Befehle und Konventionen bereitstellen | AGENTS.md |
| Dauerhafte Rollenidentität und Standards festlegen | SOUL.md |
| Speicher, Sitzungen, Skills, Cron oder Gateway-Zustand trennen | Profil |
| Mehrere Profile und Handoffs koordinieren | TEAM.md |
Profile entstehen nicht aus Stimmungen heraus. Sie entstehen, wenn eine Rolle Zustand besitzt, der eine andere Rolle schlechter machen würde.
Wann ein Profil seinen Platz verdient
Ein gutes Profil rechtfertigt sich dadurch, dass es Rauschen reduziert. Ändert es nur den Namen im Terminal-Prompt, löschen Sie es oder wandeln Sie die Anweisung in einen Skill um.
| Profil anlegen, wenn | Kein Profil anlegen, wenn |
|---|---|
| Die Rolle wöchentlich oder täglich wiederkehrt | Die Aufgabe einmalig ist |
| Es Speicher benötigt, der nicht in andere Arbeit fließen soll | Nur der Ton sich ändert |
| Es einen eigenen Gateway oder geplanten Job besitzt | Dieselben Tools, derselbe Kontext und dasselbe Ausgabeformat verwendet werden |
| Es ein anderes Risikoniveau oder eine andere Berechtigungsgrenze hat | Nicht beschrieben werden kann, was es produzieren soll |
| Es Arbeit an ein anderes Profil weitergibt | Kein Handoff oder Quality Gate existiert |
Die klarste Regel ist einfach: Ein Profil soll an einer Aufgabe besser werden, ohne die anderen Aufgaben lauter zu machen.
Ein kleines Hermes-Profilteam
Ausgangspunkt sind Rollen, keine geliehenen Charakternamen. Hermes bleibt Koordinator. Scout für Recherche, Scribe für Texte und Forge für Build und Debugging kommen hinzu, sobald jede Rolle eine echte Grenze hat.
| Profil | Verantwortlichkeit | Soll produzieren | Soll nicht produzieren |
|---|---|---|---|
| Hermes | Planen, routen, sequenzieren und prüfen | Aufgabenaufteilung, Delegation, abschließende Synthese, Quality Gate | Rohe Recherche-Dumps oder ungeprüfte Code-Änderungen |
| Scout | Untersuchen, vergleichen und verifizieren | Aussagen mit Quellen, Daten, Konfidenz und Vorbehalten | Polierter Text, der Unsicherheit verbirgt |
| Scribe | Verifizierten Stoff in Kommunikation übersetzen | Entwürfe, Überarbeitungen, Struktur, Zielgruppenpassung | Unbelegte Behauptungen oder erfundene Belege |
| Forge | Bauen, debuggen, testen und berichten | Diffs, ausgeführte Befehle, Testergebnisse, Restrisiken | Strategietexte ohne Umsetzungsnachweis |
Die Namen sind Platzhalter. Das Produkt ist die Grenze. Umbenennen ist erlaubt; die Aufgaben getrennt zu halten, nicht.
Ein sinnvoller erster Pilot umfasst nur zwei Profile: Hermes koordiniert, Scout verifiziert. Sobald Scout zuverlässig belegte Aussagen liefert, kommt Scribe dazu, um daraus Texte zu machen. Forge kommt erst dann hinzu, wenn Implementierungsarbeit den Rest des Assistenten belastet.
Profile aus einer funktionierenden Basis erstellen
Spezialisten werden nicht von Grund auf neu aufgebaut. Zunächst muss das Standard-Hermes-Setup funktionieren: Provider, Modell, API-Schlüssel, Tools und normaler Terminal-Betrieb.
- Rechercheprofil anlegen: `hermes profile create scout --clone`
- Schreibprofil anlegen: `hermes profile create scribe --clone`
- Entwicklungsprofil anlegen: `hermes profile create forge --clone`
- Profilübersicht prüfen: `hermes profile list`
- Spezialisten direkt starten: `hermes -p scout`, `hermes -p scribe` oder `hermes -p forge`
`--clone` empfiehlt sich, wenn das Basis-Setup gesund ist. Die nützliche Konfiguration wird übernommen, während das neue Profil Speicher und Sitzungshistorie isoliert hält.
Lässt sich nicht benennen, welchen Zustand das neue Profil besitzen soll, ist hier Schluss. Wahrscheinlich ist ein Prompt, ein Skill oder ein AGENTS.md-Eintrag die richtige Lösung.
SOUL.md wie eine Stellenbeschreibung verfassen
SOUL.md ist der Ort, an dem ein Profil zur echten Rolle wird. Dauerhafte Identität gehört hinein: Standardwerte, Standards, Stilpräferenzen, Ablehnungsregeln und Entscheidungsstil.
AGENTS.md ist anders. Projektkontext gehört hinein: Repository-Pfade, Befehle, Konventionen, Review-Prozess und Tool-Regeln. Wer Identität und Projektkontext vermischt, verwandelt einen klaren Spezialisten wieder in einen vagen Generalisten.
| Datei | Gehört hinein | Gehört nicht hinein |
|---|---|---|
| SOUL.md | Rollenidentität, Standards, Ablehnungsregeln, Entscheidungsstil | Temporäre Repository-Notizen oder Kundenanweisungen |
| AGENTS.md | Projektpfade, Befehle, Konventionen, Workflow-Regeln | Die gesamte Persönlichkeit des Profils |
| TEAM.md | Roster, Handoffs, Eskalationsregeln, Richtlinienobergrenzen | Alle privaten Anweisungen aller Profile |
- Scout SOUL.md: vor dem Zusammenfassen verifizieren, Belege von Interpretation trennen, Daten angeben, Unsicherheit kennzeichnen.
- Scribe SOUL.md: für den Zielleser schreiben, Belege-Grenzen einhalten, Struktur vor Stil verbessern, bei fehlender Grundlage nachfragen.
- Forge SOUL.md: vor dem Ändern reproduzieren, den kleinstmöglichen sicheren Fix umsetzen, die relevante Prüfung ausführen, berührte Dateien und Restrisiko melden.
Handoffs definieren, bevor weitere Profile hinzukommen
Profile brauchen Verträge untereinander. Ein Handoff ist ein Quality Gate zwischen Rollen.
| Handoff | Erforderlicher Inhalt | Ablehnen, wenn |
|---|---|---|
| Scout an Scribe | Aussage, Quell-URL, Datum, Konfidenz, Vorbehalt | Der Input nur rohe Auszüge enthält |
| Scribe an Hermes | Entwurf, Zielleser, Annahmen, offene Fragen | Der Text schwache Belege verbirgt |
| Forge an Hermes | Änderungsübersicht, berührte Dateien, ausgeführte Befehle, Tests, Restrisiko | Der Bericht ohne Nachweis behoben meldet |
Übergibt Scout eine Notizsammlung an Scribe, übernimmt Scribe die Rolle des Rechercheurs. Berichtet Forge behoben ohne Befehle oder Tests, kann Hermes die Arbeit nicht prüfen. Schlechte Handoffs machen aus einem Profilteam eine Kette von Vermutungen.
Ist unklar, ob eine Grenze ein Profil, ein Skill oder eine Projektregel sein soll, kann webvise das Handoff- und Ownership-Modell kartieren, bevor es an der falschen Stelle kodiert wird.
Gateway- und Cron-Zustand sind Teil der Architektur
Profile werden deutlich nützlicher, sobald Nachrichten und geplante Jobs ins System kommen. Eine Telegram-Route, ein Webhook oder ein Cron-Job schafft Ownership.
| Route oder Zeitplan | Eigentümer-Profil | Erwartete Ausgabe |
|---|---|---|
| Allgemeine Telegram-Anfrage | Hermes | Ziel klären, Arbeit routen, abschließende Antwort zurückgeben |
| Quellenprüfungsanfrage | Scout | Gerankte Aussagen mit Quellen und Vorbehalten |
| Texterstellungsanfrage | Scribe | Strukturierter Entwurf oder Überarbeitung |
| Build- oder Debug-Alert | Forge | Reproduktion, Diff, Testergebnis, Risikohinweis |
| Wöchentlicher Profil-Audit | Hermes | Prüfung von Drift, Speicher, Cron und Handoffs |
Verbleiben alle geplanten Jobs unter dem Standard-Profil, kollabiert das Team langsam wieder zu einem einzigen Assistenten. Den Job der Rolle zuzuweisen, die das Ergebnis besitzt, und Zusammenfassungen an Hermes zurückzurouten, verhindert das.
Erste-Woche-Setup und der 30-Tage-Audit
Die erste Woche beweist eine saubere Grenze.
- Den Workflow identifizieren, der am meisten Kontext-Verschmutzung erzeugt.
- Ein Spezialistenprofil mit `--clone` anlegen.
- Eine kurze SOUL.md für diese Rolle verfassen.
- Einen Eingabe- und einen Ausgabe-Handoff definieren.
- Das Profil direkt mit `hermes -p <Profil>` starten.
- Gateway- oder Cron-Ownership bewusst zuweisen.
| 30-Tage-Prüfung | Fehlersignal | Lösung |
|---|---|---|
| Profil-Drift | Der Spezialist beginnt, unzusammenhängende Arbeit anzunehmen | SOUL.md verschärfen und neue Regeln in AGENTS.md oder TEAM.md verschieben |
| Speicher-Verfall | Alte Annahmen werden zu Standardwerten | Veraltete Notizen prüfen und Widersprüche entfernen |
| Handoff-Verfall | Profile geben Rohmaterial statt geformter Ausgabe weiter | Fehlerhafte Handoffs blockieren den nächsten Schritt |
| Cron-Kollision | Zwei Profile planen Arbeit für dasselbe Ergebnis | Ein gemeinsames Cron-Ownership-Register führen |
| Gateway-Verwirrung | Das falsche Profil beantwortet eine eingehende Route | Eigentümer, Auslöser, Ausgabe und Eskalationspfad dokumentieren |
| Skill-Wildwuchs | Jedes Profil lädt jeden Workflow | Abläufe in rollenspezifische Skills auslagern |
Hermes 0.12.0 hat Curator für die Skill-Pflege eingeführt, was auf die übergeordnete Regel verweist: Agentensysteme brauchen Haushaltsführung. Profile reduzieren Rauschen, müssen aber trotzdem regelmäßig geprüft werden.
Die Betriebsregel
Erfolg misst sich nicht an der Zahl der Profile. Die Frage ist, ob jede Rolle schärfer werden kann, ohne den Rest des Systems schwerer vertrauenswürdig zu machen.
Das beste Hermes-Profilteam ist jenes, in dem jede Rolle eigenen, klar abgegrenzten Zustand besitzt, saubere Handoffs sendet und eng genug bleibt, um geprüft zu werden.
webvise hilft Teams, unstrukturierte KI-Nutzung in rollenbasierte Systeme mit klarem Kontext, sicheren Handoffs und messbarer Ownership zu überführen. Einen überlasteten Assistenten und einen wiederkehrenden Workflow mitbringen, und webvise kartiert die ersten zwei Profile gemeinsam mit Ihnen.
Die Praktiken von webvise sind an den ISO 27001- und ISO 42001-Standards ausgerichtet.