task

Task delegation

Use this guide only in a parent session with the delegation tool available (default task, renamed via PI_TASK_TOOL_NAME). The examples use the default name; call the actual tool name exposed in your session. This guide does not enable nested delegation in children. The tool's current agent list is authoritative; installed and project agents can override the bundled agents.

Delegate bounded, multistep work that benefits from independent judgment or fresh context. Do small lookups and straightforward edits directly. Choose the agent whose advertised scope fits; do not invent an agent name. Honor the parent session's approval, write, and side-effect constraints.

Complete the handoff

A child starts with fresh context. Referenced files are evidence, not a replacement for the parent's reasoning. Put the following in prompt: goal, scope, non-goals, write policy, acceptance criteria, verification recipe. Name relevant files, the review base or diff, and stop conditions explicitly.

Use parent_context for facts, decisions, and constraints the parent learned outside those files. Use proposed_changes for one item per intended change: its semantics and what acceptance requires. Do not ask the child to reconstruct an earlier conversation from file paths.

Reviewer tasks require explicit parent_context and non-empty proposed_changes. If there are no design changes, say so in an item rather than omitting the field.

{
  "agent_type": "reviewer",
  "description": "Audit retry settings",
  "prompt": "Goal: audit the uncommitted retry-settings diff. Scope: src/subagent/durable.ts and its tests. Non-goals: unrelated cleanup. Write policy: read-only; no paid requests. Acceptance: ranked findings with file:line evidence and a verdict. Verification: read the diff, trace retry decisions, and run the focused tests.",
  "parent_context": "The parent approved generation-level retry settings only; provider stream options are out of scope.",
  "proposed_changes": [
    "Durable children read the parent's retry policy live; cached harnesses must observe updated settings."
  ]
}