Zum Inhalt

ADR-001 — Projektmanagement-System: lokales Git-Repo + Markdown + Mermaid

Datum: 2026-05-04 Status: ⚠ Superseded by ADR-002 (2026-05-11) — der ursprüngliche Trade-off „kein Web-UI ohne GitHub-Push" wurde aufgehoben, weil CS-Agenten und Philip die Doku lesen müssen.

Kontext: Susi braucht eine Single Source of Truth für alle mokebo-Projekte (Workflows, Sheets, Status, Roadmap). Sie arbeitet solo mit Claude Code und hat keine Notion-Lizenz.

Entscheidung: Lokales Git-Repo unter ~/Desktop/CLAUDE/n8n-workflows/mokebo-ops/ mit Markdown-Dateien und Mermaid-Diagrammen.

Alternativen geprüft:

  • Google Drive als SSoT — schlecht versionierbar, Mermaid nicht nativ.
  • Notion — Lock-in, neuer Tool-Stack, schwer maschinenlesbar für Claude Code.
  • Hybrid (Notion + Drive) — Overhead für Solo-Setup.

Begründung: Native Integration mit Claude Code (Filesystem + CLAUDE.md), Mermaid-Diagramme als Code (diff-bar), Git-History gratis, Onboarding für Philip per git clone. Trade-off: Kein Web-UI ohne GitHub-Push — bewusst akzeptiert (Push erst nach Freigabe).

Was zurückblickend nicht funktioniert hat: Die initiale Struktur (4 Pflichtlektüre-Stationen, Phasen-Roadmap, mehrere CLAUDE.md-Schichten, Audit-Interview-Konzept) war für eine Werkstudentin in Monat 2 zu schwer. Das System wurde nach dem Anlegen am 2026-05-04 nicht weiter befüllt — projects/ blieb leer. Die Doku verfaulte, weil Pflege-Aufwand > Nutzen war. ADR-002 zieht die Konsequenz: gestrippte Struktur + Auto-Sync für alles, was sich automatisieren lässt.