Glossar¶

Diese Seite ist die Terminologie-Basis der flower-Dokumentation. Dieselbe Sache heißt auf der gesamten Site genau gleich; die Zuordnung Chinesisch–Englisch ist hier festgeschrieben — und die Übersetzungen folgen genau dieser Tabelle.

Jeder Eintrag liefert drei Dinge: worauf der Begriff zeigt, was er im Code ist und was er nicht ist. Das dritte ist oft das nützlichste, denn die meisten Missverständnisse entstehen dadurch, dass ein Begriff für einen anderen gehalten wird.

Framework und Run¶

Long-horizon¶

long-horizon

Ein Run erstreckt sich über Stunden bis Tage, über mehrere Sessions, über Prozess-Neustarts hinweg — nicht Frage und Antwort. Alle Mechanismen von flower existieren, damit ein solcher Run unterwegs nicht auseinanderfällt.

Messwert zum Vergleich: HT001 lief 10.4 Stunden am Stück.

Run¶

run

Der vollständige Ablauf einer Runtime von Anfang bis Ende. Ein Run kann intern mehrere Schritte und mehrere Sessions enthalten und nach einem Abbruch fortgesetzt werden. Die Aufzeichnung liegt in runs/manifest.json und runs/sessions.db.

Nicht: ein API-Aufruf, und auch keine Session.

Session¶

session

Ein Kontext auf Modellseite. Hat eine eigene session_id, lässt sich resumen und forken. Ein Run verbraucht womöglich mehrere Sessions — bei jedem Handoff kommt eine neue.

Schritt¶

step · Step

Eine ausführbare Einheit im Workflow. Bekommt ein Kontext-Dictionary, führt einen Agent aus und schreibt das Ergebnis in das Dictionary zurück. Step ist eine Klasse, siehe Python API.

Workflow¶

workflow · Workflow

Eine Reihe von Schritten in fester Reihenfolge, plus die Regeln dafür, wie Zustand zwischen den Schritten weitergereicht wird und wann vorzeitig abgebrochen wird.

Rollen¶

Rollen sind die Arbeitsteilung, die flower über Agents legt. Jede Rolle = ein Stück injizierter Regeltext + ein Satz Tools + ein Satz Hooks. Alle fünf Rollen sind Factory-Funktionen, siehe Python API.

Koordinator¶

coordinator · coordinator()

Der Agent auf dem Hauptthread. Er zerlegt Aufgaben, verteilt Arbeit, liest Berichte und trifft Entscheidungen, greift aber nicht selbst zu — er bekommt kein Write / Edit. Die Basis-Tools sind Agent, TodoWrite, Read (roles.py:27), aber das ist nicht die endgültige Liste: je nach Parametern kommen drei weitere Sorten dazu. glance=True (Default) fügt ein eingeschränktes Bash hinzu (gerade genug für Befehle vom Typ git status / ls, die mit einem Blick erledigt sind; kontrolliert von delegate_guard); wird ein Frage-Kanal übergeben, kommen inbox und ask dazu; und wenn die untergeordneten Worker WebFetch / WebSearch mitbringen, werden diese beiden ebenfalls mit hineingezogen — allowed_tools gilt sessionweit, und ohne das Hineinziehen bliebe der Subagent beim eigenen Aufruf in einer Berechtigungsfreigabe hängen, die niemand beantwortet (roles.py:513-526).

Die Rollenvorgabe lautet „jemand, der Claude Code bedienen kann“, nicht Worker.

Nicht: ein schlaueres Agent. Er nutzt standardmäßig dieselbe Modellklasse wie der Worker; gespart wird Kontext, nicht Modell.

Worker¶

worker · worker()

Der Subagent, der die eigentliche Arbeit macht: Code schreiben, Tests laufen lassen, recherchieren. Tools sind Read Write Edit Bash Glob Grep WebFetch WebSearch.

Das Antwortformat wird per Regeltext auf vier Abschnitte festgezurrt — Fazit / Belege / Ergebnis / Ungeprüft, höchstens 30 Zeilen; Dateiinhalte, Kommandoausgaben, Logs und Roh-Diffs einzufügen ist verboten.

Clarifier¶

clarifier · clarify()

Die Rolle, die vor dem Loslegen die Anforderung klärt. Sie tut nichts, sie fragt nur — so lange, bis es klar ist (kein Rundenlimit), und gibt am Ende einen Brief aus. Siehe Vorabklärung.

