>> 100k+ Zeilen solo refactoren: Claude Code 4.8 Dynamic Workflows und parallele Subagenten

Einleitung

Kann ein Entwickler allein eine Legacy-Codebasis mit über 100.000 Zeilen ohne sechsmonatiges Taskforce-Team refaktorisieren? Im Mai 2026 lieferte Anthropic Claude Opus 4.8 und eine Claude-Code-Funktion namens Dynamic Workflows — ein Research-Preview-Muster, bei dem der Agent plant, parallele Subagenten ausrollt und Ergebnisse verifiziert, bevor er berichtet (Claude Opus 4.8 Ankündigung).

Claude Code Dynamic Workflows zielen genau auf den Schmerz von Full-Stack-Teams bei sprach- oder frameworkübergreifenden Migrationen: zu viele Dateien für ein Chat-Fenster, zu viele Abhängigkeiten für eine sequenzielle Agent-Schleife. Dieser Artikel zerlegt den Ausführungsbaum, wann er klassisches Single-Thread-Claude-Code schlägt, und ein Sieben-Schritte-Runbook für Repos mit echter Test-Suite.

Wenn Sie noch Agent-Grundlagen (Evals, Kontextlimits) aufbauen, lesen Sie zuerst KI-Skills für Entwickler 2026; Dynamic Workflows verstärken gute Gewohnheiten — sie ersetzen sie nicht.

Was sich mit Opus 4.8 und Dynamic Workflows ändert

Anthropic beschreibt drei Mechanismen, die für Migrationsarbeit zählen:

Opus 4.8 betont auch Ehrlichkeit bei Unsicherheit — frühe Tester berichten weniger unbemerkte Mängel im generierten Code vs. Opus 4.7. Bei Migrationen bedeutet das weniger falsche „fertig“-Zustände, wenn Tests nie liefen.

Verfügbarkeit (aktuelle Docs prüfen): Dynamic Workflows starteten in Research Preview auf Claude Code für Enterprise-, Team- und Max-Pläne. API-Modell-ID: claude-opus-4-8. Effort-Control umfasst xhigh für schwere Langläufer.

Architektur: der Multi-Agenten-Ausführungsbaum

Dynamic Workflows sind ein flacher Orchestrierungsbaum, kein unkoordinierter Schwarm.

Komponenten

Datenfluss

1. Definieren Sie den Migrationsvertrag: Ziel-Framework, verbotene APIs, Definition of Done = grüne CI.
2. Lead-Agent inventarisiert Repo und erzeugt N parallelisierbare Einheiten (oft 50–200+ bei 100k-LOC-Monolithen).
3. Subagenten haben read-only auf geteilte Policy-Docs und write nur in ihrem Slice.
4. Verifier aggregiert Fehler; Lead respawnt fehlgeschlagene Einheiten oder eskaliert mit Dateipfaden.
5. Sie mergen, wenn die Test-Suite-Bar erreicht ist — nicht wenn das Modell „complete“ sagt.

Das entspricht Anthropics Beispiel: codebase-scale Migrationen über hunderttausende Zeilen vom Kickoff bis Merge, mit der bestehenden Test-Suite als Bar.

Entscheidungsmatrix: wann Dynamic Workflows gewinnen

Wenn Ihr Repo unter 30 % Test-Coverage auf berührten Modulen hat, starten Sie keine Dynamic Workflows. Investieren Sie zwei Wochen in Golden-Path-Tests; sonst optimieren parallele Agenten plausible Diffs, nicht korrektes Verhalten.

Voraussetzungen vor dem Start

1. CI unter 45 Minuten auf Clean Checkout — oder Slice-CI mit Merge Queue.
2. Formatter + Linter in CI erzwungen (Agenten konvergieren schneller mit Auto-Fix-Loops).
3. Migrations-Playbook in docs/migration/ (verbotene Patterns, Ziel-Idiome).
4. Branch-Strategie: ein Integrationsbranch; Worker auf Topic-Branches oder gestapelte PRs.
5. Token-Budget: Opus 4.8 mit xhigh für lange Jobs; höherer Verbrauch als Opus 4.7 Defaults.

Für IDE/Agent-Hygiene (Allowlists, Secrets) siehe Cursor und alternative Stacks — Prinzipien gelten auch für Claude-Code-Shells.

Sieben-Schritte-Migrations-Runbook

Schritt 1 — Baseline und Scope einfrieren

git checkout -b migration/opus-48-baseline git rev-parse HEAD > .migration/baseline.sha CI=1 npm test 2>&1 | tee .migration/baseline-test.log

Pass: Baseline-Tests grün oder Fehler in KNOWN_FAILURES.md dokumentiert.

Schritt 2 — Migrationsvertrag schreiben

Create MIGRATION.md with:

• Ziel-Stack-Version (z. B. React 19, Spring Boot 3.4)
• In Scope Verzeichnisse
• Out of Scope (generierter Code, vendored libs)
• Done = npm test && npm run lint grün

Schritt 3 — Dynamic Workflow in Claude Code starten

1. Opus 4.8 wählen (claude-opus-4-8).
2. Effort xhigh für mehrstündige Migrationen.
3. Prompt-Muster unten nutzen und MIGRATION.md plus Baseline-SHA anhängen.

Dynamic Workflows sind in Research Preview auf berechtigten Claude-Code-Plänen.

