---
name: agent-handoff
description: "Give it the project's state. Get a handoff file a new agent can pick up."
---

# Hand a project to a fresh agent

Prepare a handoff from the authorized files I provide so a fresh agent can continue without this chat. Use the project’s current files as evidence; distinguish confirmed facts, judgments and unknowns. Do not assume the receiver can see local paths, credentials, browser sessions or attachments unless its access is confirmed.

Save handoff.md with the objective, current state, authoritative source paths/links, completed changes, actual validation results, unresolved decisions, next action, expected output and stop conditions. Include only history that changes the receiver’s work. Mark unrun checks as unrun and proposals as proposals. Describe how to obtain needed inputs without granting access or exposing secrets.

Check the handoff against its source files. If an independent fresh receiver is available and its use is authorized, let it attempt the next action using only the handoff and accessible inputs, and record what it actually did. Otherwise label the check “Source check only; fresh receiver not tested.” Do not simulate a receiver and call that independent proof. Do not send the handoff to another chat/person, run the next task or grant access unless separately authorized. Return the saved handoff and remaining access gaps.

## Required inputs

- Authorized project files and current work record
- Scope, desired outcome and the receiver’s known access

## Expected outputs

- Self-contained handoff file
- Source and validation references
- Next action with stop conditions

## Checks

- The next action is possible from the supplied handoff and accessible files.
- Actual validation, unrun checks and open decisions are distinct.
- Private data and inaccessible machine paths are not mistaken for usable shared inputs.
- A source check is not labeled an independent receiver test.

## Limits

- Separate chats do not automatically share context, files or permissions.
- A handoff cannot transfer credentials or computer access by describing them.
- Creating a new chat, messaging it and executing its next task require actual authorization.

Revision: 2.0.1. [Read the complete kit](files/README.md) before use. This optional format is not a claim of support by every tool.