Judge¶

judge · judge()

Die Rolle, die entscheidet, ob etwas fertig ist. Sie tut eines von zwei Dingen: vor dem Start das Ziel setzen (Ziel + Prüfliste ausgeben), oder nach jeder Runde diese Runde bewerten (ein Verdict ausgeben). Siehe Zielwächter.

Entscheidend: Der Judge bewertet das Artefakt, nicht den Quellcode.

In HT001 ist genau das einmal schiefgegangen: Das Abnahmekriterium lautete „läuft direkt im macOS-Terminal“, das gelieferte Artefakt meldete unter file ELF 64-bit LSB pie executable, ARM aarch64, GNU/Linux — und das Verdict war trotzdem bestanden.

Zwei Punkte müssen klar sein, sonst wird das Beispiel falsch gelesen:

1. Das Fehlurteil kam nicht vom Zielwächter — HT001 hatte diesen Mechanismus noch nicht; falsch geurteilt hat ein Auditor, den der Koordinator von sich aus losgeschickt hatte.
2. Auch ein Judge in Default-Konfiguration würde das mit hoher Wahrscheinlichkeit übersehen. judge() setzt standardmäßig can_run=False, die Tools sind nur Read/Glob/Grep — er kann file gar nicht ausführen, er würde nur das Makefile lesen, dort tatsächlich einen Darwin-Zweig sehen und auf „erreicht“ entscheiden.

Was wirklich funktioniert, zeigt HT002: Dort hatte der Judge judge_can_run aktiviert, führte file und lsof selbst aus, sah sich die Lage vor Ort an und umging diese Falle gezielt. Der Satz „das Artefakt bewerten“ trägt also nur mit can_run=True.

Oracle¶

oracle · oracle()

Ein reiner Lese-Seitenkanal. Während der Run noch läuft, kannst du ihn fragen „wo stehen wir gerade“; er wirft einen Blick auf die letzten Events und die Workbench und antwortet dann. Was er sagt, geht nicht in den Kontext dieses Runs ein — die Frage beeinflusst den Run nicht, die Antwort wird nach der Ausgabe verworfen.

subagent¶

Ein Begriff des Claude Agent SDK: ein Sub-Agent, den das Haupt-Agent über das Tool Agent losschickt. Er hat ein eigenes Transcript; Tool-Aufrufe und Fehlversuche landen dort, der Hauptthread bekommt nur den Abschlussbericht.

Das ist die erste Schicht, mit der flower Kontext spart, und die mit dem größten Effekt. Siehe Kontextökonomie.

Die vier Mechanismen¶

Vorabklärung¶

clarify

Vor dem Loslegen die Anforderung klären, sie in einem Brief einfrieren und erst dann ausführen. Verhindert „gebaut, aber nicht das Gewünschte“. Siehe Vorabklärung.

Brief¶

brief · Brief

Das Dokument, das der Clarifier nach dem Fragen ausgibt, genau vier Abschnitte. Nachfolgende Schritte lesen es und raten die Anforderung nicht erneut.

Nicht mit dem Task Brief verwechseln. Der Brief ist „was der Mensch will“, der Task Brief ist „was dieser Subagent diesmal tut“.

Task Brief¶

task brief

Der Text, den der Koordinator beim Verteilen der Arbeit an den Worker schreibt. Nur das, was für diese Aufgabe spezifisch ist — Disziplin, die das Gegenüber schon kennt, nicht wiederholen.

Gemessen: 8/8 Task Briefs wiederholten Disziplin, die das Gegenüber bereits kannte; im kürzesten mit 521 Zeichen waren nur etwa 120 Zeichen aufgabenspezifisch — eine Runde verschenkte damit rund 4.8k permanenten Kontext.

Zielwächter¶

goal guard

Der Judge entscheidet nach jeder Runde unabhängig, ob das Ziel erreicht ist; ist es das nicht, geht die Arbeit zurück. Verhindert „sagt fertig, ist es aber nicht“. Siehe Zielwächter.

Verdict¶

verdict · Verdict

Das Ergebnis einer Judge-Runde, genau drei Abschnitte: Fazit / Begründung / Nicht bestanden.