Plane eine Codebase-Migration gemäß MIGRATION.md.\nPartitioniere in parallele Work Units ≤ 2k LOC.\nStarte Subagenten für Transforms.\nVerifiziere mit bestehender Test-Suite vor Done-Meldung.

Schritt 4 — Planner-Manifest reviewen

Manifest in git speichern: .migration/units.json.

Schritt 5 — Worker laufen lassen; Fan-out monitoren

• Gleichzeitige Edits pro Verzeichnis begrenzen, wenn VCS-Konflikte steigen.
• Formatter nach jedem Batch-Merge erneut ausführen.
• Keine Drive-by-Refactors außerhalb Migrations-Scope akzeptieren.

Rechnen Sie bei großen Repos mit Dutzenden bis Hunderten Subagenten.

Schritt 6 — Verifier-Gate und CI

git fetch --all npm test 2>&1 | tee .migration/final-test.log diff .migration/baseline-test.log .migration/final-test.log > .migration/test-delta.txt

Pass: keine neuen Fehler jenseits dokumentierter Known List.

Schritt 7 — Human Merge und Postmortem

• Gespawnte / fehlgeschlagene / retried Units
• Wall-Clock-Stunden vs. Schätzung
• Token-Verbrauch (Anthropic Usage Dashboard)
• Defekte in Staging innerhalb 7 Tage

Bei Bedarf hinter Feature Flag auf main mergen.

Parallele Subagenten-Taktiken für 100k LOC

Anthropic merkt an, Subagenten können auf Opus 4.8 länger laufen — setzen Sie dennoch explizite Wall-Clock-Ceilings (z. B. 20 Minuten pro Unit), damit ein hängender Worker den Baum nicht blockiert.

Fehlerbehebung

Fehler A — „Migration complete“, aber CI rot

Muster: Lead-Summary meldet Erfolg; npm test schlägt lokal fehl.

Fix:

1. Session mit .migration/final-test.log wieder öffnen.
2. Prompt: Fehlschlagende Tests pro Work Unit aus units.json auflisten. Nur failed Units respawnen.
3. Merge blocken, bis Verifier passende CI-Run-URL oder Log-Hash referenziert.

Fehler B — Merge-Konflikt-Sturm

Muster: >30 % der Units berühren dieselben 5 Dateien (z. B. zentrale index.ts).

Fix: Re-Plan mit Serialisierungs-Spur für Shared Files — ein Subagent besitzt Barrel-Exports; andere liefern sequentiell angewendete Patches.

git diff --name-only migration/opus-48-baseline...HEAD | sort | uniq -c | sort -nr | head

Dateien mit Count > 3 sind Merge-Hotspots.

Fehler C — Rate Limits / Token-Erschöpfung

Muster: Subagenten stallen mid-tree; Partial Commits auf Branches.

Fix: Fan-out pausieren; completed Units mergen; mit kleinerem Batch fortsetzen (z. B. 25 Units). xhigh nur auf verbleibende harte Slices — kein kompletter Repo-Restart.

Empfohlener Pfad nach Teamgröße

Nur ein Wochenende: Scope auf 20k LOC mit vollen Tests; Workflow beweisen, bevor Sie auf den Monolithen setzen.

FAQ

Was sind Claude Code Dynamic Workflows?
Ein Research-Preview-Orchestrierungsmodus, in dem Claude Code eine große Aufgabe plant, viele parallele Subagenten in einer Session ausführt und die Ausgabe verifiziert, bevor es fertig meldet — für repo-scale Arbeit wie Migrationen (Quelle).

Brauche ich speziell Claude Opus 4.8?
Anthropic band Dynamic Workflows an die Opus-4.8-Generation für längere, zuverlässigere Agent-Runs. Nutzen Sie Modell-ID claude-opus-4-8 und prüfen Sie, ob Ihr Plan Claude-Code-Research-Features enthält.

Kann wirklich eine Person 100k+ Zeilen refaktorisieren?
Eine Person kann orchestrieren, wenn CI stark ist und Transforms überwiegend mechanisch sind. Semantische Rewrites brauchen weiter Human-Review-Spuren — Dynamic Workflows komprimieren Kalenderzeit, nicht Verantwortung.

Wie viele parallele Subagenten laufen?
Anthropic nennt Hunderte in einer Session bei großen Migrationen. Ihre effektive Zahl sollte durch Merge-Konfliktdaten begrenzt werden, nicht das theoretische Maximum.

Was ist die Bar für „fertig“?
Die bestehende automatisierte Test-Suite — nicht der Selbstbericht des Modells. Verifier-Output als Pre-Merge-Checkliste behandeln, nicht als CI-Ersatz.

Ersetzt das OpenClaw/Dify-ähnliche Agenten?
Nein. Claude Code Dynamic Workflows sind IDE-zentrierte Repo-Refactors. Orchestrierungsplattformen (OpenClaw + Dify) lösen andere Probleme — Ops-Automatisierung und Multi-System-Workflows — und ersetzen kein diszipliniertes Migrations-Runbook.

Weiterführende Artikel

• KI-Skills, die jeder Entwickler 2026 braucht
• Cursor kostenlose Alternativen — Agent-IDE-Disziplin
• OpenClaw + Dify Workflow-Brain-Pattern