handoff · git:20260821.8b9b643 · 2026-08-21 · sha256 fa52bab9cdbca78f

handoff git:20260821.8b9b643A

Immutable. This exact content is served forever at /api/v1/blob/fa52bab9cdbca78f.

---
name: handoff
description: Transfer the current coding, debugging, planning, or architecture session to AI Badger. Use for broad session continuation; use badger-review for an independent review.
---

# Badger Handoff

Create `.badger-handoff` in the current working directory, or another workspace
directory explicitly selected by the user. Do not discover a Git root.

Summarize the useful conversation aggressively, giving later decisions and
corrections precedence. Preserve the current goal, progress, decisions and
rationale, constraints and non-goals, completed work, verification, blockers,
and immediate next steps.

Use `mode: handoff` when repository work is part of the session. Use
`mode: design` only for reasoning where current worktree state is irrelevant.
Write this exact UTF-8 framing:

```text
BADGER-HANDOFF-V1
mode: handoff

<compact session summary>
```

Keep the complete file at or below 65,536 bytes. The body is conversation state
only: do not inspect or include repository files, diffs, Git state, or
topology. Badger collects repository context itself.

After writing successfully, derive the absolute directory from the written file
path and print exactly:

```text
Badger handoff prepared.

In a separate terminal, run:

cd '/absolute/path/to/the-written-directory'
badger continue
```

Substitute the actual POSIX-shell-quoted directory. Do not invoke Badger or use
another transport.