Regelwerk, Agenten, Skills und Werkzeuge veröffentlichen

Erster Stand des öffentlichen Ausschnitts aus dem Vault. Die .gitignore arbeitet als Positivliste: ausgeschlossen ist alles, eingeschlossen nur, was ausdrücklich wieder aufgenommen wird. Notizen, Projekte, Finanzen, das Sitzungsgedächtnis und settings.local.json bleiben damit außen vor. Der Kundenname in AI/Regelwerk/seo.md ist durch eine neutrale Bezeichnung ersetzt; die Regeln selbst sind unverändert. Co-Authored-By: Claude Opus 5 <[email protected]>
2026-09-17 22:38:15 +02:00
commit c064c729ed
@@ -0,0 +1,28 @@
+# claude-regelwerk
+
+Das Anweisungs- und Regelwerk, mit dem ich Claude Code an meinem Obsidian-Vault arbeiten lasse. Veröffentlicht, weil das Zusammenspiel aus Stammdatei, ausgelagerten Regeln, festen Agentenrollen und mechanischen Prüfungen für andere nachbaubar ist.
+
+Das Repo ist ein Ausschnitt eines größeren, privaten Vaults. Es enthält keine Notizen, keine Projekte, keine Kundendaten — nur die Regeln und die Werkzeuge.
+
+## Was drin liegt
+
+| Pfad | Inhalt |
+| --- | --- |
+| `CLAUDE.md` | Der Stamm. Gilt immer, wird komplett gelesen, bleibt kurz. |
+| `AI/Regelwerk/` | Eine Datei je Aufgabentyp — Schreibstil, Codeworkflow, Prompting, API-Mechanik, Frontmatter und weitere. Wird gezielt nachgeladen, nicht auf Vorrat. |
+| `.claude/agents/` | Die drei festen Rollen: `planer`, `executer`, `pruefer`. Jede Rolle ist fest einem Modell zugeordnet. |
+| `.claude/skills/` | Eigene Skills (BookStack-Upload, Plane-Abgleich, die Standardschleife aus Planen–Umsetzen–Prüfen). |
+| `.claude/settings.json` | Hooks: Sitzungsstart, Regelwerk-Prüfung nach jedem Edit, automatischer Push. |
+| `.vault-tools/` | Prüf- und Wartungsskripte, unter anderem Linkcheck, Regelwerk-Check und Plan-Kopie. |
+
+## Die zwei Ideen, um die herum alles gebaut ist
+
+**Eine Regel steht an genau einer Stelle.** Skills und Agenten verweisen auf das Regelwerk, statt es zu kopieren. Eine Kopie driftet und gewinnt, weil sie zuerst geladen wird.
+
+**Mechanische Prüfung statt guter Vorsätze.** `.vault-tools/regelwerk-check/regelwerk_check.py` prüft nach jeder Änderung tote Wikilinks, Frontmatter-Pflichtfelder, Erreichbarkeit vom Stamm, offene Freigaben und die Modellzuordnung. Das ist ein Fangnetz, kein Nachweis — inhaltliche Widersprüche sieht es nicht.
+
+## Nachnutzung
+
+Die Dateien sind auf meinen Vault, meine Ordnerstruktur und Windows zugeschnitten. Wer sie übernimmt, passt mindestens die Pfade in `.claude/settings.json` und die Vault-Struktur im Abschnitt „Struktur des Vaults" der `CLAUDE.md` an.
+
+Alle Texte sind auf Deutsch.