english/.opencode/skills/cook/references/subagent-patterns.md

Subagent Patterns

Standard patterns for spawning and using subagents in cook workflows.

Task Tool Pattern

Task(subagent_type="[type]", prompt="[task description]", description="[brief]")

Research Phase

Task(subagent_type="researcher", prompt="Research [topic]. Report ≤150 lines.", description="Research [topic]")

• Use multiple researchers in parallel for different topics
• Keep reports ≤150 lines with citations

Scout Phase

Task(subagent_type="scout", prompt="Find files related to [feature] in codebase", description="Scout [feature]")

• Use /ck:scout ext (preferred) or /ck:scout (fallback)

Planning Phase

Task(subagent_type="planner", prompt="Create implementation plan based on reports: [reports]. Save to [path]", description="Plan [feature]")

• Input: researcher and scout reports
• Output: plan.md + phase-XX-*.md files

UI Implementation

Task(subagent_type="ui-ux-designer", prompt="Implement [feature] UI per ./docs/design-guidelines.md", description="UI [feature]")

• For frontend work
• Follow design guidelines

Testing

Task(subagent_type="tester", prompt="Run test suite for plan phase [phase-name]", description="Test [phase]")

• Must achieve 100% pass rate

Debugging

Task(subagent_type="debugger", prompt="Analyze failures: [details]", description="Debug [issue]")

• Use when tests fail
• Provides root cause analysis

Code Review

Task(subagent_type="code-reviewer", prompt="Review changes for [phase]. Check security, performance, YAGNI/KISS/DRY. Return score (X/10), critical, warnings, suggestions.", description="Review [phase]")

Project Management

Task(subagent_type="project-manager", prompt="Run full sync-back in [plan-path]: reconcile completed tasks with all phase files, backfill stale completed checkboxes across all phases, update plan.md status/progress, and report unresolved mappings.", description="Update plan")

Documentation

Task(subagent_type="docs-manager", prompt="Update docs for [phase]. Changed files: [list]", description="Update docs")

Git Operations

Task(subagent_type="git-manager", prompt="Stage and commit changes with conventional commit message", description="Commit changes")

Parallel Execution

Task(subagent_type="fullstack-developer", prompt="Implement [phase-file] with file ownership: [files]", description="Implement phase [N]")

• Launch multiple for parallel phases
• Include file ownership boundaries