handoff_contract
Fetch a handoff contract to spawn a subagent for executing an approved brief or verifying evidence.
Instructions
Return an ephemeral Nogra handoff contract.
Nogra execution roles are not installed as persistent Claude Code project agents. The Manager fetches a
handoff contract at a dispatch or verification boundary, then spawns Claude Code's built-in general-purpose
subagent with the returned prompt plus the approved brief, run id, scope and evidence contract.
Manager must not implement the approved scope inline. If the client cannot spawn the subagent, stop and
surface the missing primitive instead of offering a fallback.
When to use:
- After a brief is approved and a dispatch receipt/run id exists, fetch kind=executor before spawning the run agent.
- Before independent evidence checks, fetch kind=verifier before spawning a disposable verifier agent.
When NOT to use:
- Do not call repeatedly during normal lifecycle logging.
- Do not persist the returned prompt as a .claude/agents file.
- Do not use this as execution approval; the user-approved brief and dispatch receipt remain the authority.
- Do not use this to justify inline Manager execution.
Examples:
>>> handoff_contract("executor")
{"schema": "nogra.handoff.contract.v1", "status": "ready", "kind": "executor", "targetSubagent": {"type": "general-purpose", ...}}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Ephemeral Nogra handoff kind to fetch. Supported values: executor or verifier. | |
| role | No | Deprecated alias for kind. Kept only so older beta prompts fail softly during migration. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||