Es gibt drei Fazit-Werte: ACHIEVED (erreicht), NOT_YET (noch nicht), UNREACHABLE (in dieser Umgebung nicht prüfbar). Die letzten beiden sind verschiedene Ergebnisse — „hier nicht prüfbar“ wird auf keinen Fall als bestanden gewertet.

Fortsetzung¶

continuity

Ein erneuter Lauf im selben Verzeichnis knüpft automatisch am Fortschritt des letzten an — auch dann, wenn der Prozess getötet oder die Maschine neu gestartet wurde. Verhindert „nach Stunden abgestürzt, alles von vorn“. Siehe Fortsetzung.

Nicht mit dem Handoff verwechseln: Fortsetzung knüpft prozessübergreifend an den letzten Run an; ein Handoff wechselt innerhalb desselben Runs auf eine neue Session.

Handoff¶

handoff

Wenn der Kontext fast voll ist, schreibt die aktuelle Session ein Handoff-Dokument, das ein Mensch lesen und ändern kann; dann übernimmt eine neue Session. Verhindert „Kontext voll, alles zu einer Zusammenfassung zerquetscht“. Siehe Handoff.

Nicht Compact. Siehe Compact.

Handoff-Dokument¶

handoff document · Handoff

Das beim Handoff geschriebene Dokument, fünf Abschnitte: doing (was gerade läuft), decided (was entschieden wurde), deadends (Wege, die nicht funktionieren), next (nächster Schritt), scene (Lage vor Ort).

Nur doing und next sind Pflicht — würde man erzwingen, dass „Wege, die nicht funktionieren“ nicht leer ist, zwingt man das Modell zum Erfinden.

Compact¶

compact

Das native Vorgehen von Claude Code: Ist der Kontext voll, wird der bisherige Dialog zu einer Zusammenfassung verdichtet.

flower benutzt es nicht, sondern ersetzt es durch den Handoff. Der Unterschied: Die Zusammenfassung ist modellgeneriert, nicht lesbar, nicht änderbar, und was verloren geht, weißt du nicht; das Handoff-Dokument ist strukturiert, liegt auf der Platte, und du kannst es öffnen, eine Zeile ändern und weiterlaufen lassen.

Kontextverwaltung¶

Hauptthread¶

main thread

Der Session-Kontext, in dem der Koordinator sitzt. Er ist der einzige Kontext, der durch den gesamten Run trägt, also der, bei dem Sparen am meisten zählt.

So erkennt der Code den Hauptthread: In den Hook-Daten steht kein agent_id. Hooks von Subagents tragen ein agent_id.

Workbench¶

workbench · Workbench

Das Arbeitsverzeichnis auf der Platte, drei Unterverzeichnisse:

INDEX.md ist der Index dieser drei Verzeichnisse und wird in den System-Prompt injiziert, damit das Agent in jeder Runde weiß, was es zur Hand hat.

Spill¶

spill

Überschreitet ein Tool-Ergebnis den Schwellwert (Default 4000 Zeichen), schreibt der PostToolUse-Hook es nach <Workbench-Wurzelverzeichnis>/spill/; im Kontext bleibt nur eine Zeile mit dem Pfad.

Der Pfad folgt der Workbench, er ist nicht fest verdrahtet — nur wenn die Workbench am Default-Ort <Workspace>/.flower liegt, ist er genau .flower/spill/. Ist Isolation aktiv und die Workbench per home= außerhalb des Repos, wandert der Spill mit hinaus.

Es wird sofort gekürzt, nicht erst bei vollem Kontext nachträglich compacted.

Ephemeral Command¶

ephemeral command

Ein Befehl, dessen Ergebnis veraltet und keinen Aufbewahrungswert hat — ls, git status, ps und ähnliche. Ihre Ergebnisse gehen nicht in die persistierte Session-Aufzeichnung. Die Entscheidungen „darf der Hauptthread damit kurz nachsehen“ und „wird das Ergebnis herausgeschnitten“ laufen über dieselbe Funktion, deshalb sind beide Mengen immer gleich.

Trim¶

trim · TrimmingSessionStore

Schreibt vor dem Resume die Nachrichten um, die dem Modell zurückgefüttert werden (Ergebnisse von Ephemeral Commands, überlange Tool-Ausgaben).

Es überschreibt nur load(): Der Originaltext in SQLite bleibt unangetastet, gekürzt wird nur die Fassung, die bei diesem Resume in den Kontext geht. Trim ist damit umkehrbar — mit einer anderen Strategie noch einmal resumen, und du bekommst wieder die vollständige Aufzeichnung.

