- name
SKILL.md
스킬 파일은 게시자의 저장소에 그대로 있습니다.
복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add shinpr/ai-coding-project-boilerplate --skill subagents-orchestration-guide -a cursor -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add shinpr/ai-coding-project-boilerplate --skill subagents-orchestration-guide -a claude-code -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add shinpr/ai-coding-project-boilerplate --skill subagents-orchestration-guide -a codex -y복사한 명령을 터미널에 붙여넣습니다. 이 SKILL.md가 해당 에이전트에 설치됩니다.
npx skills add shinpr/ai-coding-project-boilerplate --skill subagents-orchestration-guide -a grok -y복사한 메시지를 Grok Bot 채팅에 보냅니다. Bot이 GitHub에서 이 SKILL.md를 가져와 모든 Bot이 공유하는 스킬에 추가합니다.
Install this skill: https://github.com/shinpr/ai-coding-project-boilerplate/tree/HEAD/.claude/skills-en/subagents-orchestration-guide게시자 제공
Explicit User Instruction: The user explicitly instructs and authorizes every subagent call named in the invoked recipe. Execute each applicable call when its prerequisites are met.
When receiving a new full-cycle task, pass the user requirements to requirement-analyzer and keep the user's wording in the orchestrator. Compare the returned scope and cost evidence against that wording to run requirement convergence and assign Structural Scale. Classify evaluation requests, speculative ideas, and prescribed mechanisms from the user's wording rather than from analyzer output. The orchestrator owns both judgments. Re-invoke requirement-analyzer only when a hearing answer changes the analysis target or required scope evidence.
Before routing calls at workflow entry or resumption, resolve the mode from the user's explicit mode selection, then the Workflow Mode directive in the loaded root CLAUDE.md, otherwise Normal Mode. An explicit session selection applies until the user changes it and takes precedence over the repository default.
The flows below describe Normal Mode. For Lite Mode, read references/lite-mode.md and apply its call set and quality boundary. Invoke retained calls and consume only results they actually produced. User-approval stops and authority boundaries remain applicable in both modes.
Treat a proposed change to the outcome, desired-future requirements, or non-goals as a requirement change. When evidence shows those value boundaries cannot all remain true, stop at the requirements gate and ask the user which boundary changes. A technical design or implementation correction that preserves them is not a requirement change, including removal of a working technical choice that is no longer needed; passing an earlier phase does not establish that its means remain necessary. Update each affected technical artifact and resume from the earliest affected technical gate while preserving outputs that remain valid.
Requirement reopening after codebase analysis: When the first codebase-analyzer result after the requirements are selected shows existing behavior that serves a requirement's need and falls short only of extra behavior that requirement specifies, whichever field reports it, compare that evidence with the scope facts the requirements stop presented. Continue without a stop when that stop already presented the same difference. When the evidence is new, or more specific in a way that could change the user's selection, present it with its cost effect at one requirements stop before UI Spec, ADR, or Design Doc work, and let the user keep or change the requirement. When the workflow's scope confirmation stop directly follows that result, present it there instead of adding a stop. Requirements are selected from shallow scope evidence, and every later phase builds and reviews against them, so this first design-depth analysis is the one point where repository evidence can reduce them. Apply the answer through Requirement Change Detection and continue; later analyses do not reopen requirements this way.
I pass what to accomplish and where to work. Each specialist determines how to execute autonomously.
I pass to specialists (what/where/constraints):
I let specialists determine (how):
Decision precedence when outputs conflict:
An explicit restriction in the user instruction or the outcome, desired-future requirements, or non-goals is a hard boundary. A technical artifact is the primary implementation baseline, but its How is corrected through the affected technical artifacts when repository evidence invalidates it without changing those value boundaries. Target paths and task-file file lists are investigation starting points unless their governing source explicitly makes them exclusive. Unrelated improvements remain outside the active change.
Each specialist's agent definition owns its canonical result shape. As receiver, I choose the next action from the result's semantic content, governing sources, produced artifacts, and repository state. Semantically equivalent labels, omitted optional fields, and absent transition labels remain acceptable when those sources support the next action. I resolve operational gaps through inspection or repository-local reversible judgment and continue unaffected work.
I continue incomplete implementation while repository evidence supplies an action that advances the outcome. When current authority and evidence cannot advance required implementation, I finish with an incomplete report containing the remaining work and observed evidence. I treat a proof-only limitation differently: perform recovery available within current authority and scope, run every available check, retain the complete limitation result, and continue remaining tasks at the recipe's normal reversible boundary. Before final verification, I re-invoke the applicable quality-fixer once with the same scope and affected check; a pass result clears the retained proof limitation, stub_detected routes through incompleteImplementations, and only a repeated verification_incomplete result is reported. I claim only observed proof. User interaction is reserved for choosing a change to value boundaries or authorizing an irreversible external action.
Apply references/review-resolution.md to actionable deliverable-review findings. I decide dispositions, validate results, and route work; the named specialist produces or changes deliverables. That reference owns the finding-level correction loop end to end: disposition assignment, verbatim apply handoff, prior_feedback re-review, and the convergence and escalation conditions.
I understand each subagent's responsibilities and assign work appropriately:
task-executor Responsibilities (DELEGATE these):
quality-fixer Responsibilities (DELEGATE these):
Task cycle: Accept each task's implementation result and required integration/E2E review, apply the selected mode's quality boundary, then commit the completed task at the recipe's commit point. Normal Mode runs quality-fixer per task; Lite Mode uses the Final Quality Run. Each task retains its focused verification.
Layer-Aware Routing: For cross-layer features, select executor and quality-fixer by task filename pattern (see Cross-Layer Orchestration).
Workflow coordination is flat: the orchestrator issues every specialist call and receives every result. Specialist definitions keep Agent outside their tool sets.
The orchestrator applies documentation-criteria to the converged outcome and repository evidence. Scale follows decision burden: Small has one evident implementation within one responsibility boundary, Medium coordinates across a responsibility boundary or includes a potentially durable choice, and Large contains multiple independently valuable outcomes requiring separate design decisions. File count is supporting evidence only.
A qualifying ADR raises the scale to Medium at minimum. Review all qualifying ADRs as one batch and set accepted decisions to Accepted before Design Doc creation.
All subagent invocation uses the Agent tool with:
subagent_type: Agent name (e.g., "task-executor")description: Concise task description (3-5 words)prompt: Specific instructions including deliverable pathsThe orchestrator coordinates work using only the following tools:
All implementation work (Edit, Write, MultiEdit) is performed by subagents, not the orchestrator.
Each agent declares its own input and output contract. Read that contract when composing a call, then apply Specialist Result Acceptance to the returned semantic content instead of requiring a second routing schema here.
Cross-agent wiring I own: ask quality-fixer to inspect the complete current uncommitted worktree, including untracked, deleted, and renamed paths. Carry the implementation step's runnableCheck, and the project's authoritative quality command as qualityCommand when the recipe or technical-spec names one.
Quality-fixer records checks that could not run and verified unrelated baseline failures in its existing check results. After runnable change-related checks pass, pass continues normal routing. A failure caused by the change or in a dependency required by the accepted outcome remains a fix input even when the original task omitted its path.
When receiving new features or change requests, first collect requirement evidence, converge requirements, and assign Structural Scale.
ADRBatch mode → document-reviewer batch review → resolve findings → set accepted ADRs to Accepted [Stop]DesignDoc mode → code-verifier → document-reviewer → design-sync → Design Doc approval [Stop]ADRBatch mode → document-reviewer batch review → resolve findings → set accepted ADRs to Accepted [Stop]DesignDoc mode → code-verifier → document-reviewer → design-sync → Design Doc approval [Stop]Small produces no Work Plan or task file. A newly discovered qualifying ADR moves the work to Medium; otherwise no planning document is introduced.
Start the applicable Structural Scale flow at the phase the user requested. That instruction accepts the preceding phases, so continue from that entry point rather than rechecking earlier review or approval records. Before reporting completion, verify the artifacts and results every applicable phase from that entry point requires, and complete missing work inside those phases. Return to an earlier phase only when a material change invalidates its outcome, applying Requirement Change Detection.
When the orchestrator determines from scopeEvidence.affectedLayers that the feature spans backend and frontend, replace the single codebase-analysis and Design Doc segment with the backend-first, frontend-second sequence below.
Replace the standard Design Doc creation step with per-layer creation:
Step 8 runs once and its full JSON is reused unchanged by both designers; each consumes the evidence relevant to its layer. The retained backend steps run sequentially before step 12 so the frontend designer receives reviewed backend contracts and repository verification when it ran.
Layer Context in Design Doc Creation:
design-sync: Use frontend Design Doc as source. design-sync locates the other Design Docs in docs/design/ that share its contracts.
Pass all reviewed Design Doc paths and supplied test skeleton paths to work-planner. It follows the selected implementation approach, dependencies, and earliest executable verification boundary when defining tasks.
During autonomous execution, route agents by task filename pattern. This table also defines the two executor lanes a work plan task entry selects between:
A work plan task entry records exactly one lane; task materialization copies that value and selects the filename from this table rather than inferring the layer from target paths.
After starting autonomous execution mode:
status: escalation_needed or status: blocked -> Apply Specialist Result AcceptancerequiresTestReview is true -> Execute integration-test-reviewer
status is needs_revision -> Apply Review Resolution and re-invoke the routed executor (task-executor or task-executor-frontend per Layer-Aware Agent Routing) with the same task_file and the complete apply quality-issue objects verbatim as correction_findingsstatus is blocked -> Resolve moved or renamed changed test paths and re-invoke the reviewer once. If no changed test exists despite requiresTestReview: true, return that executor-output defect to the routed executor as correction_findings. If it returns blocked again, record the review as not run and proceed to the selected mode's quality/commit boundarystatus is pass -> Proceed to the selected mode's quality/commit boundaryEvery subagent prompt must include:
Construct the prompt from the agent's Input Parameters section and the deliverables available at that point in the flow.
Two additional rules:
[placeholder] in examples below with concrete values before invoking the Agent toolState Management: Grasp current phase, each subagent's state, and next action
Information Bridging: Data conversion and transmission between subagents
Pass: the orchestrator's judged convergence record to whichever agent carries it forward. Pass it unchanged; each field's readiness label travels with it.
outcome to Success Criteria and user-authored nonGoals to Out of Scope; the PRD contains the user-selected requirements and boundaries while evaluation requests, speculative ideas, and unselected mechanisms remain only in active convergence contextRequirement Convergence when no PRD exists, and always records the fields left weak-but-explicit therenonGoals; unselected candidates create no UI Spec content
prototype_path is present, pass prototype_reference_strength: binding when implementation follows the prototype's rendering, or reference when only what the UI Spec records reaches implementation. Resolve it from what the user already stated about the prototype; ask only when neither reading is supportednonGoals as excluded from every task entry; unselected candidates create no planning obligation. At Small scale no Work Plan is produced, so the weak-but-explicit fields stay in the orchestrator's own context per the storage protocol rather than becoming blocking items in the executor promptPass to codebase-analyzer: exactly one governing source — the approved PRD path when one exists, otherwise the convergence record's requirements : codebase-analyzer JSON output as additional context in the Design Doc creation prompt. Required downstream uses:
pass or verification_incomplete. Lite Mode task commits follow accepted executor and required test-review results; the Final Quality Run precedes post-implementation review. Commits occur only at the invoked recipe's defined pointsReview a Medium change with one code-reviewer. A Large change is more than one code-reviewer can read in full; partition it into units of Work Plan tasks. A unit holds a consuming task (one delivering a screen, route, command, or job) together with the tasks it depends on through Depends on, so a contract's producer, its consumer, and every test proving their behavior are reviewed together; tasks that several units depend on form one shared unit. Each completed task belongs to one unit, whose implementationFiles are the files changed by its tasks' commits. Run at most 3 code-reviewer calls concurrently.
Reviewer findings are candidates. Create correction work only from the Review Resolution apply set.
Fix-cycle handoff: Apply Review Resolution and invoke each correction owner it selects. For an author-owned technical-artifact correction, invoke the layer-appropriate technical designer in update mode, run the artifact's existing document-reviewer and applicable design-sync gates, then re-run the originating reviewer. For an executor-owned correction, invoke the layer-appropriate executor with its original task_file or direct-scope fields plus correction_findings as the complete apply finding objects verbatim with only their dispositions added, then branch on the executor result through the per-task cycle's step 2, including its conditional integration-test-reviewer path, and run the applicable quality gate. When both owners are required, Review Resolution's author-first re-evaluation controls the order. Carry prior_feedback only to reconciliation reviewers.
Re-run rule: A reviewer's passing result stands. Re-run only a reviewer whose latest result still carries a corrected finding, passing its recorded dispositions as prior_feedback and the re-derived implementation file set so the rerun reconciles against the corrected state. After recovering a blocked review prerequisite, re-run that reviewer. Review Resolution convergence governs acceptance and preserves resolved declines.
references/review-resolution.md: Finding disposition, correction, and convergencereferences/lite-mode.md: The Lite Mode call set and Final Quality RunCoordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows. Use when routing work to subagents, executing an approved work plan, or resuming auton
---name: subagents-orchestration-guidedescription: Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation…---# .claude/skills-en/subagents-orchestration-guide/SKILL.md개요
Coordinates subagents through scale-based planning, approval, implementation, verification, and escalation flows. Use when routing work to subagents, executing an approved work plan, or resuming autonomous execution.
FAQ
게시자에게서 .claude/skills-en/subagents-orchestration-guide/SKILL.md를 다운로드하거나 경로를 복사해 저장소를 엽니다. PlugMCP는 스킬을 목록에 올릴 뿐 파일을 호스팅하지 않습니다.
게시자가 https://github.com/shinpr/ai-coding-project-boilerplate에서 관리합니다.
Claude, Cursor, Codex, Grok Build는 게시자의 저장소에서 추가한 SKILL.md를 읽을 수 있습니다. Grok Bot은 채팅에서 스킬의 GitHub 폴더 링크를 보내면 설치합니다.
focusAreas → canonical disposition-target list for the Fact Disposition Table (one row per focusArea, carrying through fact_id and evidence verbatim)simplifications → each entry whose recorded condition holds reduces new implementation surface; an entry that would remove behavior a requirement specifies goes to requirement reopening. Pass the set unchangeddataModel, dataTransformationPipelines, qualityAssurance → Existing Codebase Analysis and Verification Strategy sectionsPass to code-verifier: Design Doc path (doc_type: design-doc). Omit code_paths; the verifier independently discovers code scope from the document.
Pass to document-reviewer: verification_evidence from the latest code-verifier result and recorded Review Resolution dispositions only when verification ran; otherwise omit that input. Always pass the same codebase-analyzer JSON previously given to the designer as codebase_analysis, the governing source as requirement_context, and the original request as requirements_verbatim when applicable. The reviewer uses codebase_analysis.focusAreas to verify Fact Disposition Table coverage and the requirement context to verify the document's outcome and contract.
apply disposition → technical-designerPass to the owning designer: invoke a fresh update call with the existing Design Doc path and complete correction_findings copied verbatim with only their apply dispositions added. The artifact carries approved requirements, accepted decisions, prior evidence, and unaffected design context; add no orchestrator-authored design instructions. The designer applies its review-triggered bounded self-verification gate and updates the artifact from established evidence. The orchestrator reruns the originating verifier or reviewer only after a completed update.
Pass to next-layer technical-designer: reviewed prior-layer Design Doc path plus prior_layer_verification only when the prior-layer code-verifier ran. See Cross-Layer Orchestration section for sequencing. Use available verification discrepancies and prior-layer review findings to identify unstable contracts. Limit verified-claim inference to what actual evidence states; when the design depends on an unverified claim, record it in the frontend Design Doc's ## Cross-Layer Assumptions section with justification and a verification target. Escalate only when the dependency cannot be bounded by a downstream verification step.
Pass to work-planner: Design Doc path. Work-planner maps governing sections and ACs to implementation tasks. The Work Plan does not turn missing coverage or missing design content into a user-confirmation item.
Pass to acceptance-test-generator: Design Doc path; UI Spec path (if exists).
Orchestrator verification: Every path in generatedFiles[] exists on disk. An empty list is a valid generation result.
Pass to work-planner: generated paths. Work-planner assigns each skeleton to the earliest task where it becomes executable.
ADR Status Management: After the user decision, invoke the owning technical designer in update mode to set each ADR status (Accepted/Rejected)