---
name: handoff
description: Create a structured handoff summary for continuing work in a new session. Use when you need to pause and resume later or transfer context to another agent.
---

# Handoff

Create a portable handoff summary that captures current state, context, and next steps for another agent or future session.

## When to Use

- "Create a handoff"
- "Summarize this for another agent"
- "I need to pause and resume later"
- "Write a context handoff"

## Process

1. Run the helper script to generate a structured summary.
2. Add or edit the **Goal**, **Open Questions**, and **Next Steps** sections.
3. Paste the output into the new session or share with another agent.

## Helper Scripts

### handoff.sh

**Usage**:
```bash
./scripts/handoff.sh --goal "Short goal description" --output /tmp/handoff.md
```

**Examples**:
```bash
./scripts/handoff.sh --goal "Implement worker RPC launcher"
./scripts/handoff.sh --goal "Audit web skills" --output /tmp/handoff.md
```

**Notes**:
- If `--output` is omitted, the handoff is printed to stdout.
- Requires a git repository for full context. If not in a git repo, only basic info is included.

## Requirements

- `git` in PATH
- Bash 4+ shell
