gh-l-sypniewski-claude-code-toolkit-plugins-development-workflow/skills/workflow-orchestration/SKILL.md

name, description

name	description
workflow-orchestration	Coordinate multi-step workflows involving multiple agents, commands, and validation points. Use when managing complex development workflows that require coordination between different specialized agents.

Workflow Orchestration

This skill provides patterns for orchestrating complex workflows with multiple agents and validation points.

Workflow Patterns

Sequential Workflow

For workflows where each step depends on the previous one:

1. Initial Analysis → 2. Planning → 3. Implementation → 4. Validation

When to use: Linear dependencies, each step builds on previous results

Parallel Workflow

For independent tasks that can run concurrently:

        ┌→ Task A ┐
Start → ├→ Task B ├→ Merge → Continue
        └→ Task C ┘

When to use: Independent components, can be developed/tested separately

Iterative Workflow

For workflows requiring refinement:

Plan → Implement → Review → [Refine Plan] → Loop until criteria met

When to use: Exploratory tasks, requirements evolve during execution

Agent Coordination

Handoff Pattern

Clear transitions between specialized agents:

1. github-issue-analyzer: Extract requirements
2. prp-generator: Create structured plan
3. executor: Implement solution
4. Code review (external): Validate quality

Handoff checklist:

• Previous agent completed all deliverables
• Next agent has required context
• Success criteria clearly defined

Delegation Pattern

Main orchestrator delegates to specialists:

Orchestrator
    ├→ Technical research → Report findings
    ├→ Implementation → Deliver code
    └→ Documentation → Update docs

Delegation checklist:

• Clear scope and boundaries for each agent
• Expected outputs defined
• Time/resource constraints communicated

Progress Tracking

Use structured tracking for visibility:

## Workflow Status

### Phase 1: Analysis ✅
- [x] GitHub issue analyzed
- [x] Requirements extracted
- [x] PRP generated

### Phase 2: Implementation 🔄
- [x] Core functionality implemented
- [ ] Edge cases handled
- [ ] Tests written

### Phase 3: Validation ⏸️
- [ ] Code review
- [ ] Integration tests
- [ ] Documentation updated

Symbols: ✅ Complete | 🔄 In Progress | ⏸️ Blocked | ❌ Failed

Error Handling

Define fallback strategies:

## Contingency Plans

### If implementation fails:
1. Rollback to previous stable state
2. Analyze failure root cause
3. Adjust plan based on learnings
4. Retry with updated approach

### If validation fails:
1. Document specific failures
2. Create targeted fixes
3. Re-run validation subset
4. Escalate if pattern of failures

Workflow Templates

Bug Fix Workflow

1. Issue Analysis → Reproduce bug
2. Root Cause → Identify problem
3. Fix Design → Plan solution
4. Implementation → Apply fix
5. Testing → Verify resolution
6. Regression Check → Ensure no side effects

Feature Development Workflow

1. Requirements → Define scope
2. Design Review → Architecture validation
3. Prototype → Quick proof of concept
4. Implementation → Full feature build
5. Testing → Comprehensive validation
6. Documentation → User-facing docs
7. Deployment → Staged rollout

Integration with Plugin Components

• Orchestrator agent: Uses these patterns for workflow management
• Executor agent: Follows orchestration directives
• Commands: /generate-prp, /execute-prp implement workflow steps