Prune¶

prune · PruningSessionStore

Hält Fehlermeldungen aus dem Kontext heraus. Der Haufen Fehler, der während der Wiederholungen bei Netzausfall entsteht, hat nach dem Resume nichts im Kontext zu suchen.

Nicht mit Trim verwechseln: Trim wirft nach Umfang und Wert weg, Prune nach der Frage „ist das ein Fehler“.

Laufzeit¶

Isolation¶

isolation

Markierte Rollen bekommen automatisch ein eigenes Git-Worktree, erzwungen per Hook, nicht über den Prompt. So kommen sich parallele Änderungen am selben Repo nicht in die Quere.

Resilience¶

resilience · Resilience

Bei Netzausfall hängen bleiben und warten statt mit Fehler auszusteigen: DNS- und TCP-Proben beobachten die Lage, nach Rückkehr des Netzes läuft es per Resume weiter. Die während des Wartens entstehenden Fehlermeldungen hält Prune aus dem Kontext heraus.

Lineage¶

lineage · Lineage

Hält prozessübergreifend fest, aus welcher Session dieser Run geforkt wurde; liegt in lineage.json. Die Fortsetzung findet darüber, wo der letzte Lauf stehengeblieben ist.

Nicht mit dem Run-Manifest verwechseln — das ist runs/manifest.json und führt die Abrechnung jedes Runs.

Run-Manifest¶

run manifest · runs/manifest.json

Die Abrechnung jedes Runs: wie viel Geld, wie lange, wie groß der Kontext. Die Zahlen auf den Fallseiten lassen sich hier nachrechnen.

Wake¶

wake · wake_state()

Die rein lesende Sondierung vor dem Start: prüfen, ob in diesem Workspace bereits ein Brief und ein Ziel liegen, und daraus entscheiden, ob es ein Neustart oder eine Fortsetzung wird. Es wird kein einziges Byte geschrieben.

wake_state() ist der einzige Ort, an dem der Workbench-Pfad definiert wird — auch ein Treiberprogramm, das wissen will, wo der Brief liegt, muss dort durch. Ein selbst zusammengebastelter, falscher Pfad wirft keinen Fehler, er fällt still aus.

Event¶

event · Event

Der Nachrichtenstrom des SDK, flachgeklopft zu einer stabilen Struktur. Die Interaktionsschicht kennt nur Event und importiert keinerlei SDK-Typen — das ist die Grenze, dank der ein UI-Wechsel den Kern nicht anfasst.

Interaktionsschicht¶

interaction layer

Die UI-Schicht zwischen Mensch und Run. Default ist das Terminal, ersetzbar durch Web, TUI, HTTP oder vollautomatisch ohne Aufsicht. Siehe Interaktionsschicht wechseln.

Session Store¶

session store · SessionStore

Das Persistenz-Backend für Session-Nachrichten. Der Default SqliteSessionStore schreibt nach runs/sessions.db und lässt sich mit den beiden Wrappern Trim und Prune umhüllen.

Budget¶

budget · max_budget_usd

Die Kostenobergrenze eines Runs; wird sie überschritten, hält er an. Ohne das wird ein Long-horizon-Run teuer — HT001 hat $171.62 gekostet.

Portabilität¶

Portabel¶

portable

Auf einer anderen Maschine dasselbe Verhalten. Umgesetzt über setting_sources=[] — weder das ~/.claude/ des Hosts noch das .claude/ des Projekts wird gelesen. Domänenfähigkeiten reisen als plugin mit dem Repo, Credentials bringt .env selbst mit.

Der Preis: Credentials musst du selbst mitbringen, die Host-Konfiguration wird nicht automatisch geerbt.

Append¶

append

Domänenanweisungen werden hinter den nativen System-Prompt von Claude Code gehängt, statt ihn zu ersetzen:

system_prompt = {"type": "preset", "preset": "claude_code", "append": spec.instructions}

Spezialisierung geht damit nicht auf Kosten der allgemeinen Fähigkeiten.

plugin¶

Ein Paket mit Domänenfähigkeiten, das mit dem Repo mitreist. Wird über plugins=[local] geladen; im Verzeichnis können skills/, agents/, hooks/ und .mcp.json liegen. Siehe Deployment.