simonpokorny/knowledgebase

Schreibe einen kleinen, schema-sauberen Eintrag in das .knowledgebase/-Verzeichnis des Repositorys. Wenn das Repo kein .knowledgebase/ besitzt, stoppe und sage dem Benutzer, er solle zuerst das Skill /setup-knowledgebase ausführen.

1. Wähle den Typ:

   Es ist	Typ	Pfad
   eine Behauptung über das System, wahr und wert, nicht wiederentdeckt zu werden	finding	.knowledgebase/entries/finding-<thema-kebab>.md
   eine Verhaltensregel, meist aus einem Fehler entstanden	learning	.knowledgebase/entries/learning-<thema-kebab>.md
   eine Wahl zwischen Alternativen mit einem Abwägungspunkt	decision	.knowledgebase/entries/decision-NNNN-<thema-kebab>.md

2. Schreibe den Eintrag. Die Frontmatter-Felder, Status, Grenzen und Konventionen für den Body findest du in ENTRY-FORMAT.md; lies sie vor dem Schreiben. Arbeitsbeispiele liegen im templates/-Verzeichnis dieses Plugins.

3. Stelle sicher, dass der Status ehrlich ist. Für Findings und Learnings: verified nur, wenn du die Behauptung in dieser Session selbst bewiesen hast, dann setze verified-by: agent und füge die Beweise (einen Quelllink oder den durchgeführten Check) in den Body ein. Alles, was du nicht beweisen konntest, bleibt unverified; diese Einträge wird der Mensch bei der Überprüfung kontrollieren. Neue Entscheidungen erhalten status: decided und kommen in zwei Varianten:

   • Implementierungsentscheidungen: grundlegende Wahl, die du während des Bauens selbst getroffen hast. Halte das Warum und die Abwägung fest, als decided-by: agent.
   • Planungsentscheidungen: gemeinsam mit dem Benutzer getroffen, nicht aus dem Code ableitbar. Notiere sie ebenfalls als decided-by: agent, und übergebe dem Benutzer die Übernahmezeile aus dem Session-Endbericht, damit der Eintrag später decided-by: human wird. Setze niemals selbst decided-by: human – das darf nur ein Mensch. Beide Arten können später durch eine neuere Entscheidung als superseded gekennzeichnet werden.

4. Falls der Eintrag eine Learning ist, die einen Befehl verbietet, füge einen guard:-Regex hinzu, damit die Regel sich selbst durchsetzt. Die Regeln für das Schreiben von Guards stehen in ENTRY-FORMAT.md; teste den Regex mit grep -E vor dem Commit.

5. Comitte den Eintrag auf demselben Branch wie die Änderung, die ihn ausgelöst hat, sodass er im selben Commit mitreist. Fasse keine Einträge für später zusammen.