📄 AI-Handoff

Type /handoff — your AI generates a complete session summary for the next agent to pick up seamlessly.

What was done. What failed. What's next. One command.

---

💡 Why

AI sessions are stateless. Context resets — new session, different model, token limit — and everything learned is lost. Handoff docs give the next agent a structured briefing so work continues, not restarts.

---

🤖 Supported Tools

Claude Code	Codex	Gemini CLI	Cursor	Windsurf	Cline
Amazon Q	Vibe	OpenCode	📝 Any AI CLI

Works with any AI tool that reads markdown instructions.

---

✨ What it does

When you run /handoff, the AI reviews its own conversation and generates a structured doc:

Section	What it captures
✅ Completed	What got done, file paths, status
❌ Incomplete	Blockers and exact errors
🔄 Current State	What's working vs what's broken
🚫 Failed Approaches	Dead ends — so the next agent doesn't repeat them
⚖️ Key Decisions	Choices made and why
▶️ Resume Instructions	Step-by-step to continue
🏗️ How It Works	Architecture context
⚙️ Setup Required	Env vars, deps, test data
💻 Code Context	Key signatures and API shapes
⚠️ Warnings	What not to touch and why
📁 Key Files	Quick reference to relevant paths

Output: Handoff_Docs/handoff_YYYY-MM-DD_[short-task-name].md

---

📦 Install

Claude Code (plugin)

claude plugin marketplace add NazzWay/ai-handoff
claude plugin install ai-handoff@NazzWay-ai-handoff

Then restart Claude Code and use /handoff in any session.

OpenCode

Copy the repo into your project, then add to ~/.config/opencode/opencode.json:

{
  "instructions": ["CLAUDE.md"]
}

Gemini CLI

cp GEMINI.md /path/to/your/project/
cp -r skills/ /path/to/your/project/skills/

Gemini CLI auto-reads GEMINI.md.

Codex

cp AGENTS.md /path/to/your/project/
cp -r skills/ /path/to/your/project/skills/

Codex auto-reads AGENTS.md.

Cursor

cp -r .cursor/ /path/to/your/project/.cursor/
cp -r skills/ /path/to/your/project/skills/

Activates when you mention "handoff".

Windsurf

cp -r .windsurf/ /path/to/your/project/.windsurf/
cp -r skills/ /path/to/your/project/skills/

Cline

cp -r .clinerules/ /path/to/your/project/.clinerules/
cp -r skills/ /path/to/your/project/skills/

Amazon Q

/load skills/handoff/SKILL.md

Mistral Vibe

cp skills/handoff/SKILL.md ~/.vibe/prompts/handoff.md

📝 Any other AI tool

Copy skills/handoff/SKILL.md into your tool's instructions directory. If it reads markdown, it runs handoff.

---

🚀 Usage

/handoff

Or just say:

• "make a handoff"
• "write a handoff doc"
• "generate handoff"

---

📐 Template

# HANDOFF: [Task Title]
Date | Agent | Branch | Status
Goal

## COMPLETED
## INCOMPLETE
## CURRENT STATE
## FAILED APPROACHES (Don't Repeat)
## KEY DECISIONS
## RESUME INSTRUCTIONS
## HOW IT WORKS
## SETUP REQUIRED
## CODE CONTEXT
## WARNINGS
## KEY FILES

See skills/handoff/SKILL.md for the full template with placeholders.

---

🗂️ Repo Structure

ai-handoff/
├── .claude-plugin/plugin.json       ← Claude Code plugin
├── .cursor/rules/handoff.mdc        ← Cursor rule
├── .windsurf/rules/handoff.md       ← Windsurf rule
├── .clinerules/handoff.md           ← Cline rule
├── AGENTS.md                        ← Codex
├── CLAUDE.md                        ← Claude Code / OpenCode
├── GEMINI.md                        ← Gemini CLI
├── LICENSE                          ← MIT
├── README.md
└── skills/
    └── handoff/
        └── SKILL.md                 ← Core skill (one file, every tool)

---

📄 License

MIT