compose:subagent

Executes implementation plans by dispatching fresh subagents per task with two-stage review gates.

Updated Jun 27, 2026
One-click install
npx skills add https://github.com/HKUST-QUANT-SOCIETY/quantcode --skill compose-subagent-hkust-quant-society
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: compose:subagent
Source: https://github.com/HKUST-QUANT-SOCIETY/quantcode/tree/main/.opencode/meta-skills/subagent
Command: npx skills add https://github.com/HKUST-QUANT-SOCIETY/quantcode --skill compose-subagent-hkust-quant-society

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Executing a multi-task implementation plan in a single conversation pollutes context, degrades quality, and makes review inconsistent. This Skill orchestrates plan execution by dispatching a fresh subagent per task with curated context, then enforcing spec-compliance and code-quality review gates before marking any task done. ## Core Features & Use Cases - Fresh subagent per task: Each task gets an isolated implementer subagent with exactly the context it needs, preserving the controller's context for coordination. - Two-stage review gate: Spec compliance review (two-phase, evidence-gated verdict) always runs before code quality review; tasks cannot be marked done until both pass. - Structured status handling: Implementer statuses (DONE, DONE_WITH_CONCERNS, NEEDS_CONTEXT, BLOCKED) each have defined handling paths including model escalation and task splitting. - Use Case: Given a plan file with five independent tasks, the controller extracts all tasks, dispatches implementer subagents bound to tracked task IDs, runs spec and quality reviewers after each, and finishes with a final whole-implementation review before merge. ## Quick Start Use the subagent skill to execute the implementation plan in plans/feature-plan.md, dispatching one subagent per task with spec and quality reviews after each.

Frequently Asked Questions about compose:subagent

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

FAQPage Schema
How do I execute an implementation plan with subagents?

Read the plan once, extract all tasks with full text, create a tracked task per plan task, then dispatch a fresh implementer subagent per task bound to its task ID. After each implementation, run spec compliance review first, then code quality review, before marking the task done.

What is the difference between subagent-driven development and parallel session execution?

Subagent-driven development stays in the same session with no context switch, using a fresh subagent per task and automatic review checkpoints. Parallel session execution hands the plan to a separate session, which suits work that should not share the current conversation.

How does the spec compliance review gate work?

The spec reviewer runs in two phases: phase 1 receives only the covered spec sections and the git diff, returning a per-claim verdict; phase 2 runs only if phase 1 flagged items, letting the implementer's report explain flagged diffs. The task passes only when every in-scope claim passes with verifiable evidence.

Which model should I use for implementer and reviewer subagents?

Use cheap models for mechanical single-file tasks, standard models for multi-file integration, and the most capable model for architecture and review. The spec reviewer must be at least as capable as the implementer to avoid rubber-stamping shared misreadings.

What should I do when an implementer subagent reports BLOCKED?

Assess the blocker: provide more context and re-dispatch if it is a context problem, use a more capable model if reasoning is the issue, split the task if it is too large, or escalate to the human if the plan itself is wrong. Never force the same model to retry unchanged.

When should I not use subagent-driven development?

Avoid it when there is no implementation plan yet, when tasks are tightly coupled and cannot run independently, or when work belongs in a separate parallel session. In those cases brainstorm first or use the parallel execution workflow instead.