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]>
29 lines
2.0 KiB
Markdown
29 lines
2.0 KiB
Markdown
# 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.
|