subagent-guide

Determine when to split complex requests into parallel subagent workstreams.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/Handy369/passto-pi-frame --skill subagent-guide-handy369
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: subagent-guide
Source: https://github.com/Handy369/passto-pi-frame/tree/main/skills/subagent-guide
Command: npx skills add https://github.com/Handy369/passto-pi-frame --skill subagent-guide-handy369

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Subagent-guide helps you decide when delegation and parallel subagent execution will actually improve outcomes, and prevents wasting time on unnecessary or unsafe task splitting.

Core Features & Use Cases

  • Decision-first delegation: guides agents to evaluate whether the task has multiple independent workstreams, needs isolated second opinions, or benefits from reducing coordination cost.
  • Spawn vs fork mode selection: recommends the cheaper, safer approach (spawn for self-contained sub-tasks) and uses fork only when deep dependency on parent context is unavoidable.
  • Robust task boundary design: instructs how to define self-contained sub-tasks with clear “done” criteria and avoid mixing execution with planning.

Quick Start

Tell your AI to handle the task by first checking whether it can be split into multiple independent workstreams, then delegate in parallel to subagents using self-contained tasks with an explicit spawn/fork rationale, and finally merge the results.

Frequently Asked Questions about subagent-guide

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
When should I use parallel subagent workflows for task decomposition?

Use parallel subagent workflows for multi-file risk analysis, multi-option comparisons, or separating implementation, review, and verification into independent tasks. Avoid parallelization for small actions or strongly serial dependencies.

How do I choose between spawn mode and fork mode for subagent delegation?

Select spawn mode for self-contained sub-tasks to ensure safe, cheaper delegation. Use fork mode only when a subagent has deep dependency on parent context that cannot be isolated.

How do I split a complex code review workflow into independent subagent tasks?

Separate implementation, review, and verification into bounded independent tasks. Delegate these self-contained sub-tasks in parallel to subagents, ensuring each has clear done criteria before merging results.

Can I parallelize tightly-coupled actions across multiple subagents?

No, avoid parallelizing tightly-coupled actions or strongly serial dependencies. Unnecessary delegation for small tasks wastes time and increases coordination cost without improving outcomes.

What are the limitations of using subagent parallelization for task splitting?

Limitations include strongly serial dependencies, tightly-coupled actions, and small tasks. Parallelization prevents mixing execution with planning and avoids unnecessary delegation when independent workstreams are absent.