What is an agent handoff prompt?

Definition

An agent handoff prompt records the objective, completed work, current state, important decisions, constraints, unresolved issues, evidence locations, and next useful steps. It transfers task knowledge while avoiding a full copy of every prior message or tool output.

A good handoff distinguishes durable facts from assumptions and does not silently expand authority. The receiving agent should verify current files and external state because either may have changed since the handoff was written.

ELI5

An agent handoff prompt is a short briefing for the next AI agent or session. It explains what the task is, what has already been done, which choices were made, what limits apply, and what should happen next.

For example, a handoff might say that a migration is written, two tests pass, one test still fails, and a protected file must not be changed. The next model can begin from that useful summary while checking the current project for itself.

What should an agent handoff include?

It should include the goal, completed work, current status, decisions, constraints, blockers, relevant evidence or paths, and a clear next step.

Should a handoff contain the entire previous conversation?

Usually not. A concise structured summary is easier to verify and use, while durable files should hold detailed project information that needs to persist.

  1. Portrait of Nate B. Jones beside the words Route Work by Risk
  2. Bijan Bowen beside the words Review 12,000 Lines
Definition card for agent handoff prompt: What is an agent handoff prompt?

An agent handoff prompt gives a new AI agent the concise durable context needed to continue a task without reconstructing the previous session.