diff --git a/.opencode/commands/handoff.md b/.opencode/commands/handoff.md new file mode 100644 index 0000000..22323e9 --- /dev/null +++ b/.opencode/commands/handoff.md @@ -0,0 +1,37 @@ +--- +description: Session-Übergabe generieren oder laden +agent: build +model: 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 `):** + - 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.