---
name: subagent
description: Delegate one bounded task to the native subagent tool, which runs a fresh context-isolated Pi sequentially and returns its result. Use for independent investigation, implementation, review, or verification that should inherit normal Pi and project resources but not the current conversation. MUST use when the user asks for a subagent, fresh Pi, isolated context, or sequential delegation.
---

# Subagent

Call the native `subagent` tool with one self-contained task. Wait for it to
finish and review its answer before continuing. The child shares the working
tree but receives none of the parent conversation.

Do not inspect Superpowers' subagent skills, search for dispatch binaries, or
invent a named role. The native `subagent` tool is the dispatch mechanism.

## Task prompt

Pass a multiline `task` value directly to the tool. Describe the bounded task
and expected deliverable, state whether the child may edit files, and include
only facts it cannot discover from the project. Tell the child to complete the
task itself without delegating again.

The tool streams the child's thinking, assistant text, tool starts and
completions, retries, and diagnostics through the current command as they
arrive. It also stores the exact prompt, full Pi event stream, diagnostics,
native session, final response, and metadata under `.pi/subagents/runs/`.

Check the child's claims and inspect any shared-working-tree changes before
using them.

## Isolation

The tool starts a new Pi JSON session in a unique session directory. It never
continues, resumes, forks, or opens another session. It enables normal project
trust and reloads the Bakery Pi package, so the child receives Bakery's
extension and global skills in addition to normally discovered system prompts,
context files, settings, tools, extensions, packages, and skills.