Ein Framework für disziplinierte KI-Coding-Agenten

Lotse

Ein Lotse führt das Schiff durch enges Fahrwasser — ohne selbst das Steuer zu übernehmen. Genau das tut dieses Framework mit KI-Coding-Agenten: es führt sie von der Idee bis zur gemergten Änderung, ohne die Arbeit zu ersetzen.

Das Problem: KI-Agenten driften

🪁
Übergeneralisieren auf Vorrat
🔁
Re-litigieren längst Entschiedenes
⏭️
Überspringen die Review
🎲
Entscheiden aus dem Bauch

Die Strecke

Jede Änderung läuft Idee → Spec → Bau → Review

/werft
Idee bis zum übergabereifen Ticket — mit Mensch-Gates (Spec · Design · Paket).
→
/arbeitstag-prep
Tickets bis ready reifen — der Mensch ist der einzige Stempel-Setzer.
→
/arbeitstag
Mehrere Tickets parallel + konfliktfrei umsetzen (git-Worktrees).

… und über der Arbeit wachen drei Ebenen mit:

/berater-runde
Berater schlägt vor, ein anderer Kopf widerlegt — Landung auf genau einem Ausgang.
/watchdog
Architektur-Review des Diffs vor dem Merge, optional cross-engine.
/prozesswerkstatt
Session-Retros quer ernten → Prozess-Schmerz in Verbesserungen.

Der Mensch entscheidet

Die Maschine bereitet die Entscheidung vor — du entscheidest

🖼️
/werft

Probe-Renderings statt Behauptung

Baut die Werft ein UI, rendert sie echte Screenshots des Ergebnisses — du siehst, was entsteht, nicht nur eine Beschreibung davon.

Du entscheidest an den Gates A (Spec) · B (Design) · C (Paket) — kein Schritt ohne dein Ja.
🗂️
/arbeitstag-prep

Strukturierte HTML-Karten

Reife-Tickets kommen als lesbare HTML-Karten übers lokale Netz — Schmerz, Beleg, Vorschlag auf einen Blick, nicht als Textwand.

Du bist der Einzige, der auf ready stempelt — die Maschine schlägt vor, du gibst frei.
🎫 Im Hintergrund: das Ticket-System
Jede Entscheidung ist ein Ticket mit Status-Label (spec → ready → in-progress → merged). Der Status-Wechsel ist die Membran: den stempelt der Mensch, nie die Maschine allein. Das Ledger hält fest, was einmal ratifiziert wurde — und schützt es vor Re-Litigation.

Die Maschine macht die Vorarbeit — der Stift für die Entscheidung bleibt beim Menschen.

Das mentale Modell — systemischer Blick

Drei Schwäne, drei Flughöhen über derselben Arbeit

»Der Erste fliegt und genießt es. Der Zweite sieht dem Ersten beim Fliegen zu. Der Dritte sieht zu, wie der Zweite zusieht — und erlebt so auf allen drei Ebenen bewusst.«

inspiriert von »Der dritte Schwan« (Bernd Schmid, isb Wiesloch) · Zuordnung: unsere eigene

Die Metapher · „Der dritte Schwan"
Lotse
3. Schwan sieht zu, wie der Zweite zusieht Beobachtung der Beobachtung
→
Prozesswerkstatt · Berater-Runde
Schaut auf das Arbeits- und Beobachtungs-System selbst und verändert es: Berater schlägt vor, Antiberater widerlegt, Synthese entscheidet.
/prozesswerkstatt/berater-runde
2. Schwan sieht dem Ersten beim Fliegen zu bewusste Selbstbeobachtung
→
Watchdogs · Hooks · Contracts
Laufen mit und korrigieren, während gearbeitet wird — Drift, Reife und Qualität in Echtzeit.
/watchdogHooksContracts
1. Schwan fliegt und genießt es das unmittelbare Erleben
→
Die Arbeits-Agenten
Die Agenten, die die Arbeit machen — von der Idee bis zur Umsetzung.
/werft/arbeitstag-prep/arbeitstag
der Boden, über dem geflogen wird: dein Produkt

… genau das tut Lotse: dieselbe Arbeit auf drei Flughöhen zugleich.

Warum es hält

Fünf Kern-Ideen

🚪Reversibilität sortiert

Zwei-Wege-Tür (klein, reversibel) → die kühnere Form ist Default, das Tun ist das Experiment. Ein-Wege-Tür (Datenmodell, öffentliche Schnittstelle) → volle Schärfe vor dem Commit.

🥊Gegnerischer zweiter Kopf

Rat wird prüfbar, indem ein anderes Modell ihn zu widerlegen versucht — nicht, indem man den Berater klüger macht.

📓Ratifizierungs-Ledger

Entscheide einmal, halte es fest, re-litigiere nicht. Ein Beschluss ist ein Fels, kein Vorschlag.

🔒Contracts, die Hooks erzwingen

Maschinen-lesbare Schemas + Guard-Hooks machen Disziplin mechanisch statt nur appellativ.

🌱Retro → Verbesserung

Jeder Lauf endet mit einer Retro über die Arbeitsweise; die Werkstatt verdichtet sie zu Schärfungen. Das Framework ist sein eigenes erstes Anwendungsbeispiel.

Was es ist

Ein dateibasiertes Framework — werkzeug-agnostisch im Geist

Der Kern

  • Nur Dateien: commands/, agents/, contracts/, hooks/ — versioniert, review-bar.
  • Referenz-Implementierung läuft auf Claude Code; die Idee ist portierbar.
  • Kampferprobt an einem echten Familien-Software-Ökosystem.
Apache-2.0 Deutsch dateibasiert

Getting Started

# Methode an den Laufzeit-Ort deployen ./deploy-methode.sh # Vor dem Merge testen ./deploy-methode.sh --dry-run # Drift-Probe gegen die Quelle ./deploy-methode.sh --verify-only

Repo = Wahrheit · Laufzeit-Ort = Deploy-Ziel · der Mensch stempelt.

DE · EN
1 / 6