repo-defining-workflowslisted

# Defining Workflows ## Purpose This Skill provides comprehensive guidance for **defining workflows** - multi-agent orchestrations that coordinate multiple agents in sequence, parallel, or conditionally to accomplish complex tasks. Workflows enable reusable, validated processes. **When to use this Skill:** - Creating new workflow documents - Defining multi-agent coordination patterns - Structuring sequential or parallel agent execution - Writing workflow acceptance criteria - Documenting workflow parameters and inputs ## Workflow Structure ### YAML Frontmatter (Required) ```yaml --- name: workflow-name description: Clear description of workflow purpose and outcomes tags: - workflow-category - domain-area status: active | draft | deprecated agents: - agent-name-1 - agent-name-2 parameters: - name: param-name type: string | number | boolean required: true | false default: value description: Parameter purpose --- ``` **Critical YAML Syntax**: Values containing colons (`:`) must be quoted. ✅ **Good**: ```yaml description: "Workflow name: detailed description here" parameter: "key: value pairs" ``` ❌ **Bad** (breaks YAML parsing): ```yaml description: Workflow name: detailed description ``` ### Workflow Content ````markdown # Workflow Name ## Purpose What this workflow accomplishes and when to use it. ## Agents Involved - **agent-name-1**: Role and responsibility - **agent-name-2**: Role and responsibility ## Input Parameters | Paramet