convez.ai
AgenteAutomaçãoIntermediário
Nazzero

AI Handoff

Nazzero/ai-handoff

Documentos estruturados para continuidade perfeita entre agentes IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent 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-handoff

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 7 meses
Versão
—
Issues abertas
0
Contribuidores
2

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:

SectionWhat it captures
✅ CompletedWhat got done, file paths, status
❌ IncompleteBlockers and exact errors
🔄 Current StateWhat's working vs what's broken
🚫 Failed ApproachesDead ends — so the next agent doesn't repeat them
⚖️ Key DecisionsChoices made and why
▶️ Resume InstructionsStep-by-step to continue
🏗️ How It WorksArchitecture context
⚙️ Setup RequiredEnv vars, deps, test data
💻 Code ContextKey signatures and API shapes
⚠️ WarningsWhat not to touch and why
📁 Key FilesQuick 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

Ver o original no GitHub

Bom para

Relacionados