Wiki Pflege

Wiki-Pflege (Anleitung fuer Claude)

Diese Seite beschreibt, wie der Master-Plan und die Detail-Plaene (Plan-<Cluster>.md) sowie alle anderen Wiki-Seiten technisch zu aktualisieren sind. Zielgruppe ist Claude (bzw. Claude-Code), nicht der menschliche Leser. Sie existiert als eigene Seite, damit der Master-Plan selbst uebersichtlich praesentabel bleibt.

Grundsatz

Das Wiki liegt nicht in der GitHub-API. Der github-MCP kann nur Issues, Pull Requests und Code im Haupt-Repo — keine Wiki-Seiten. Das Wiki ist ein eigenes Git-Repo (https://github.com/MadGapun/PBP.wiki.git) und wird ueber einen lokalen Klon mit Desktop Commander gepflegt.

Standard-Ablauf (in EINEM Durchlauf)

1. Klon-Pfad: D:\MAD\Documents\Entwicklung\pbp-wiki Falls nicht vorhanden, einmalig klonen: git clone https://github.com/MadGapun/PBP.wiki.git "D:\MAD\Documents\Entwicklung\pbp-wiki"

2. IMMER zuerst aktualisieren: git -C "D:\MAD\Documents\Entwicklung\pbp-wiki" pull --rebase origin master Der lokale Klon haengt oft hinterher, weil parallel (User / Claude-Code) gepusht wird. Ohne dieses Pull scheitert der spaetere Push mit [rejected] fetch first.

3. Bearbeiten: Die betroffene(n) Markdown-Datei(en). Bei Plan-Aenderungen typisch Master-Plan.md plus den passenden Detail-Plan (Plan-<Cluster>.md). Echte Umlaute verwenden. Status-Datum im Kopf der jeweiligen Datei nachziehen.

4. Committen: git -C "<pfad>" add <dateien> git -C "<pfad>" commit -m "<Seite>: <Aenderung> (#issue)"

5. Pushen: git -C "<pfad>" push origin master

PowerShell-Stolperfallen

Die Default-Shell ist powershell.exe:

• KEIN && als Befehlstrenner — stattdessen ; verwenden.
• KEIN cd /d — stattdessen git -C "<pfad>" nutzen (kein Verzeichniswechsel noetig).
• Die Konsole zeigt Umlaute teils als ? oder Mojibake an. Das ist nur die Konsolen-Anzeige, die Datei selbst ist sauberes UTF-8. NICHT "korrigieren" — sonst entsteht erst recht Mojibake in der Datei.

Wenn der Push scheitert ([rejected] fetch first)

Jemand hat zwischenzeitlich gepusht. Aufloesung:

1. git -C "<pfad>" pull --rebase origin master
2. Bei Konflikt (meist nur die Stand-Zeile im Kopf): Datei oeffnen, Konfliktmarker <<<<<<< / ======= / >>>>>>> aufloesen. Faustregel: aktuelle Versionsnummer (z.B. beta.NNN) behalten, heutiges Datum nehmen. Dann git -C "<pfad>" add <datei>.
3. Rebase abschliessen mit gesetztem Editor, sonst haengt der Prozess im unsichtbaren interaktiven Editor: $env:GIT_EDITOR="true"; git -C "<pfad>" rebase --continue
4. Erneut pushen.

Neue Wiki-Seite anlegen

• Dateiname = Seitenname mit Bindestrichen statt Leerzeichen. Wiki-Pflege.md wird zur Seite Wiki-Pflege, erreichbar unter https://github.com/MadGapun/PBP/wiki/Wiki-Pflege.
• Verlinkung innerhalb des Wikis: [Anzeigetext](Seitenname) ohne .md (z.B. [Master-Plan](Master-Plan)).
• Bei Bedarf in _Sidebar.md eintragen, damit die Seite in der Navigation auftaucht.

Akzeptanzkriterium (aus dem Master-Plan)

Eine Plan-Position ist nur dann fertig, wenn alle drei zutreffen: Code im Repo, Tests gruen, Wiki-Eintrag vorhanden. Die Wiki-Pflege ist also kein optionaler Nachgang, sondern Teil der Definition-of-Done.