Feature-Ordner als Agent-Workflow

Datum: 2026-05-15

„Bau Feature X“ im Chat liefert Halbfertigkeiten

Ein langer Chat-Auftrag erzeugt oft: halbe Diffs, fehlende Tests, vergessene Translation-Keys, Briefing out of sync. Das Modell optimiert auf sichtbaren Fortschritt im Chat – nicht auf deploybare Qualität.

Feature-Workflow behandelt große Änderungen wie Deploy-Pipelines: Briefing unter `features/`, Checkpoints, Subagents pro Gate, Ralph-Loop bis konvergent.

Das Problem

Große Features brauchen Gates – nicht Hoffnung.

Das Pattern

Ein Feature lebt in `features/001-mein-feature/`:

001. Feature-Briefing mit nummerierten Subagent-Aufträgen

002. Checkliste (Checkpoints)

003. Akzeptanzkriterien (curl, Tests, Briefing)

php start-vendor-feature.php 001

Der Orchestrator:

Pro Subagent: Ralph-Loop bis `OPEN_FAILURES=0` und `CHANGED_FILES=0`.

So sieht es bei uns aus

`start-vendor-feature.php` setzt Env-Variablen (`FEATURE_BRIEFING_REL`, Suppress-Flags für verschachtelte Loops) und ruft `start-vendor-subagent-ralph-loop.php` mit den im Feature-Briefing genannten Agents auf.

Features werden wie Mini-Projekte im Repo versioniert – nicht wie Chat-Verlauf.

Feature-Briefing-Qualität

Gut:

001. Konkrete Screens/CLIs mit Routes

002. Welcher Subagent pro Checkpoint

003. Akzeptanz: „curl `/cv` → 200“, „HomeTest grün“

Schlecht:

001. „Implementiere Caching“

002. „Mach es performant“

003. „etc.“

`subagent-refine-feature-briefing` hilft, Vages zu eliminieren.

Anti-Patterns

001. Feature nur im Chat – Nicht reviewbar, nicht wiederholbar.

002. Ein Checkpoint „alles“ – Wieder Monster-Scope.

003. Checkpoint ohne Test – Grün ohne Beweis.

004. Feature ohne Briefing-First – Code driftet sofort.

005. Vendor-Feature im Host duplizieren – `check-vendor-duplicates`.

Von Feature zu Production

features/001-…/briefing.md
    → Step 002: Implementierung (Subagents)
    → Step 003: Checkpoints (Translations, Screens, PHPUnit)
    → development-workflow
    → git-push (optional mit Agent-Commit-Message)

Jeder Gate ist binär – rot stoppt die Kette.

Häufige Fragen

Ab wann Feature-Ordner statt einzelner Subagent?

Mehrere Screens, mehrere Schichten, oder mehr als ein Tag Arbeit.

Kann ich Features parallel? – Ja, verschiedene Prefixes `001`, `002` – Git-Konflikte beachten.

Was ist mit kleinen Bugs? – `subagent-fix-fehler-und-test`, kein Feature-Ordner.

Verwandte Beiträge

Takeaway

Große Features brauchen Pipelines – nicht einen langen Prompt. Feature-Ordner + Checkpoints + Ralph-Loop machen Agent-Arbeit deploybar. Wer Features wie Releases behandelt, bekommt weniger „fast fertig“ – und mehr echte Releases.