delegation

Call startAsyncSubagent once per independent task, optionally referencing task IDs from a session plan with fromPlan set to true. Each call returns immediately, and you collect all results later using waitForBackgroundTasks.

subagent blocks until the task completes and returns the result directly, while startAsyncSubagent returns immediately and runs the task in the background. Use subagent when you need the output before continuing.

Avoid delegation for simple tasks you can do directly, read-only operations like grep or glob, quick file edits, and analysis or debugging work such as code review. Subagents also cannot run workflows or preview the app.

Use messageSubagent with the subagent's alias for asynchronous fire-and-forget follow-ups, or messageSubagentAndGetResponse with a timeout when you need the reply immediately. The alias is returned when the subagent starts.

Pass skill file paths through the relevantSkills parameter using the full path from the skills view. Include every implementation skill with integration details such as auth or storage, but exclude orchestration skills meant for the main agent.