Teamarbeit – Ko-Konstruktion

Siehe auch: Rollen & Personas

Ziel: Unsere ko‑konstruktive Arbeitsweise klar festlegen, damit Inhalte, Skripte und Qualitätssicherung reibungslos zusammenspielen – zwischen Ahoiiiiiiii (menschlicher Kurator) und Geniestreich (KI‑Cokurator/Assistenz / Skript‑Generator).

Leitprinzipien

  • Transparenz: Kleine, nachvollziehbare Schritte mit klaren Commits.
  • Reproduzierbarkeit: Einheitliche Umgebungen und feste Workflows.
  • Konsistenz: Gemeinsame Terminologie (siehe Glossar) und feste Qualitätsphasen.
  • Fokus: Mensch kuratiert Inhalte/Entscheidungen, KI unterstützt Struktur, Checks und Vorschläge.

Rollen

  • Ahoiiiiiiii (menschlicher Kurator)
    • Inhalte kuratieren/strukturieren
    • Entscheidungen, Priorisierung, finale Freigabe
    • Schreibstil, CI der Begriffe
  • Geniestreich (KI‑Cokurator/Assistenz)
    • Vorschläge, Strukturierung, Prüfschritte
    • Skripte, Automatisierung, Diff‑/Encoding‑Checks
    • Triage im Bug‑Log (AI_HELP, Hinweise)

Arbeitsrhythmus (Sessions)

  • Short Sprint (30–60 min): 1–2 Beiträge oder 1 Kapitel‑Review
  • Focus Block (60–90 min): Kapitel konsistent machen (Links, Nummern, Encoding)
  • Review Block (30 min): Diffs, Bug‑Log, nächste Schritte

Standard‑Workflow

  1. Vorbereitung
    • git status clean, ggf. git fetch --all / git pull --rebase
    • Phase festlegen (0–4), Ziel notieren
  2. Lauf / Arbeitsschritt
    • Inhalte/Struktur anpassen
    • Skripte/Checks ausführen (Encoding, Links, Linting)
  3. Review
    • Diffs ansehen (Browser/Delta), offensichtliche Inkonsistenzen beheben
    • Bug‑Log sichten, Einträge taggen (AI_HELP, DEFERRED)
  4. Commit
    • Kleine, beschreibende Messages
    • Beispiel: docs(making-of): drop numeric prefixes; normalize H1
  5. Sync
    • git push origin main
    • Bei größeren Änderungen: PR mit Beschreibung (später optional)
  6. Retrospektive (kurz)
    • 1–2 Notizen: Was wurde erreicht? Was als nächstes?

Kommunikations-/Commit‑Regeln

  • Beschreibende Commits, ein Thema pro Commit.
  • Dateien konsistent halten: Dateiname, H1, Links stimmen überein.
  • Keine Misch‑Commits (Inhalt + Tooling) wenn es sich vermeiden lässt.

Qualitätsphasen (Kurzüberblick)

  • Phase 0: Sammeln/Strukturieren, WARN < ERROR, kein Abbruch
  • Phase 1: Struktur fixieren, leichte Korrekturen
  • Phase 2: Konsistenz, Abbruch nach Lauf bei ERROR/FATAL
  • Phase 3: Feinschliff, strenge Bewertung
  • Phase 4: Freeze/Release, keine Encoding‑/Strukturänderungen mehr

Definition of Ready / Done

  • DoR Beitrag: Kapiteldatei existiert, H1 korrekt, Platzhalter/Abschnitte stehen.
  • DoD Beitrag: Links aktualisiert, interne Verweise stimmen, keine offenen Errors.
  • DoR Release: ToC aktuell, Encoding konsistent, Skripte laufen.
  • DoD Release: Bug‑Log nur INFO/WARN (oder leer), Diff nachvollziehbar.

Tools & Einstellungen (Kurz)

  • Git Pager: cat (einfach) oder delta (komfortabel)
  • VS Code UTF‑8/LF; .editorconfig/.gitattributes verbindlich
  • PowerShell‑Profil: UTF‑8 I/O; $env:LESSCHARSET='utf-8'

Revisionen:

  • 2025-11-10 Initialfassung (nach Umzug „Hobby‑Bauplan“ in eigene Datei)