version: "1.0.0" name: godmode-handoff description: Creates structured HANDOFF.md briefs for Cowork-to-executor handoff. Includes mission, context files, acceptance criteria, constraints, approval status, write scope, and CC_GodMode Restart-Prompt. Use only when the user explicitly asks to create or update a handoff document, says 'übergib an GodMode', 'erstelle HANDOFF.md', or 'mach ne Übergabe'.

godmode-handoff — Handoff-Brief-Schreiber

Zweck

Du erstellst das verbindliche HANDOFF.md File im Projektordner. Top-Level, sichtbar.

Ein HANDOFF ist nur ausführbar, wenn ein APPROVE WRITE Contract enthalten ist. Ohne Approval ist es ein read-only Intake-Brief.

Unterschied zu `next-prompt`:

• next-prompt schreibt .cowork/pending-prompt.md (Cowork-intern)
• godmode-handoff schreibt HANDOFF.md (Top-Level)

Wann triggern

• "Übergib an GodMode/Claude Code"
• "Erstelle HANDOFF.md"
• "Mach ne saubere Übergabe"

Workflow

1. Voraussetzungen

.cowork/pending-prompt.md existiert? Ja → als Basis. Nein → erst next-prompt.

2. Identifiziere Ziel-Executor

CC_GodMode | Codex | beides

2b. Approval Status prüfen

• Liegt ein expliziter APPROVE WRITE Contract vor? Dann Approval Status: USER_APPROVED.
• Fehlt er? Dann Approval Status: DRAFT, current_state: USER_DECISION_NEEDED, und der Executor muss vor Edits stoppen.

3. HANDOFF.md Template

# HANDOFF — <Datum> — <Slug>
 
> **Status:** COWORK_PROMPT_READY → USER_DECISION_NEEDED
> **From:** Cowork Singularität v0.1.1
 
---
 
## ⚡ INITIAL INSTRUCTIONS
 
### For Claude Code (CC_GodMode):
 
If fresh session OR after `/compact`:
<CCGM_Prompt_99-ContextRestore.md Inhalt>
 
**THEN** proceed with mission below.
 
### For Codex:

approval_policy = "granular" sandbox_mode = "read-only until APPROVE WRITE exists"

Lies: AGENTS.md, .cowork/status.json, .cowork/pending-prompt.md
 
---
 
## 🎯 Mission
<2 Sätze>
 
## Approval Status
[DRAFT | USER_APPROVED]
 
APPROVE WRITE:
executor=<cowork|codex|claude-code>
branch=<topic-branch>
scope=<short task>
allowed_paths=<comma-separated globs>
forbidden_paths=<comma-separated globs>
release_impact=<none|patch|minor|major>
release_files=<none|VERSION|CHANGELOG|fragment>
checks=<commands or none>
expires=<this session only>
 
## 📋 Workflow Type
<type>
 
## 📂 Context — Read First
- `<datei>` — warum
 
## ✅ Acceptance Criteria
- [ ] Kriterium 1
 
## 🚫 Constraints
- DO NOT touch: <files>
- DO NOT add: <libs>
- MUST use: <patterns>
 
## 🔍 Cowork's Recherche
Siehe .cowork/research/<file>.md
 
## 📊 Project State Reference
- VERSION: <current>
- Reports: reports/v<X>/
- Open Handoffs: <N>
 
## 📝 Post-Execution Checklist
1. [ ] Reports nach reports/v<new>/
2. [ ] Release-Files nur updaten, wenn `release_files` sie explizit nennt
3. [ ] .cowork/status.json → EXECUTOR_DONE, falls Status-Writes freigegeben sind
4. [ ] handoff-log.md append, falls freigegeben

4. Status updaten

.cowork/status.json und handoff-log.md nur im freigegebenen Bridge-Write-Scope.

5. User informieren

✅ HANDOFF.md erstellt
🎯 Executor: <X>
Nächster Schritt: Falls Approval fehlt, Write Scope prüfen und APPROVE WRITE erteilen. Erst dann Executor starten.

Edge-Cases

• Kein Restart-Prompt verfügbar → Link zu GitHub-Source, in memory/ cachen
• Kein CC_GodMode installiert → explizit hinweisen
• Multi-Executor → HANDOFF-CC.md + HANDOFF-CODEX.md

Quality Self-Check

• [ ] Restart-Prompt-Section enthalten?
• [ ] Mission max 2 Sätze?
• [ ] Acceptance Criteria messbar?
• [ ] Post-Execution-Section drin?
• [ ] Approval Status und Write Scope eindeutig?
• [ ] DRAFT-Handoff fordert Executor zum Warten auf?

Modell-Empfehlung

Optimiert für: Haiku 4.5

Begründung: Reine Template-Generation aus strukturierten Inputs. Deterministisches Input→Output Mapping. Klassischer Haiku-Sweet-Spot.

Output-Disziplin: HANDOFF.md max 1500 Wörter.

⚠️ Skill-Frontmatter unterstützt kein model: Field — Routing-Intent.