mm_handoff

Hand off a spec to another agent in the same roster: transfers the claim, the spec and the recorded lines — never the transcript. Refuses (naming the holder) when the target already holds a claim. Records the handoff in the sending agent’s transcript, states the read-first summary for the receiver, and logs the handoff in the Activity door.

At a Glance

• Category: Handoff
• Source: Built-in
• Availability: Opt-in — set MM_TOOL_GROUPS=handoff (always dispatchable by name)
• Required parameters: 7
• Total parameters: 9

Parameters

Parameter	Type	Required	Description
project_path	string	Yes	Absolute path to the project root
spec_name	string	Yes	Slug of the spec whose claim is being handed off
from_agent_id	string	Yes	The sending agent’s identifier within the roster
from_display_name	string	Yes	The sending agent’s display name
from_session_id	string	No	The sending agent’s MM session id — when given, the handoff is recorded in its own transcript
to_agent_id	string	Yes	The receiving agent’s identifier within the roster
to_display_name	string	Yes	The receiving agent’s display name
to_session_id	string	No	The receiving agent’s MM session id, when already known — the read-first line is recorded there
roster	string	Yes	The roster both agents belong to

Example

{
  "tool": "mm_handoff",
  "arguments": {
    "project_path": "/Users/you/projects/my-app",
    "spec_name": "My Example",
    "from_agent_id": "my-example",
    "from_display_name": "My Example",
    "from_session_id": "my-example",
    "to_agent_id": "my-example",
    "to_display_name": "My Example",
    "to_session_id": "my-example",
    "roster": "example-roster"
  }
}

Related Tools

• mm_resume - Resume a session on this machine: moves the transcript here and marks the ori…