ADR-014: Einstellung des Plugins zugunsten der OpenCode-V2-Agenten-Konfiguration
Status
Accepted (2026-10-18). Ersetzt die Laufzeit-Durchsetzung aus ADR-001, ADR-002 und ADR-010.
Context
Der Katalog awesome-opencode #514 entfernt V1-only-Plugins am 2027-01-01. Das Plugin hängt von @opencode-ai/plugin 1.x ab und exportiert die V1-Funktions-API (ADR-010). Eine Migration auf @opencode/plugin 2.x bedeutet einen Neubau aller Hooks (execute.before, Prompt-Hook, Tools mit Effect-Schema statt zod).
Vor dem Neubau wurde geprüft, was OpenCode V2 selbst kann (Quellen: @opencode/schema@2.0.32, anomalyco/opencode Tag v2.0.32):
-
Agenten-Konfiguration (
config/agent.d.ts):system,permissions(allow/deny/ask),steps,mode,model; globalinstructions,skills,policies. -
Schritt-Begrenzung (
packages/core/src/session/runner/llm.ts): -
const stepLimitReached = loaded.agent.info.steps !== undefined && step >= loaded.agent.info.steps -
toolChoice: stepLimitReached ? "none" : undefined– Tools werden beim Provider gesperrt, nicht nur per Prompt. -
if (promoted > 0) step = 1– nur eine neue Nutzereingabe setzt den Zähler zurück. -
MAX_STEPS_PROMPT: „Tools are disabled until next user input. Respond with text only.“
Zusätzlich offen: Das Tool anchor-bypass erlaubte der KI, die Schritt-Bestätigung zu umgehen (docs/issues/step-confirmation-bypass.md). Vorgabe: kein Bypass, strukturell.
Alternatives Considered
-
A – Migration als ein V2-Plugin (Baseline): gleicher Funktionsumfang, neue API.
-
B – Aufteilung in zwei V2-Plugins (
step-confirmation+semantic-anchors), ohne Bypass. -
C – Plugin einstellen, Ersatz durch V2-Agenten-Konfiguration: Anker als
system/instructions/skills, Rollen/Profile als Agenten, Tool-Sperren überpermissions, Schritt-Bestätigung übersteps+system-Regel +permissions: ask.
Pugh-Matrix (Baseline A = 0)
| Kriterium | A | B | C |
|---|---|---|---|
Durchsetzung Schritt-Bestätigung (nicht umgehbar) |
0 |
+ |
+ |
Bypass strukturell ausgeschlossen |
0 |
+ |
+ |
Wartungsaufwand (API-Wechsel, Effect-Peer-Dependency) |
0 |
− |
+ |
Abdeckung WARN-Modus / Inhaltsprüfung von Nachrichten |
0 |
0 |
− |
Nutzen für den Autor (opencode zuletzt genutzt 2026-09-06) |
0 |
0 |
+ |
Summe |
0 |
+1 |
+3 |
Decision
Option C. Das Plugin wird nicht migriert und eingestellt:
-
npm:
opencode-semantic-anchors@0.1.0als deprecated markiert (2026-10-18). -
Ersatz: V2-Agenten mit
steps(harte Obergrenze),system-Regel „nach jedem logischen Schritt anhalten“ undpermissions(askfür kritische Aktionen,denyfür Verbotenes). -
Semantische Anker bleiben Vokabular und werden als Text eingebunden (
system,instructions,skills), wie im Claude-Code-Setup überCLAUDE.md.
Consequences
Positiv
-
Schritt-Bestätigung ohne Bypass, durchgesetzt durch OpenCode selbst (
toolChoice: "none"). -
Kein eigener Code mehr zu pflegen; keine Abhängigkeit von Plugin-API-Wechseln.
-
Das offene Bypass-Issue entfällt.
Negativ
-
WARN-Modus und Inhaltsprüfung von Nachrichten (z. B. Source-Anchor) entfallen. Beide waren reine Textmuster-Prüfungen.
-
stepszählt Modell-Aufrufe, keine logischen Schritte. Ein logischer Schritt bleibt eine Anweisung imsystem-Prompt;stepsist die harte Obergrenze dahinter. -
Der Katalogeintrag in awesome-opencode entfällt (spätestens 2027-01-01).
Offen
-
Praktischer Test von
stepsmit OpenCode V2 (bisher nur Quellcode-Analyse).
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.