← Manual Uebersicht Git Control Tower Bedienung ohne GUI

Git Operations Runbook

1-Seiten-SOP fuer IIO-Teamarbeit mit klarer Trennung zwischen classic (ohne Agent) und assisted (mit Coding-Agent-Unterstuetzung).

Default-Policy

  1. Arbeit immer auf Branches.
  2. Tags nur als Ruecksprunganker (Checkpoint/Release).
  3. Kleine Commits, klare Scope-Grenzen.
  4. Keine Misch-Commits aus Strukturumbau und Uebersetzung.
  5. Im assisted mode liefert der Agent Vorschlaege, die Freigabe bleibt beim Menschen.

Branch vs Tag in 10 Sekunden

SituationEmpfehlungGrund
Aktiv entwickelnBranchIsolation und reviewbare Arbeitspakete.
Stabilen Zustand markierenTagSchneller Ruecksprung auf bekannte Basis.
Riskanter UmbauTag + BranchSafety-Net plus geordnete Umsetzung.

Naming-Konvention

Branch
  • feat/<topic>
  • fix/<topic>
  • chore/<topic>
  • docs/<topic>
Tag
  • checkpoint-YYYYMMDD-HHMM
  • release-vX.Y.Z
  • pre-cleanup-YYYYMMDD

Standardablauf (Classic)

  1. Synchronisieren und Zustand pruefen.
git fetch --all --prune
git status --short
  1. Optionalen Safety-Tag vor riskanten Schritten setzen.
git tag -a pre-cleanup-YYYYMMDD -m "before cleanup"
git push origin --tags
  1. Arbeitsbranch erstellen.
git switch -c feat/cleanup-i18n-pass
  1. Low-level/Strukturpass committen.
git add -A
git commit -m "chore: low-level cleanup"
  1. Uebersetzungs-/Sprachpass separat committen.
git add -A
git commit -m "docs: DE/EN translation pass"
  1. Pushen und Review einholen.
git push -u origin feat/cleanup-i18n-pass

Standardablauf (Assisted mit Coding-Agent)

Regel Agent darf analysieren, vorschlagen und patchen. Freigabe fuer state-aendernde Schritte bleibt beim Menschen (HITL).

  1. Branch wie im classic flow erstellen.
  2. Agent-Task eng scopen (Dateien, Ziel, Nicht-Ziele).
  3. Agent-Aenderungen in kleinen Batches reviewen.
  4. Checks/Tests laufen lassen.
  5. Human entscheidet GO/BLOCK/ESCALATE.
  6. Erst danach mergen.

Prompt-Mini-Template:

Scope: exakte Dateien
Goal: messbares Ergebnis
Guardrails: keine Strukturdrift
Evidence: kurze Diff+Check-Zusammenfassung

Uebersetzungs-Policy

  1. Zuerst Low-level/Struktur bereinigen.
  2. Danach Sprache/Uebersetzung uebernehmen.
  3. Pro Sprache eigener Commit oder eigene PR.
Do
  • Ein Artefakt = eine Publikationssprache.
  • Source-of-truth klar dokumentieren.
Don't
  • Fachlogik und Stilumbau im selben Commit mischen.
  • Unreviewte Agent-Formulierungen direkt publizieren.

Client-Abgrenzung (ohne/mit Agent)

ProfilAusfuehrungFreigabe
Client ohne AgentRein menschliche AusfuehrungKlassischer Review-Pfad
Client mit AgentAgentische Unterstuetzung im BranchKeine ungepruefte Direktfreigabe, HITL Pflicht

Schnell-Check vor Merge

  • Branch sauber benannt?
  • Scope klein und nachvollziehbar?
  • Struktur- und Sprachpass getrennt?
  • Review durch zweite Instanz erfolgt?
  • Optionaler Ruecksprung-Tag gesetzt?

Wenn eine Antwort "nein": BLOCK bis korrigiert.

Recovery / Ruecksprung

git switch main
git fetch --all --tags
git checkout <tag-name>
git switch feat/<topic>

Team-Minimum je Arbeitstag

  1. Tagesstart: fetch und status.
  2. Arbeit nur auf Branches.
  3. Mindestens ein reviewbarer Commit pro Thema.
  4. Tagesabschluss: Push und kurzer Team-Status.