AGENTS.md: Arbeitsanweisungen für deinen OpenClaw-Agenten

Grundregeln für die Arbeit

Wie soll der Agent an Aufgaben herangehen? Typische Regeln sind:

• Implementiere statt vorzuschlagen
• Lies vor dem Ändern
• Teste nach jeder Änderung
• Frag nur, wenn es kritisch ist

Workflow-Definitionen

Wie soll der Agent bei bestimmten Aufgaben vorgehen? Zum Beispiel: Bei neuen Features erst den bestehenden Code lesen, dann einen Plan erstellen, dann implementieren, dann testen.

Verbotsliste (Anti-Patterns)

Fehler, die der Agent nicht wiederholen soll. Zum Beispiel:

• Sag nie "fertig" ohne Beweis
• Schlag nicht Optionen A, B, C vor — wähle die beste und setze sie um
• Frage nie "soll ich das fixen?" bei offensichtlichen Bugs

Tool-spezifische Regeln

Welche Tools darf der Agent nutzen? Welche API-Keys verwenden? Welche Verzeichnisse beschreiben?

---

Ohne AGENTS.md verhält sich dein Agent wie ein höflicher, aber unselbstständiger Praktikant. Er fragt bei jeder Kleinigkeit nach, schlägt Optionen vor statt zu handeln, und verläuft sich bei komplexen Aufgaben.

Mit einer guten AGENTS.md arbeitet er wie ein erfahrener Mitarbeiter: Er weiß, wann er autonom entscheiden kann, wann er fragen muss, und wie er seine Arbeit dokumentiert.

---

Regel	Was sie bewirkt
Ausführen statt vorschlagen	Agent implementiert Änderungen direkt, statt Optionen zu präsentieren
Autonomie-Prinzip	Standardmäßig weiterarbeiten. Nicht fragen "soll ich weitermachen?"
Anti-Pattern: "fertig" ohne Beweis	Kein "done" ohne Artefakt (Link, Test-Output, Commit-Hash)
Anti-Pattern: "Soll ich den Bug fixen?"	Offensichtliche Bugs sofort fixen, nicht fragen

---

• Fange klein an. Du musst nicht sofort eine 20-seitige AGENTS.md schreiben. Starte mit 5 Grundregeln und erweitere sie, wenn du merkst, welches Verhalten du ändern willst.
• Nutze das Anti-Pattern-Register. Jedes Mal, wenn dein Agent etwas Dummes macht, füge es als Anti-Pattern hinzu. So wird die AGENTS.md über die Zeit immer besser.
• Halte sie spezifisch. Sage nicht "sei gründlich", sondern: "Prüfe nach jeder Code-Änderung, ob die Tests noch grün sind."
• Agenten-übergreifend standardisieren. Wenn du mehrere Agenten hast, sollten die Grundregeln für alle gelten. Agenten-spezifische Regeln können in separaten Dateien stehen.

---

• SOUL.md erklärt: So gibst du deinem Agenten eine Persönlichkeit
• MEMORY.md: Wie dein Agent sich erinnert
• OpenClaw Multi-Agent: Mehrere Agenten einrichten
• CLAUDE.md erklärt: Das eine File, das deinen Agenten kennt