AI Handoff
Nazzero/ai-handoff
Documentos estruturados para continuidade perfeita entre agentes IA
Ver no GitHubAgent que gera documentos estruturados de continuidade para sessões de IA. Quando você digita /handoff, captura o contexto completo da sessão (o que foi feito, erros, estado atual, próximos passos) em um documento markdown pronto para ser lido por outro agente IA. Resolve o problema de perda de contexto entre sessões diferentes ou trocas de modelo.
Instalação
npx convez-ai Nazzero/ai-handoff1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Retomar sessões interrompidas com novo agente IA mantendo contexto completo
- Registrar decisões arquiteturais e abordagens que falharam para próximos ciclos
- Documentar estado do projeto automaticamente ao trocar de modelo ou ferramenta
Veredito

Ferramenta prática para workflows multi-agente, resolvendo um problema real (perda de contexto em transições). Funciona agnóstico com múltiplas plataformas, mas depende de prompts bem estruturados para gerar docs úteis de verdade.
README
A tradução para o português deste README ainda está na fila.
📄 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
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