76 lines
2.5 KiB
Markdown
76 lines
2.5 KiB
Markdown
# 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
|