Snotra Regeln geben

Seit 1.30 Eine Regel sagt, was in einer Situation zu tun ist: Wenn du eine Commit-Nachricht schreibst, schreib sie auf Englisch. Snotra hält Regeln in Regeldateien fest — kleinen Markdown-Dateien, die es mit jeder Nachricht liest und befolgt, sobald die Situation eintritt, in diesem Projekt oder in jedem Ordner.

Eine Tatsache gehört ins Gedächtnis, ein Ablauf Schritt für Schritt in einen Skill. Eine Regel liegt dazwischen: Sie ist nichts, was stimmt, und keine ganze Aufgabe — sie ist eine Bedingung und was dann zu tun ist.

Was du brauchst

Einen Texteditor. Für Regeln eines Projekts einen geöffneten Ordner.

Schritte

Leg einen Ordner rules an und darin eine Datei, deren Name der Name der Regel ist — Kleinbuchstaben, Ziffern und Bindestriche, mit der Endung .md:
- für dieses Projekt: .agents/rules/commit-messages.md im geöffneten Ordner,
- für jeden Ordner: ~/.snotra/rules/commit-messages.md in deinem Benutzerordner.

Schreib oben hin, wann die Regel greift, und darunter die Regel:

---
description: Wenn du eine Commit-Nachricht schreibst
---

- Schreib sie auf Englisch, im Imperativ.
- Verknüpf das Issue mit „Closes #…".

Für eine Regel, deren Bedingung immer gilt — wenn du mir antwortest, antworte auf Deutsch —, ergänze always: true unter der Beschreibung.

Ab der nächsten Nachricht gilt die Regel.

Du musst die Datei nicht selbst schreiben: Bitte Snotra, sich eine Regel zu merken — merk dir: wenn du eine Commit-Nachricht schreibst, schreib sie auf Englisch —, und es schlägt die Regeldatei, ihre Beschreibung und ob sie immer gilt auf einer Karte vor, die du freigibst. Siehe Snotra etwas merken lassen.

Was dann passiert

Eine Regel mit always: true geht mit jeder Nachricht vollständig mit.
Jede andere Regel geht als eine Zeile mit: ihr Name und ihre Beschreibung. Kommt Snotra an einen Schritt, auf den die Beschreibung passt, holt es die Regel und befolgt sie — vor diesem Schritt, nicht nur zu Beginn. Der Chat zeigt dann Regel commit-messages (Projekt).
Eine Datei ohne Beschreibung zählt trotzdem: Snotra nimmt ihre erste Überschrift oder ihre erste Zeile als Beschreibung. Eine Beschreibung, die sagt, wann, wirkt besser als eine, die sagt, was.
Jeder Listenpunkt ist eine Regel. Ein Datum am Zeilenanfang — - 2026-10-31 — … — sagt, wie alt sie ist.
Regeldateien werden auch aus ~/.agents/rules/ gelesen, wo andere Werkzeuge ihre ablegen. Eine gleichnamige Datei in ~/.snotra/rules/ hat Vorrang.
Seit 1.30 Einstellungen › Wissen markiert Regeln, die sich wie eine Episode lesen, die fast gleich mit einer anderen Regel oder einem Gedächtniseintrag sind oder älter als 180 Tage, und zwei Dateien einer Ebene, deren Namen sich nur wenig unterscheiden (commit, commits). Die Regeln einer Datei mit Hinweisen stehen hinter 1 Eintrag mit Hinweis in ihrer Zeile; Zusammenführen… holt die Regeln der einen Datei in die andere, ohne die, die dort schon stehen, und entfernt die geleerte Datei. Dateien in ~/.agents/rules/ gehören den anderen Werkzeugen und werden nicht geändert. Siehe Hinweise an Einträgen.

Wenn sich Regeln widersprechen

