Frontier Plan OpenCode Executor
Kernprinzip
Der Frontier-Plan ist eine starke Hypothese, nicht die absolute Wahrheit.
Führen Sie die Absicht des Plans Schritt für Schritt aus, aber validieren Sie jede Anweisung gegen das tatsächliche Repository, bevor Sie Code bearbeiten. Frontier-KI-Pläne scheitern häufig an: nicht vorhandenen Dateinamen, erfundenen Importen, nicht verfügbaren Bibliotheken, Mustern, die nicht zum Repository passen, fehlenden Tests, idealisierter Architektur und der Verletzung interner APIs.
Nehmen Sie niemals große Änderungen in Batches vor. Überspringen Sie niemals die Verifikation. Verbergen Sie niemals Unsicherheit. Führen Sie niemals destruktive Aktionen ohne ausdrückliche Genehmigung durch.
Verwendungszweck
- Sie erhalten einen detaillierten, mehrschrittigen Implementierungsplan, der von einer Frontier-KI geschrieben wurde
- Der Plan hat 3+ eindeutige Schritte mit spezifischen Dateipfaden und Codermustern
- Sie verwenden ein nicht-Frontier-Codierungsmodell, das von Ausführungsdisziplin profitiert
- Der Plan birgt das Risiko, mit der tatsächlichen Codebasis zu kollidieren
NICHT verwenden für:
- Änderungen an einer einzelnen Datei oder triviale Korrekturen
- Pläne mit nur 1-2 einfachen Schritten
- Pläne, die Sie selbst in derselben Sitzung geschrieben haben
- Schnelle Iterationen, bei denen der Benutzer Geschwindigkeit über Sicherheit stellt
Kern-Workflow
0. PREFLIGHT: Repository-Baseline ermitteln
Bevor Sie eine Datei berühren, verstehen Sie den Repository-Zustand und erkennen Sie bereits vorhandene Fehler.
1. git status --short # Ist das Repository sauber?
2. Inspizieren Sie package.json # Verfügbare Skripte, Abhängigkeiten
3. Inspizieren Sie AGENTS.md, README.md # Projektkonventionen, Befehle
4. Erkennen Sie verfügbare Verifikationsbefehle aus package.json-Skripten
5. Führen Sie die günstigste Basislinien-Verifikation durch, falls verfügbar (Lint oder Typprüfung)
Wenn die Basislinie bereits fehlschlägt:
- Notieren Sie den Fehler explizit: genauer Befehl, Exit-Status und kurze Fehlerzusammenfassung
- Versuchen Sie NICHT, eine umfassende Bereinigung durchzuführen oder nicht zusammenhängende Probleme zu beheben
- Fahren Sie nur fort, wenn die geplante Änderung vom vorhandenen Fehler isoliert werden kann
- Schreiben Sie bereits vorhandene Fehler nicht Ihrer Implementierung zu
Erkennung gefährlicher Zustände:
- Wenn
git statusnicht festgehaltene Änderungen anzeigt, die nicht mit dem Plan zusammenhängen, warnen Sie den Benutzer - Wenn Lockfiles geändert wurden, warnen Sie den Benutzer
- Wenn sich das Repository in einem Konflikt/Rebasing-Zustand befindet, stoppen Sie und fragen Sie nach
Checkpoint-Empfehlung:
- Wenn das Repository vor dem Start sauber ist, empfehlen Sie, einen Checkpoint-Commit vor der Implementierung zu erstellen
- Erstellen Sie KEINE Commits, es sei denn, der Benutzer fordert Sie ausdrücklich dazu auf
Auto-Commit und Auto-Push
Auto-Commit und Auto-Push sind standardmäßig aktiviert, es sei denn, der Benutzer deaktiviert sie explizit.
Der Agent sollte jede verifizierte logische Arbeitseinheit committen und in den aktiven Remote-Arbeitsbranch pushen, damit der Benutzer den Verlauf später überprüfen kann.
Vor der Implementierung:
- Identifizieren Sie den aktuellen Branch;
- Wenn Sie sich auf
main,master,production,releaseoder einem anderen geschützten Hauptentwicklungsbranch befinden, erstellen Sie einen neuen Arbeitsbranch, der aus dem Plan abgeleitet wird; - Wenn Sie sich bereits auf einem Arbeitsbranch befinden, arbeiten Sie dort weiter;
- Pushen Sie niemals direkt in geschützte Hauptentwicklungsbranches.
Wenn bereits nicht festgehaltene Änderungen vorhanden sind:
- Binden Sie diese nicht automatisch in Agent-Commits ein;
- Stagen Sie nur Dateien, die mit der aktuellen logischen Einheit zusammenhängen;
- Wenn Benutzeränderungen und Agentenänderungen nicht sicher getrennt werden können, stoppen Sie und melden Sie den Konflikt.
Committen Sie erst nach:
- die logische Einheit ist abgeschlossen;
- die Verifikation erfolgreich war;
- der Diff inspiziert wurde;
- der Commit einen kohärenten Zweck hat.
Verwenden Sie Conventional Commits:
type(scope): concise imperative summary
Beispiele:
feat(auth): add session validation helper
fix(api): handle empty webhook payload
refactor(billing): extract invoice mapper
test(auth): cover expired session flow
1. PARSE: Extrahieren und Realitätsprüfung des Plans
Lesen Sie den GESAMTEN Plan. Extrahieren Sie geordnete Schritte. Führen Sie für jeden Schritt eine Realitätsprüfung durch:
| Prüfung | Frage |
|---|---|
| Dateien | Existieren referenzierte Dateien im Repository? |
| Bibliotheken | Sind referenzierte Bibliotheken in package.json? |
| Muster | Hat das Repository bereits ein äquivalentes Dienstprogramm/eine äquivalente Komponente? |
| Befehle | Sind die Verifikationsbefehle des Plans verfügbar? |
| Abhängigkeiten | Hängt dieser Schritt von einem vorherigen Schritt ab? |
| Risiko | Niedrig / Mittel / Hoch — wie wahrscheinlich ist es, dass bestehendes Verhalten kaputt geht? |
Wenn ein Schritt auf fehlende Dateien, nicht vorhandene Bibliotheken, veraltete Muster oder nicht verfügbare Befehle verweist: Passen Sie den Schritt vor der Implementierung an, wobei Sie die Absicht des Plans bewahren.
2. TRACK: Fortschrittsverfolgung erstellen
Verwenden Sie todowrite (OpenCodes Aufgabenlistentool), falls verfügbar.
Falls todowrite nicht verfügbar ist (z. B. in Subagenten, wo es standardmäßig deaktiviert ist):
- Erstellen Sie eine sichtbare Markdown-Checkliste in Ihrer Antwort
- Aktualisieren Sie sie nach jedem Schritt manuell
- Verwenden Sie sie als Quelle der Wahrheit für den Fortschritt
- Tun Sie NICHT so, als ob das Tool verwendet wurde, wenn es das nicht war
Jeder Eintrag muss enthalten: die Implementierungsaktion, die Verifikationsmethode und die erwarteten berührten Dateien.
3. IMPLEMENT: Ein Schritt nach dem anderen
Markieren Sie den aktuellen Schritt als in_progress. Implementieren Sie NUR diesen Schritt.
- Lesen Sie Zieldateien vor dem Bearbeiten
- Befolgen Sie bestehende Codebase-Konventionen (Importe, Benennung, Muster, Architektur)
- Passen Sie den Plan an die vorhandene Infrastruktur an (z. B. wenn der Plan sagt „Erstelle eine Toast-Komponente“, das Projekt aber Sonner verwendet, wrappen Sie Sonner, anstatt von Grund auf zu bauen)
- Führen Sie die kleinste kohärente Änderung durch
- Implementieren Sie NICHT zukünftige Schritte, behalten Sie jedoch nachgelagerte Abhängigkeiten bei Designentscheidungen im Hinterkopf
- Führen Sie KEINE unnötige Bereinigung, Refaktorisierung oder Formatierung durch
- Installieren Sie KEINE Abhängigkeiten, es sei denn, dies wurde ausdrücklich genehmigt
4. VERIFY: Abgestufte Verifikation
Führen Sie nach jedem Schritt die engste sinnvolle Verifikation durch. Nicht jedes Mal „alles linten".
| Änderungstyp | Minimale Verifikation | Stärkere Verifikation |
|---|---|---|
| Neue Datei/Komponente | Lint oder Typprüfung | betroffene Typprüfung |
| Typ-/Schnittstellenänderung | Typprüfung | betroffene Tests |
| Logik-/Funktionsänderung | gezielter Unit-Test | vollständige Testsuite |
| API-/Serveränderung | gezielter Integrationstest | Build + Endpunktprüfung |
| UI-Änderung | Typprüfung + Build | visuelle/manuelle Smoke-Prüfung |
| Konfigurations-/Build-Änderung | Build | saubere Installation/Build bei Bedarf |
| Datenbank-/Schemaänderung | Trockenlauf-/Prüfbefehl | Benutzerfreigabe erforderlich |
Falls für einen Schritt keine automatisierte Verifikation existiert: Führen Sie eine manuelle Überprüfung durch und geben Sie genau an, was Sie geprüft haben.
Wenn die Verifikation fehlschlägt:
Erster Fehler — beheben und erneut verifizieren:
- Beheben Sie nur Fehler, die durch den aktuellen Schritt verursacht wurden
- Beheben Sie NICHT bereits vorhandene oder nicht zusammenhängende Fehler
- Verifizieren Sie sofort erneut
Wiederholte Fehler — patchen Sie nicht blind weiter. Siehe „Umgang mit wiederholten Fehlern" unten.
Kritisch: Lassen Sie die Verifikation niemals dadurch bestehen, dass Sie Zusicherungen abschwächen, Tests löschen, Verhalten entfernen, öffentliche APIs ändern, Fehler unterdrücken oder Fehler verbergen — es sei denn, der Plan erfordert dies explizit UND der Benutzer stimmt zu. Den Alarm zum Schweigen zu bringen ist nicht dasselbe wie das Problem zu beheben.
5. DIFF: Änderungen inspizieren
Nach erfolgreicher Verifikation inspizieren Sie, was sich tatsächlich geändert hat:
git diff --stat # Welche Dateien haben sich geändert?
git diff # Wenn der Diff klein genug ist, um ihn zu überprüfen
Bestätigen Sie:
- Nur erwartete Dateien haben sich geändert
- Es fand keine unnötige Formatierung statt
- Es haben sich keine Lockfiles geändert (sofern nicht ausdrücklich beabsichtigt)
- Es wurden keine generierten Dateien versehentlich bearbeitet
- Es wurden keine Geheimnisse, lokalen Pfade oder Debug-Logs eingeführt
- Es wurde kein Code versehentlich gelöscht
Wenn der Diff den erwarteten Umfang überschreitet, stoppen Sie und korrigieren Sie ihn, bevor Sie fortfahren.
6. CONFIRM: Als abgeschlossen markieren
Nur wenn Implementierung, Verifikation UND Diff-Inspektion sauber sind:
- Markieren Sie den Schritt als
completed - Fassen Sie in einem Satz zusammen, was sich geändert hat
- Markieren Sie den nächsten Schritt als
in_progress
7. FINAL: Vollständige Verifikation + Bericht
Nach allen Schritten:
- Führen Sie die stärkste sinnvolle Prüfung durch: Lint + Typprüfung + Build + Tests (mit den Projektbefehlen)
- Berichten Sie: abgeschlossene Schritte, geänderte Dateien, Verifikationsergebnisse, vorgenommene Anpassungen, bereits vorhandene Fehler (falls vorhanden), alles, was einer Benutzerüberprüfung bedarf
Umgang mit wiederholten Fehlern
Wenn die Verifikation wiederholt aus demselben zugrunde liegenden Grund fehlschlägt, fahren Sie nicht fort, kleine blinde Korrekturen anzuwenden. Das Ziel ist zu erkennen, ob Sie zwischen den Versuchen etwas Neues lernen oder nur zufällig herumprobieren.
Wenn ein Schritt mehrmals fehlschlägt:
- Hören Sie auf zu patchen. Hören Sie auf, kleine Änderungen vorzunehmen und neu zu starten.
- Lesen Sie die Fehlerausgabe sorgfältig erneut. Den vollständigen Stacktrace, nicht nur die erste Zeile.
- Inspizieren Sie den Diff und den umgebenden Code.
git diff, lesen Sie verwandte Typen, Schnittstellen, Funktionen. - Bewerten Sie die ursprüngliche Annahme neu. Ist die aktuelle Implementierungsstrategie richtig?
- Klassifizieren Sie den Fehler:
- Falsche Annahme über die Codebasis?
- Repository-Diskrepanz (Plan vs. Realität)?
- Falsche Abstraktion gewählt?
- Schnittstellen- oder Typeninkompatibilität?
- Fehlende Abhängigkeit?
- Veraltete generierte Artefakte?
- Bereits vorhandenes Problem, das nichts mit Ihrer Änderung zu tun hat?
- Der Verifikationsbefehl selbst ist falsch konfiguriert?
- Bilden Sie eine wirklich neue Hypothese. Wiederholen Sie den Versuch nur, wenn Sie eine haben.
- Ziehen Sie in Betracht, den Umfang zu reduzieren. Kann der Schritt in kleinere Teile aufgeteilt werden, um den Fehler zu isolieren?
Kritische Regel: Wiederholen Sie nicht dieselbe Korrekturstrategie, es sei denn, es wurden neue Informationen aus … gewonnen:
- Logs
- Stacktraces
- Diffs
- Tests
- Repository-Inspektion
- Dokumentation
Wenn nach mehreren Versuchen keine neue Strategie hervorgeht, stoppen Sie und melden Sie den Blocker klar:
Blocker:
- Verifikationsbefehl: `npm run build`
- Fehlerhafte Datei: `src/app/page.tsx`
- Hypothese zur Ursache: React Server Component importiert Client-Only-Hook
- Versuchte Strategien:
1. Import in Client-Komponente verschoben
2. Hook in separate Datei isoliert
3. Vorhandene Muster im Repository überprüft
- Grund für das Anhalten:
Kein konsistentes Muster im Repository, um die Grenze sicher aufzulösen
- Nächste wahrscheinliche Aktion:
Benutzerüberprüfung oder architektonische Klärung
Ein klarer Blocker-Bericht ist immer besser, als „schlägt immer noch fehl" zu wiederholen, während man rät.
Anpassen von Plänen an vorhandenen Code
Frontier-KI-Pläne stehen häufig im Konflikt mit der tatsächlichen Codebasis. Wenn das passiert:
- Identifizieren Sie den Konflikt — „Der Plan sagt
import { X } from 'uninstalled-lib', aber es ist nicht in package.json" - Passen Sie an, ignorieren Sie nicht — Verwenden Sie die vorhandene Infrastruktur, um der Absicht des Plans zu entsprechen
- Erklären Sie die Anpassung — Ein Satz, was Sie geändert haben und warum
- Bewahren Sie die Schnittstelle des Plans — Wenn der Plan
useToast()exportiert, sollte Ihre Anpassung immer nochuseToast()exportieren, auch wenn die Interna abweichen
Kritische Regeln:
- Erstellen Sie KEINE neuen Abstraktionen, wenn das Repository bereits ein äquivalentes Primitiv hat
- Installieren Sie KEINE neuen Abhängigkeiten, es sei denn, der Plan erfordert dies explizit UND der Benutzer stimmt zu
- Ändern Sie NICHT die Architektur oder Muster ohne Begründung
Ohne ausdrückliche Benutzerfreigabe verboten
Diese Befehle erfordern, dass der Benutzer „ja" sagt, bevor sie ausgeführt werden:
Destruktiv:
rm -rfgit reset --hardgit clean -fdgit push --force
Installation (ändert Lockfiles):
npm installpnpm installyarn installbun installnpm audit fix
Datenbank / Infrastruktur:
prisma migrateprisma db pushsupabase db pushdocker compose down -v
Konfiguration:
- Ändern von
.env-Dateien - Ändern der globalen Tool-Konfiguration
- Ausführen von Deploy-/Unpublish-Befehlen
Massenänderungen:
- Breite Formatierung (prettier/eslint --fix für das gesamte Repository)
- Suchen-und-Ersetzen über viele Dateien ohne Überprüfung
Wenn Sie sich nicht sicher sind, ob ein Befehl sicher ist, fragen Sie vor der Ausführung.
Häufige Fehler
| Fehler | Realität |
|---|---|
| „Die Frontier-KI hat es gesagt, also muss es richtig sein" | Frontier-Pläne sind Hypothesen. Validieren Sie gegen das reale Repository. |
| „Ich werde alles am Ende verifizieren" | Fehler summieren sich. Verifizieren Sie jeden Schritt mit der richtigen Granularität. |
| „Ich habe den Plan bereits gelesen, ich kann alles auf einmal implementieren" | Batch-Implementierung = Batch-Fehler + schwierigeres Debugging. |
| „Ich werde die vorhandenen Lint-Fehler beheben, solange ich hier bin" | Nicht zusammenhängende Bereinigung verschleiert, was Ihre Änderungen tatsächlich bewirkt haben. Nicht tun. |
| „Dieser Schritt ist einfach, ich muss den git Diff nicht überprüfen" | Einfache Bearbeitungen können versehentlich Code löschen oder unbeabsichtigte Dateien formatieren. |
| „Ich werde die fehlende Bibliothek installieren, auf die der Plan verweist" | Fragen Sie zuerst. Die Bibliothek ist möglicherweise absichtlich nicht vorhanden oder nicht genehmigt. |
| „npm run build ist die einzige Verifikation, die zählt" | Build ist langsam und breit. Verwenden Sie Lint/Typprüfung für Zwischenschritte. |
| „Wenn es fehlschlägt, werde ich einfach optimieren und erneut ausführen, bis es klappt" | Blindes Patchen ohne neue Informationen ist Herumprobieren. Lesen Sie Fehler erneut. Bilden Sie zuerst eine neue Hypothese. |
| „Der gleiche Fehler wieder, lassen Sie mich eine andere kleine Änderung versuchen" | Gleicher Fehler + gleiche Strategie = gleiches Ergebnis. Ändern Sie die Strategie, nicht den Patch. |
Rote Flaggen — STOPPEN und neu bewerten
- „Ich werde nach dem nächsten Schritt auch verifizieren" — Verifizieren Sie JETZT.
- „Der Frontier-Plan weiß es besser als das Repository" — Das Repository ist die Quelle der Wahrheit.
- „Diese Bibliothek ist nicht installiert, aber der Plan braucht sie" — Fragen Sie den Benutzer. Installieren Sie nicht stillschweigend.
- „Der Diff ist größer als erwartet, aber es ist wahrscheinlich in Ordnung" — Inspizieren und erklären, bevor Sie fortfahren.
- „Ich werde die Schritte 2 und 3 zusammenfassen, da sie zusammenhängen" — Ein Schritt = ein Verifikations- + Diff-Zyklus.
- „Vorhandene Lint-Fehler, lassen Sie mich diese zuerst beheben" — Nicht Ihre Aufgabe. Notieren Sie sie. Bleiben Sie fokussiert.
- „Lassen Sie mich diese Datei formatieren, während ich sie bearbeite" — Separate Änderung = separater Schritt. Nicht mischen.
- „Schlägt immer noch fehl, lassen Sie mich eine weitere schnelle Korrektur versuchen" — Hören Sie auf zu patchen. Lesen Sie den Fehler erneut. Bilden Sie zuerst eine neue Hypothese.
- „Der gleiche Fehler 3 Mal, noch eine Optimierung könnte funktionieren" — Gleicher Fehler + gleiche Strategie = Herumprobieren. Ändern Sie die Strategie oder melden Sie den Blocker.
- "Ich werde einfach das Ganze neu schreiben und sehen, ob das das Problem behebt" — Arbeit wegzuwerfen, ohne zu verstehen, warum sie fehlgeschlagen ist, lehrt nichts. Diagnostizieren Sie zuerst.
- „Der Benutzer hat es eilig, ich werde die Diff-Prüfung überspringen" — 5 Sekunden
git diff --statverhindern stundenlanges Debugging.
Kurzreferenz
| Phase | Aktion | Tool |
|---|---|---|
| Preflight | git status, Befehle erkennen, Basislinienprüfung | Bash |
| Parsen + Realitätsprüfung | Plan lesen, jeden Schritt gegen das Repository validieren | Lesen + Glob |
| Verfolgen | todowrite erstellen | |
| Implementieren | Dateien lesen, anpassen, minimale Änderung vornehmen | Editor |
| Verifizieren | Engste Verifikation für den Änderungstyp ausführen | Bash |
| Diff | git diff --stat + git diff | Git |
| Bestätigen | Schritt als abgeschlossen markieren | Aufgabenliste |
| Finale | Stärkste Verifikation + Bericht | Bash + Aufgabenliste |