173 lines
3.3 KiB
Markdown
173 lines
3.3 KiB
Markdown
# Orchestrate Command
|
|
|
|
Sequential agent workflow for complex tasks.
|
|
|
|
## Usage
|
|
|
|
`/orchestrate [workflow-type] [task-description]`
|
|
|
|
## Workflow Types
|
|
|
|
### feature
|
|
Full feature implementation workflow:
|
|
```
|
|
planner -> tdd-guide -> code-reviewer -> security-reviewer
|
|
```
|
|
|
|
### bugfix
|
|
Bug investigation and fix workflow:
|
|
```
|
|
explorer -> tdd-guide -> code-reviewer
|
|
```
|
|
|
|
### refactor
|
|
Safe refactoring workflow:
|
|
```
|
|
architect -> code-reviewer -> tdd-guide
|
|
```
|
|
|
|
### security
|
|
Security-focused review:
|
|
```
|
|
security-reviewer -> code-reviewer -> architect
|
|
```
|
|
|
|
## Execution Pattern
|
|
|
|
For each agent in the workflow:
|
|
|
|
1. **Invoke agent** with context from previous agent
|
|
2. **Collect output** as structured handoff document
|
|
3. **Pass to next agent** in chain
|
|
4. **Aggregate results** into final report
|
|
|
|
## Handoff Document Format
|
|
|
|
Between agents, create handoff document:
|
|
|
|
```markdown
|
|
## HANDOFF: [previous-agent] -> [next-agent]
|
|
|
|
### Context
|
|
[Summary of what was done]
|
|
|
|
### Findings
|
|
[Key discoveries or decisions]
|
|
|
|
### Files Modified
|
|
[List of files touched]
|
|
|
|
### Open Questions
|
|
[Unresolved items for next agent]
|
|
|
|
### Recommendations
|
|
[Suggested next steps]
|
|
```
|
|
|
|
## Example: Feature Workflow
|
|
|
|
```
|
|
/orchestrate feature "Add user authentication"
|
|
```
|
|
|
|
Executes:
|
|
|
|
1. **Planner Agent**
|
|
- Analyzes requirements
|
|
- Creates implementation plan
|
|
- Identifies dependencies
|
|
- Output: `HANDOFF: planner -> tdd-guide`
|
|
|
|
2. **TDD Guide Agent**
|
|
- Reads planner handoff
|
|
- Writes tests first
|
|
- Implements to pass tests
|
|
- Output: `HANDOFF: tdd-guide -> code-reviewer`
|
|
|
|
3. **Code Reviewer Agent**
|
|
- Reviews implementation
|
|
- Checks for issues
|
|
- Suggests improvements
|
|
- Output: `HANDOFF: code-reviewer -> security-reviewer`
|
|
|
|
4. **Security Reviewer Agent**
|
|
- Security audit
|
|
- Vulnerability check
|
|
- Final approval
|
|
- Output: Final Report
|
|
|
|
## Final Report Format
|
|
|
|
```
|
|
ORCHESTRATION REPORT
|
|
====================
|
|
Workflow: feature
|
|
Task: Add user authentication
|
|
Agents: planner -> tdd-guide -> code-reviewer -> security-reviewer
|
|
|
|
SUMMARY
|
|
-------
|
|
[One paragraph summary]
|
|
|
|
AGENT OUTPUTS
|
|
-------------
|
|
Planner: [summary]
|
|
TDD Guide: [summary]
|
|
Code Reviewer: [summary]
|
|
Security Reviewer: [summary]
|
|
|
|
FILES CHANGED
|
|
-------------
|
|
[List all files modified]
|
|
|
|
TEST RESULTS
|
|
------------
|
|
[Test pass/fail summary]
|
|
|
|
SECURITY STATUS
|
|
---------------
|
|
[Security findings]
|
|
|
|
RECOMMENDATION
|
|
--------------
|
|
[SHIP / NEEDS WORK / BLOCKED]
|
|
```
|
|
|
|
## Parallel Execution
|
|
|
|
For independent checks, run agents in parallel:
|
|
|
|
```markdown
|
|
### Parallel Phase
|
|
Run simultaneously:
|
|
- code-reviewer (quality)
|
|
- security-reviewer (security)
|
|
- architect (design)
|
|
|
|
### Merge Results
|
|
Combine outputs into single report
|
|
```
|
|
|
|
## Arguments
|
|
|
|
$ARGUMENTS:
|
|
- `feature <description>` - Full feature workflow
|
|
- `bugfix <description>` - Bug fix workflow
|
|
- `refactor <description>` - Refactoring workflow
|
|
- `security <description>` - Security review workflow
|
|
- `custom <agents> <description>` - Custom agent sequence
|
|
|
|
## Custom Workflow Example
|
|
|
|
```
|
|
/orchestrate custom "architect,tdd-guide,code-reviewer" "Redesign caching layer"
|
|
```
|
|
|
|
## Tips
|
|
|
|
1. **Start with planner** for complex features
|
|
2. **Always include code-reviewer** before merge
|
|
3. **Use security-reviewer** for auth/payment/PII
|
|
4. **Keep handoffs concise** - focus on what next agent needs
|
|
5. **Run verification** between agents if needed
|