Log in
← All docsStart

Your first handoff

Prove that a second Agent or session can continue one project without mixing scopes or inventing authority.

The first useful proof is not OAuth success. It is a second Agent or session opening the same project, recovering the state you intentionally preserved, and continuing without mixing in another project's Context.

1. Choose one continuing project

Use a real project you expect to revisit. If your Space has several projects, note the exact project name. Do not create a new project only to run this guide.

2. Open the first session

Ask the first Agent:

Call session_open for the Website Launch project. Tell me the project name returned by the tool and summarize the Project index before doing any work.

Confirm that the returned project is the one you intended. If it is wrong, stop and open the correct project explicitly.

3. Preserve three different states

During a small piece of real work, ask the Agent to keep these states distinct:

  • one decision you explicitly confirmed;
  • one Agent proposal you have not confirmed;
  • one open question that still needs your judgment.

Ask it to update the existing project document when one already owns the topic. Revision history is safer than leaving two contradictory current documents.

4. Finish one unit of work

Let the Agent perform one approved action. Then ask it to update the project Context with the actual result and the next known state. A handoff that only creates a summary but does not reflect changed work is incomplete.

5. Open a second session or Agent

In another session or compatible MCP client, ask:

Call session_open for the Website Launch project. Read the relevant Context and tell me the confirmed decision, unresolved proposal, open question, completed result, and next action. Do not resolve anything the user has not confirmed.

6. Check the handoff

The handoff passes when:

  • the second session opened the intended project;
  • it did not use sibling-project Context as current truth;
  • it recovered the confirmed decision without another briefing;
  • it kept the proposal and open question unresolved;
  • it identified the actual completed result and next action;
  • any new work updates the same project Context again.

If one of these fails, correct the index or source document before adding more Context. Do not hide a scope or authority problem by writing another summary.

Next: Use the core workflow.