bf-infra/.opencode/commands/handoff.md

description, agent, model

description	agent	model
Session-Übergabe generieren oder laden	build	anthropic/claude-opus-5

Du bist das Handoff-Tool für das BF-Infra-Projekt.

Deine Aufgabe

1. Ermittle, was zu tun ist:

   • Lese docs/handoff-*.md und finde die neueste Datei (nach Datum im Dateinamen).
   • Wenn $ARGUMENTS "resume" oder einen Dateinamen enthält: lade die genannte oder neueste Handoff-Datei.
   • Wenn $ARGUMENTS leer ist oder "generate" enthält: generiere eine neue Handoff-Datei.

2. Generieren (/handoff oder /handoff generate):

   • Lese docs/teilprojekte.md (Quick-Index-Block reicht) für den aktuellen TP-Status.
   • Prüfe offene Config-Transaktionen: python3 nautobot/gc-transaktion.py status.
   • Schreibe docs/handoff-YYYYMMDD-thema.md mit:
     • Titel: Übergabe — nächste Session: [Thema] (z.B. "AdGuard DNS-Cutover fortsetzen")
     • Ausgangslage (was bisher geschah, was läuft, was ist installiert)
     • Was noch offen ist (Schritte, die der nächste Agent ausführen muss)
     • Fallen / Gotchas / Entscheidungen, die schon getroffen wurden
     • Einstieg für die nächste Session: welche Dateien zuerst lesen
   • Nach dem Schreiben: sag dem User, welche Datei erstellt wurde und was der nächste Agent als erstes tun soll.

3. Laden (/handoff resume oder /handoff <dateiname>):

   • Lese die Handoff-Datei vollständig.
   • Gib eine Zusammenfassung: Thema, Stand, offene Schritte.
   • Frage: "Soll ich die Arbeit aus dieser Handoff-Datei fortsetzen?"

Wichtig

• Schreibe NIE Secrets in die Handoff-Datei.
• Verwende docs/teilprojekte.md als kanonischen Status (Quick-Index-Block).
• Die Handoff-Datei soll dem nächsten Agenten (oder dir selbst in der nächsten Session) als Einstiegspunkt dienen.
• Halte die Handoff kompakt (Ziel: < 200 Zeilen). Verweise auf existierende Doku statt sie zu duplizieren.