Rollback-Plan opencode → Claude Code

Rollback-Plan

Wenn die opencode-Migration scheitert oder ein Show-Stopper auftritt der ad-hoc nicht behebbar ist: Pfad zurueck zu Claude Code.

Wann Rollback ausloesen

Trigger-Bedingungen:

• opencode crasht reproduzierbar bei einem Workflow den Marvin taeglich braucht
• Bedrock-API hat anhaltenden Outage > 4h waehrend produktiver Phase
• MCP-Integration in opencode ist instabil und blockiert Kunden-Arbeit
• AWS-Kosten explodieren ueber 200 USD/Monat in einer Woche und keine Erklaerung
• Custom-Commands-Migration scheitert in Phase 3 und Coding-Pipeline-Ersatz funktioniert nicht

Trigger NICHT:

• Einzelne MCPs failen (siehe issues.md — 5 von 13 sind heute schon failed, das ist OK)
• Einzelne Skills sind noch nicht migriert (das ist die ganze Migration)
• Bedrock-Modell antwortet langsamer als Anthropic-direct (Sub-Second-Differenz ist normal)
• Eine bestimmte Behavior Rule wird vom Modell nicht perfekt befolgt (war auch in CC nicht perfekt)

Rollback-Schritte

Schritt 1: opencode aus dem PATH nehmen

# brew-installation bleibt, aber Binary kurzfristig deaktivieren
sudo mv /opt/homebrew/bin/opencode /opt/homebrew/bin/opencode.disabled
# oder via brew unlink
brew unlink opencode

Verification:

which opencode  # sollte nichts mehr finden
which claude    # sollte CC binary liefern

Schritt 2: CC vollstaendig wiederherstellen

CC wurde waehrend Migration nicht angefasst — sollte ohne Aenderung weiterlaufen.

claude --version  # sollte funktionieren

Wenn CC nicht startet:

• ~/.claude/settings.json checken (Backup-Tarball siehe unten)
• ~/.claude/plugins/cache/ checken — sollte intakt sein
• Im Notfall: ~/Backups/cc-pre-migration-2026-05-17.tar.gz zurueckspielen

Schritt 3: Vault-Aenderungen entscheiden

Waehrend Hybrid-Phase wurden ggf. opencode-spezifische Files ergaenzt (Custom-Commands die als Skill-Migrations-Schritte gebaut wurden, AGENTS.md-opencode-Sektion in CLAUDE.md).

Optionen:

• Behalten — die opencode-Sektion in CLAUDE.md ist ein No-Op fuer CC (Rule 20 funktioniert dort weiter)
• Entfernen — wenn Marvin „komplett zurueck” will. Branch opencode-migration mergen rueckgaengig oder git revert <commits>

Schritt 4: Cleanup nach 4 Wochen ohne Rollback-Bedarf

Wenn nach 4 Wochen klar ist dass Rollback nicht mehr noetig wird:

• brew uninstall opencode
• rm -rf ~/.config/opencode
• rm -rf ~/.opencode (alte Plugin-SDK-Reste)
• rm -rf ~/.local/share/opencode
• Bedrock-Costs in AWS-Account checken (sollten auf 0 fallen)

Backup-Tarball (Pre-Migration-State)

Damit Rollback verlustfrei laeuft: Snapshot von Migration-relevanten CC-Files.

Status 2026-05-17: Tarball erstellt ✓

• Pfad: ~/Backups/cc-pre-migration-2026-05-17.tar.gz
• Groesse: 41 KB
• Inhalt: 22 Memory-Files + settings.json + settings.local.json + claude.json
• Plugin-Cache ~/.claude/plugins/cache/agentic-ventures BEWUSST nicht im Tarball — der ist re-downloadable aus dem Marketplace, riesig, und Plugin-Files leben sowieso im Vault unter intern/capabilities/skills/

Tarball-Inhalt:

• CC settings (global + local)
• claude.json (MCPs + projects)
• Memory-Files (22 Stueck)
• agentic-ventures-Plugin-Cache

NICHT im Backup: ~/.claude/sessions, ~/.claude/cache — diese sind ephemeral und vertretbar zu verlieren.

Sanity-Check nach Rollback

Nach Rollback sollte folgendes wieder funktionieren:

• claude startet im Vault
• Skill-Tool laedt agentic-ventures-Plugin-Skills
• compound-engineering-Pipeline (ce:plan etc.) ist aufrufbar
• Memory-Files werden geladen (Stichprobe: User-Profile-Info wird zitiert)
• MCPs in CC connecten (gsuite, hetzner, etc.)
• Vault ist git-clean oder erwartbar-dirty (kein Schaden durch Migration-Files)

Lessons-Learned bei Rollback

Wenn Rollback ausgeloest wird: in intern/wissen/entscheidungen/<datum>-opencode-rollback.md festhalten:

• Trigger (was genau hat nicht funktioniert)
• Welche Phase war zu dem Zeitpunkt
• Was haette man fruher merken muessen
• Ob ein zweiter Migrations-Versuch sinnvoll waere (mit was anders)