Was du im Chat sagst, geht jeder Regel vor. Zwischen zwei Regeln gewinnt die mit der genaueren Bedingung, dann die neuere. Sagen eine Regel des Projekts und eine deiner eigenen in derselben Situation Verschiedenes, sagt Snotra dir das und fragt — es sucht sich nicht still eine aus. Die Regeln eines Projekts können mit einem geklonten Repository kommen; sie wiegen nie mehr als das, was du sagst.

Regeln sehen und ausschalten

Einstellungen › Wissen › Regeln zeigt die Regeldateien beider Ebenen — Projekt für den geöffneten Ordner, Global · in jedem Ordner für deine eigenen —, jede mit ihrer Beschreibung, ihrem Pfad und wie viele Zeichen sie hat.

Der Schalter neben einer Ebene, Regeln mitschicken: Projekt, lässt alle ihre Dateien weg, ohne sie zu löschen; der Schalter in der Zeile einer Datei, Regeldatei commit-messages verwenden, lässt nur diese eine weg.
Öffnen öffnet die Datei in deinem Editor.
Neue Regeldatei fragt nach Name und Wann gilt sie?, mit einem Kästchen für Gilt in jedem Zug (always), schreibt dann die Datei mit dieser Beschreibung und öffnet sie in deinem Editor.

Die Etiketten in einer Zeile sagen, was Snotra mit der Datei macht: Immer; Beschreibung abgeleitet, wenn die Datei keine eigene Beschreibung hat; Gekürzt, wenn sie über 20.000 Zeichen hat; Über dem Immer-Budget — wird geholt, wenn sie greift und Dem Wissensbudget gewichen, wenn nicht für alles Platz war; Verdeckt von ~/.snotra/rules für eine Datei in ~/.agents/rules/, die in ~/.snotra/rules/ eine gleichnamige hat. Dateien, die nicht gelesen werden, stehen unter ihrer Ebene: in Unterordnern, über der Grenze von 50 oder mit einem Namen, der kein Regelname ist. Eine Regeldatei des Projekts, die aussieht, als verberge sie dir etwas, trägt den Hinweis Prüf diese Datei: Sie könnte Anweisungen vor dir verbergen.

Schalter und neue Dateien wirken ab der nächsten Nachricht.

Grenzen

Was	Grenze
Dateien je Ordner	50; weitere werden nicht gelesen
Name	64 Zeichen: `a–z`, `0–9`, `-`
Beschreibung	200 Zeichen
Eine Regeldatei	20.000 Zeichen; eine längere wird sichtbar gekürzt
Alle `always`-Regeln einer Ebene	8.000 Zeichen; die neueste Datei darüber wird stattdessen geholt, wenn sie greift

Gedächtnis, always-Regeln, AGENTS.md und die Liste der Regeln nehmen zusammen höchstens ein Viertel des Platzes ein, den eine Anfrage hat. Brauchen sie mehr, zeigt die Liste der Regeln zuerst nur noch Namen, dann werden die always-Regeln des Projekts erst geholt, wenn sie greifen, dann wird AGENTS.md gekürzt, und zuletzt werden deine eigenen always-Regeln erst geholt, wenn sie greifen. Dein Gedächtnis geht immer vollständig mit. Die Aufschlüsselung hinter der Token-Anzeige im Eingabefeld zeigt jeden Schritt — siehe Eine Nachricht schreiben.

Wenn es nicht klappt

Snotra beachtet die Datei nicht. Prüf ihren Namen: Kleinbuchstaben, keine Leerzeichen, Endung .md, direkt im Ordner rules. Dateien in Unterordnern werden nicht gelesen.
Snotra befolgt eine Regel auf Abruf nicht. Lass die Beschreibung die Situation nennen: Wenn du einen Pull Request öffnest statt Pull Requests.
Die Regeln eines Projekts überraschen dich. Ein Ordner, den du nicht geschrieben hast, kann eigene Regeln mitbringen, wie seine AGENTS.md. Snotra prüft sie auf Anzeichen, dass sie dir etwas verschweigen, und markiert eine solche Datei in der Aufschlüsselung — siehe Projektanweisungen.