1. Kontext vorne liefern, Ergebnis hinten prüfbar machen
„Prüfe den Fehler“ zwingt den Agenten, Umgebung, Datei, Erwartung und Reproduktion zu erraten. Ein guter Auftrag nennt Ziel, relevanten Pfad, beobachtetes Verhalten, erwartetes Verhalten, Grenzen und das gewünschte Ergebnisformat. Das reduziert Rückfragen, Tool-Aufrufe und falsche Annahmen.
| Vage | Besser |
|---|---|
| Mach SEO | Prüfe diese 20 URLs auf Canonical, Status, Title, interne Links und Aktualität; liefere priorisierte Befunde, noch keine Änderungen |
| Fix den Server | Analysiere den fehlgeschlagenen systemd-Dienst anhand dieser Logs; nur lesen, Ursache und kleinsten reversiblen Fix vorschlagen |
| Schreib einen Artikel | Erstelle aus diesen Primärquellen einen deutschen Entwurf für Rolle X, mit klarer These, Quellenlinks und markierten Unsicherheiten |
2. AGENTS.md, SOUL.md, Memory und Skills nicht vermischen
Kontextdateien werden immer wieder geladen und kosten Tokens. Halte sie kurz, aktuell und hierarchisch. Der Agent entdeckt Unterverzeichnis-AGENTS.md bei der Arbeit; Spezialregeln müssen deshalb nicht in den globalen Projektkopf kopiert werden.
| Mechanismus | Gehört hinein | Gehört nicht hinein |
|---|---|---|
AGENTS.md | Architektur, Befehle, Projektkonventionen, Grenzen | Persönliche Biografie und temporärer Taskstatus |
SOUL.md | Dauerhafte Kommunikationsweise und Werte | Repository-spezifische Build-Schritte |
| Memory | Stabile Fakten, Präferenzen, Umgebungsbesonderheiten | Lange Verfahren und laufende Todo-Listen |
| Skill | Wiederholbares mehrstufiges Verfahren | Einmalige Notiz oder ungeprüfte Vermutung |
| Session | Aktueller Auftrag, Entscheidungen und Ergebnisse | Unbegrenzt wachsende globale Regeln |
3. Memory speichert Fakten, Skills speichern Verfahren
Ein Skill ist ein Cache für erprobtes Vorgehen. Er lohnt sich, wenn eine Aufgabe mehrere Schritte umfasst und wiederkehrt. Gute Skills definieren Voraussetzungen, Inputs, Prüfpunkte, Fehlerwege und Ausgabe. Sie dürfen sich verbessern, brauchen aber regelmäßige Audits – sonst wird aus Lernen unbemerkte Prozessdrift.
- Nach komplexen erfolgreichen Aufgaben bewusst fragen: Welcher Teil ist stabil und wiederverwendbar?
- Secrets, absolute persönliche Pfade und temporäre IDs nicht in Skills einbetonieren.
- Skills nach Softwareupdates und Prozessänderungen gegen einen Testfall ausführen.
- Widersprüchliche oder doppelte Skills konsolidieren.
- Memory-Einträge korrigieren, wenn sich Umgebung oder Präferenz ändert; alte Fakten nicht einfach daneben stehen lassen.
4. Sessions benennen, komprimieren und bewusst wechseln
Lange Sessions werden teurer und verlieren trotz Kompression Randbedingungen. Benenne wichtige Sessions mit /title, prüfe Verbrauch über /usage und komprimiere mit /compress, bevor Kontextgrenzen erreicht werden. Beginne für ein neues Projekt lieber eine neue Session als einen alten Universalchat weiterzuschleppen.
/title auth-refactor
/usage
/compress
# später fortsetzen:
hermes -r "auth-refactor"5. Automatisierung erst nach manueller Zuverlässigkeit
- 01
Manuell ausführen
Mindestens zehn repräsentative Fälle inklusive Fehlerfälle prüfen.
- 02
Deterministische Schritte abtrennen
Dateierkennung, Duplikate und einfache Filter in Code ausführen.
- 03
Prompt selbstständig machen
Cron-Sessions haben keinen alten Chatkontext; alle Pfade, Ziele und Grenzen angeben.
- 04
Read-only starten
Berichten und Entwürfe vor externen Änderungen priorisieren.
- 05
Budget und Laufzeit setzen
Ein Job ohne Stop-Bedingung ist nicht produktionsreif.
- 06
Fehler zustellen
Keine stille Erfolgsannahme; Ausfälle und unvollständige Daten sichtbar melden.
6. Subagenten für unabhängige Teilaufgaben, nicht für Unklarheit
Parallelisierung spart Zeit, wenn Teilaufgaben wirklich unabhängig sind: drei Themen recherchieren oder getrennte Testpakete prüfen. Sie verschärft Chaos, wenn das Ziel unklar ist. Jeder Subagent braucht Scope, Input, erwartetes Artefakt, Dateigrenzen und Abbruchkriterium.
- Ein Agent besitzt die Synthese und löst Widersprüche.
- Keine zwei Agenten gleichzeitig dieselbe Datei bearbeiten lassen, außer mit klarer Branch-/Worktree-Strategie.
- Nur notwendige Kontextteile delegieren; riesige Gesprächsverläufe nicht kopieren.
- Kosten und Laufzeit pro Teilaufgabe beobachten.
- Ergebnisse über Tests und Artefakte verifizieren, nicht über Selbstbericht der Subagenten.
7. Sicherheit und Kosten sind dieselbe Betriebsdisziplin
Unbegrenzte Rechte und unbegrenzte Budgets haben dasselbe Muster: Ein Fehler skaliert unkontrolliert. Verwende Docker oder andere Isolation für unbekannten Code, Messenger-Allowlisten, getrennte Secrets und Freigaben für irreversible Aktionen. Setze gleichzeitig Providerlimits, Cron-Frequenzen und Hard Stops.
| Risiko | Technische Grenze |
|---|---|
| Fremder Nutzer steuert Bot | Allowlist oder Pairing |
| Prompt-Injection löst Host-Befehl aus | Container, minimale Mounts, Approval |
| Cron-Schleife verbraucht Budget | Laufzeitlimit, Modelllimit, monatlicher Hard Stop |
| Skill driftet | Versionierung, Testfall, regelmäßiger Audit |
| Secret landet im Kontext | Secret Store, getrennte Env-Datei, Output-Redaktion |
| Agent ändert Produktion | Staging, Freigabe, Rollback und getrennte Rollen |
8. Monatlicher Agenten-Review
- Welche Jobs erzeugten ein tatsächlich genutztes Ergebnis?
- Welche Tool-Fehler oder Korrekturen wiederholen sich?
- Welche Skills, MCP-Server und Provider werden nicht mehr gebraucht?
- Welche Keys, Pairings und Nutzer können entzogen werden?
- Welche Kontextdatei ist gewachsen, obwohl sie kürzer werden sollte?
- Wo lässt sich ein stabiler LLM-Schritt durch Code ersetzen?
- Welche autonome Berechtigung würde heute nicht erneut erteilt?
Ein guter Hermes-Betrieb wächst nicht nur an Fähigkeiten. Er entfernt regelmäßig Komplexität. Das Ziel ist ein kleineres, klareres System, das mehr verlässliche Arbeit erledigt – nicht die größte Sammlung von Skills und Integrationen.
Häufige Fragen
Was gehört in AGENTS.md?
Wann sollte Hermes einen Skill erstellen?
Wie oft sollte ich Sessions komprimieren?
Soll Hermes immer in Docker laufen?
Quellen, Methodik und Aktualität
Dieser Beitrag wurde aus praktischer Arbeit mit Hermes Agent und den unten verlinkten Primärquellen erstellt. Produktstände ändern sich schnell; Versions- und Befehlsangaben wurden zuletzt am geprüft.
- Tips & Best Practices – Nous Research
- Skills System – Nous Research
- Memory – Nous Research
- Security – Nous Research