Pascal MichelandClaude Opus 5
60dee0ab68
- .claude/agents/executer.md - .claude/agents/recherche.md - .claude/skills/anleitung-straffen/SKILL.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/00-uebersicht.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-01-zaehler.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-02-sitzungsstart.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-03-regeltexte.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-04-bestandsskript.md - .vault-tools/linkcheck/docs/plans/2026-09-29-waisen/task-05-bestandslauf.md - .vault-tools/workflow-pruefung/docs/plans/2026-09-29-quorum/00-uebersicht.md - .vault-tools/workflow-pruefung/docs/plans/2026-09-29-quorum/task-01-quorum-werkzeug.md - .vault-tools/workflow-pruefung/docs/plans/2026-09-29-quorum/task-02-quorum-workflow.md - … und 13 weitere Erzeugt vom PostToolUse-Hook .vault-tools/auto-push/auto_push.py. Co-Authored-By: Claude Opus 5 <[email protected]>
216 lines
12 KiB
Markdown
216 lines
12 KiB
Markdown
---
|
|
type: plan-task
|
|
title: "Task 03 — Hub-Regel in navigation.md und ihre Verweise in Stamm, Planer, Codedoku und SEO"
|
|
status: draft
|
|
summary: "navigation.md bekommt die Hub-Regel mit Tabelle als einzigen Ort der Regel und einen Abschnitt zu waisen.py; CLAUDE.md, planer.md, codedoku.md und seo.md bekommen je einen knappen Punkt mit Verweis."
|
|
tags: [plan-task, vault-tools]
|
|
created: 2026-09-29
|
|
updated: 2026-09-29
|
|
modell: sonnet
|
|
effort: low
|
|
modell_begruendung: "Reine Abschrift per Skript, aber die Codeblöcke enthalten typografische Anführungszeichen, die Haiku still ersetzt."
|
|
---
|
|
Übersicht: [00-uebersicht.md](00-uebersicht.md)
|
|
|
|
# Task 03 — Hub-Regel und Verweise
|
|
|
|
Globale Vorgaben: `00-uebersicht.md` im selben Ordner, Abschnitt „Globale Vorgaben“.
|
|
|
|
Voraussetzung: Pascal hat Prüfschritt P1 aus der Übersicht in Obsidian mit Ja beantwortet. Ohne dieses Ja startet der Task nicht.
|
|
|
|
## Zieldateien
|
|
|
|
- `D:\Claude\AI\Regelwerk\navigation.md` (geändert)
|
|
- `D:\Claude\CLAUDE.md` (geändert)
|
|
- `D:\Claude\.claude\agents\planer.md` (geändert)
|
|
- `D:\Claude\AI\Regelwerk\codedoku.md` (geändert)
|
|
- `D:\Claude\AI\Regelwerk\seo.md` (geändert)
|
|
|
|
## Verbote
|
|
|
|
- Frontmatter der Zieldateien nicht anfassen, auch nicht `updated` oder `status`. Das macht der Koordinator.
|
|
- Kein Skill, kein Workflow, keine andere Regelwerk-Datei.
|
|
- Keine Formulierung glätten oder ergänzen. Steht ein Aus-Block nicht genau einmal in der Datei, bricht das Skript mit Befund ab: dann melden, nicht von Hand einfügen.
|
|
|
|
## Schritt 0 — Stand vorher festhalten
|
|
|
|
```
|
|
PYTHONIOENCODING=utf-8 python D:/Claude/.vault-tools/regelwerk-check/regelwerk_check.py --vault D:/Claude > /tmp/regelwerk-vorher.txt; echo "exit=$?"; PYTHONIOENCODING=utf-8 python D:/Claude/.vault-tools/linkcheck/linkcheck.py --vault D:/Claude --alle > /tmp/linkcheck-vorher.txt; echo "exit=$?"
|
|
```
|
|
|
|
Der Exit-Code ist hier egal, er wird nur mitgemeldet.
|
|
|
|
## Schritt 1 — Blöcke anwenden
|
|
|
|
```
|
|
python D:/Claude/.vault-tools/plan-kopie/plan_materialisiere.py D:/Claude/.vault-tools/linkcheck/docs/plans/2026-09-29-waisen D:/Claude task-03-regeltexte.md
|
|
```
|
|
|
|
Erwartet: eine Zeile mit `'ersetzt': 7` und die Schlusszeile `0 Befund(e).`
|
|
|
|
### Abschnitt zu waisen.py in `AI/Regelwerk/navigation.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
Der erste Befehl meldet die echten toten Wikilinks, weil er Codeblöcke ausnimmt. Der zweite fährt die Angriffsfälle gegen die Codeblock-Erkennung. Entwurf, Herkunft je Regel und benannte Lücken: `.vault-tools/linkcheck/ENTWURF-codeblock-erkennung.md`.
|
|
```
|
|
|
|
wird:
|
|
|
|
````
|
|
Der erste Befehl meldet die echten toten Wikilinks, weil er Codeblöcke ausnimmt. Der zweite fährt die Angriffsfälle gegen die Codeblock-Erkennung. Entwurf, Herkunft je Regel und benannte Lücken: `.vault-tools/linkcheck/ENTWURF-codeblock-erkennung.md`.
|
|
|
|
## Waisen: waisen.py
|
|
|
|
Eine Waise ist eine Notiz ohne Kante im Graphen, weder eingehend noch ausgehend. `waisen.py` zählt sie so, wie Obsidian den Graphen baut, und zieht die Muster aus `waisen-ausnahmen.txt` ab.
|
|
|
|
```bash
|
|
PYTHONIOENCODING=utf-8 python .vault-tools/linkcheck/waisen.py --vault . --liste
|
|
python .vault-tools/linkcheck/faelle_waisen.py
|
|
```
|
|
|
|
- Der Sitzungsstart zeigt dieselbe Zahl als Zeile „Waisen außerhalb der Ausnahmen“. Steigt sie, hat eine neue Datei ihren Hub nicht verlinkt (Regel unten unter „Links schreiben und Dateien verschieben“).
|
|
- In `waisen-ausnahmen.txt` stehen nur allgemeine Muster, keine Kunden- oder Projektnamen, weil `.vault-tools/` veröffentlicht wird.
|
|
- Entwurf, Herkunft je Regel und benannte Lücken: `.vault-tools/linkcheck/ENTWURF-waisen.md`. Ein Fangnetz, kein Nachweis: Wie der Graph aussieht, zeigt nur Obsidian.
|
|
````
|
|
|
|
### Sitzungsstart in `AI/Regelwerk/navigation.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
- **`sitzungsstart.py`** (SessionStart) gibt beim Start nur Zahlen in den Kontext: ob die Tagesnotiz existiert, offene Inbox-Notizen, Notizen mit `#needs-review`, `#review` ohne `#review-done`, Regelwerk-Dateien auf `pending-review` und die Sitzungsdateien von heute, damit eine Namenskollision auffällt.
|
|
```
|
|
|
|
wird:
|
|
|
|
```
|
|
- **`sitzungsstart.py`** (SessionStart) gibt beim Start nur Zahlen in den Kontext: ob die Tagesnotiz existiert, offene Inbox-Notizen, Notizen mit `#needs-review`, `#review` ohne `#review-done`, Regelwerk-Dateien auf `pending-review` und die Sitzungsdateien von heute, damit eine Namenskollision auffällt. Dazu kommt die Zahl der Waisen außerhalb der Ausnahmen aus `waisen.py`, nur die Zahl, keine Liste.
|
|
```
|
|
|
|
### Hub-Regel in `AI/Regelwerk/navigation.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
## Links schreiben und Dateien verschieben
|
|
|
|
- **Wikilinks mit vollem Vault-Pfad:** `[[AI/Regelwerk/navigation|navigation.md]]`. In Tabellenzellen schreibst du den Alias-Trenner als `\|`.
|
|
```
|
|
|
|
wird:
|
|
|
|
```
|
|
## Links schreiben und Dateien verschieben
|
|
|
|
### Jede neue Datei hängt an ihrem Hub
|
|
|
|
**Wer eine Datei anlegt, verlinkt darin ihren Hub, und zwar nach oben.** Das gilt für dich, für jeden Subagenten, Skill und Workflow. Der Erzeuger kennt den Hub beim Anlegen, der Hub selbst braucht keine Pflege, und seine Rückverweise zeigen alle Kinder. Ein Pfad in Backticks ist kein Link.
|
|
|
|
| Datei | Hub | Linkform |
|
|
|---|---|---|
|
|
| Plan-Übersicht `00-uebersicht.md`, Einzeldatei-Plan | Projekt-README | relativer Markdown-Link |
|
|
| alles andere im Planordner (Task, Anforderung, Prüfbericht, Nachbesserung) | `00-uebersicht.md` desselben Ordners | relativer Markdown-Link |
|
|
| Codedoku `docs/code/*.md`, Spec, Quorum-Bericht, CHANGELOG, Administrator-Anleitung | Projekt-README | relativer Markdown-Link |
|
|
| SEO-Einzelbefund | Bericht des Laufs | Wikilink mit vollem Pfad |
|
|
| Bericht eines SEO-Laufs | SEO-Seed | Wikilink mit vollem Pfad |
|
|
| Arbeitsdatei eines Projekts im IT Workspace | Übersicht bzw. README des Projekts | Wikilink mit vollem Pfad |
|
|
| Dump | Tagesnotiz | Wikilink `[[Inbox/JJJJ-MM-TT]]` |
|
|
|
|
- **Wo die Zeile steht:** direkt unter dem Frontmatter, ohne Frontmatter in der ersten Zeile. In einer Taskdatei lautet sie `Übersicht: [00-uebersicht.md](00-uebersicht.md)`, in einer Übersicht `Projekt: [README](../../../README.md)`, die Tiefe passend zum Ort.
|
|
- **Relative Markdown-Links in Projekt-Repos, entgegen der Vault-Gewohnheit.** Der Projektstatus steht im Ordnerpräfix, und aus `active - X` wird irgendwann `inactive - X`. Wikilinks mit vollem Pfad brechen dabei, wenn nicht in Obsidian umbenannt wird. Gitea zeigt Markdown-Links an, Wikilinks nicht. Leerzeichen und Umlaute im Pfad schreibst du URL-kodiert, ein Leerzeichen als `%20`.
|
|
- **Außerhalb der Projekt-Repos** bleibt es beim Wikilink mit vollem Pfad.
|
|
- **SEO-Befunde verlinkt der Bericht nach unten**, weil der Audit-Skill außerhalb des Vaults liegt und seine Befunddateien ohne Link ablegt. Wie, steht in [[AI/Regelwerk/seo|seo.md]], Abschnitt 1, Punkt 5.
|
|
- **Bewusste Ausnahmen** sind `Bookstack/` (Warteschlange und Archiv) und Programmausgaben unter `data/` in Code-Projekten. Sie stehen als Muster in `.vault-tools/linkcheck/waisen-ausnahmen.txt` und zählen nicht als Waisen.
|
|
|
|
### Links allgemein
|
|
|
|
- **Wikilinks mit vollem Vault-Pfad:** `[[AI/Regelwerk/navigation|navigation.md]]`. In Tabellenzellen schreibst du den Alias-Trenner als `\|`.
|
|
```
|
|
|
|
### Pflegepunkt in `CLAUDE.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
- Neues Projekt in Code Projekte / Security-Compliance → im jeweiligen Oberseed mit Link aufs README eintragen und mit dem passenden Themen-Seed verbinden ([[AI/Regelwerk/projekte|projekte.md]]).
|
|
```
|
|
|
|
wird:
|
|
|
|
```
|
|
- Neues Projekt in Code Projekte / Security-Compliance → im jeweiligen Oberseed mit Link aufs README eintragen und mit dem passenden Themen-Seed verbinden ([[AI/Regelwerk/projekte|projekte.md]]).
|
|
- Jede Datei, die du, ein Subagent, Skill oder Workflow anlegt, verlinkt ihren Hub nach oben: Plan, Codedoku und CHANGELOG das Projekt-README, Task die Plan-Übersicht, Dump die Tagesnotiz. Tabelle und Linkform: [[AI/Regelwerk/navigation|navigation.md]], „Links schreiben und Dateien verschieben“. Der Sitzungsstart meldet die Zahl der Waisen.
|
|
```
|
|
|
|
### Hub-Zeile in `.claude/agents/planer.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
- **Ablageform hängt am Umfang.** Bis zwei Tasks eine Datei `docs/plans/JJJJ-MM-TT-<thema>.md`. **Ab etwa drei Tasks ein Ordner** `docs/plans/JJJJ-MM-TT-<thema>/` mit `00-uebersicht.md` (Ziel, Architektur, globale Vorgaben, Dateiübersicht, Tasktabelle, Abnahme) und je Task einer Datei `task-NN-<thema>.md`. Jede Taskdatei verweist im Kopf auf die globalen Vorgaben der Übersicht, statt sie zu wiederholen — zwei Fassungen derselben Vorgabe laufen auseinander.
|
|
```
|
|
|
|
wird:
|
|
|
|
```
|
|
- **Ablageform hängt am Umfang.** Bis zwei Tasks eine Datei `docs/plans/JJJJ-MM-TT-<thema>.md`. **Ab etwa drei Tasks ein Ordner** `docs/plans/JJJJ-MM-TT-<thema>/` mit `00-uebersicht.md` (Ziel, Architektur, globale Vorgaben, Dateiübersicht, Tasktabelle, Abnahme) und je Task einer Datei `task-NN-<thema>.md`. Jede Taskdatei verweist im Kopf auf die globalen Vorgaben der Übersicht, statt sie zu wiederholen — zwei Fassungen derselben Vorgabe laufen auseinander.
|
|
- **Jede Plandatei verlinkt ihren Hub direkt unter dem Frontmatter**, als relativen Markdown-Link, nicht nur als Pfad in Backticks. Die Übersicht und ein Einzeldatei-Plan verlinken das Projekt-README (`Projekt: [README](../../../README.md)`, die Tiefe passend zum Ort), jede andere Datei im Planordner die Übersicht (`Übersicht: [00-uebersicht.md](00-uebersicht.md)`). Leerzeichen und Umlaute im Pfad schreibst du URL-kodiert. Hat das Projekt kein `README.md`, entfällt die README-Zeile. Die Planwerkzeuge vertragen die Zeile an dieser Stelle, weil sie nur Überschriften, Codezäune und den Abschnitt `## Zieldateien` auswerten (Befund im Plan `.vault-tools/linkcheck/docs/plans/2026-09-29-waisen/`). Regel und Begründung: `AI/Regelwerk/navigation.md`, Abschnitt „Links schreiben und Dateien verschieben“.
|
|
```
|
|
|
|
### README-Zeile in `AI/Regelwerk/codedoku.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
- Ort: Projektordner unter `docs/code/`, eine Datei je Modul oder Skript, gleicher Name.
|
|
```
|
|
|
|
wird:
|
|
|
|
```
|
|
- Ort: Projektordner unter `docs/code/`, eine Datei je Modul oder Skript, gleicher Name.
|
|
- Direkt unter dem Frontmatter, ohne Frontmatter in der ersten Zeile, steht ein relativer Markdown-Link aufs Projekt-README, zum Beispiel `Projekt: [README](../../README.md)`. Der Dateikopf im Code nennt die Codedoku nur als Pfad, ohne diese Zeile ist sie im Graphen eine Waise. Regel: [[AI/Regelwerk/navigation|navigation.md]], Abschnitt „Links schreiben und Dateien verschieben“.
|
|
```
|
|
|
|
### Befundliste im Bericht in `AI/Regelwerk/seo.md`
|
|
|
|
Aus:
|
|
|
|
```
|
|
`findings/`, Rohdaten und die Preisliste bekommen keinen Seed-Eintrag. Befunde früherer Läufe sind oft längst behoben (Punkt 1) und sollen nicht prominent verlinkt sein.
|
|
```
|
|
|
|
wird:
|
|
|
|
```
|
|
`findings/`, Rohdaten und die Preisliste bekommen keinen Seed-Eintrag. Befunde früherer Läufe sind oft längst behoben (Punkt 1) und sollen nicht prominent verlinkt sein. Der Bericht verlinkt sie trotzdem, damit sie im Graphen nicht lose hängen: Nach jedem Lauf bekommt `ABSCHLUSSBERICHT.md` am Ende einen Abschnitt `## Befunddateien dieses Laufs` mit einem Wikilink mit vollem Pfad je Datei unter `findings/`. Der Audit-Skill liegt außerhalb des Vaults und legt die Befunddateien ohne Link ab ([[AI/Regelwerk/navigation|navigation.md]], „Links schreiben und Dateien verschieben“).
|
|
```
|
|
|
|
## Schritt 2 — Stand nachher vergleichen
|
|
|
|
```
|
|
PYTHONIOENCODING=utf-8 python D:/Claude/.vault-tools/regelwerk-check/regelwerk_check.py --vault D:/Claude > /tmp/regelwerk-nachher.txt; echo "exit=$?"; diff <(grep '^\[' /tmp/regelwerk-vorher.txt) <(grep '^\[' /tmp/regelwerk-nachher.txt) && echo "keine neue Befundzeile"
|
|
```
|
|
|
|
Erwartet: `keine neue Befundzeile`. Zeigt `diff` eine Zeile, die mit `>` beginnt, ist das ein neuer Befund: melden.
|
|
|
|
```
|
|
PYTHONIOENCODING=utf-8 python D:/Claude/.vault-tools/linkcheck/linkcheck.py --vault D:/Claude --alle > /tmp/linkcheck-nachher.txt; echo "exit=$?"; diff <(grep '^ - ' /tmp/linkcheck-vorher.txt) <(grep '^ - ' /tmp/linkcheck-nachher.txt) && echo "keine neuen toten Links"
|
|
```
|
|
|
|
Erwartet: `keine neuen toten Links`.
|
|
|
|
## Schritt 3 — Planablage-Prüfung
|
|
|
|
```
|
|
grep -c "Jede Plandatei verlinkt ihren Hub" D:/Claude/.claude/agents/planer.md; grep -c "### Jede neue Datei hängt an ihrem Hub" D:/Claude/AI/Regelwerk/navigation.md
|
|
```
|
|
|
|
Erwartet: zweimal `1`.
|
|
|
|
## Bericht
|
|
|
|
Melde die vollständige Ausgabe der Schritte 0 bis 3. Läuft etwas anders als erwartet: nichts anpassen, melden.
|