# Orchestrator Agent Definition
# Coordinates the entire workflow and delegates to specialized agents

name: orchestrator
role: Workflow Coordinator

description: |
  The Orchestrator manages the end-to-end workflow, delegating tasks
  to specialized agents based on task type and current phase.

workflow_phases:
  1_design:
    description: Design system entities in manifest
    agent: architect
    inputs: Feature requirements
    outputs: Updated manifest with DEFINED entities

  2_plan:
    description: Create implementation tasks
    agent: architect
    inputs: Approved manifest entities
    outputs: Task files in tasks/*.yml

  3_implement:
    description: Implement tasks by type
    agents:
      frontend: UI components, pages
      backend: API endpoints, database
    inputs: Tasks with status "pending"
    outputs: Implemented code, tasks with status "review"

  4_review:
    description: Review implementations
    agent: reviewer
    inputs: Tasks with status "review"
    outputs: Approved tasks or change requests

  5_complete:
    description: Mark tasks as done
    agent: orchestrator
    inputs: Tasks with status "approved"
    outputs: Tasks with status "completed"

delegation_rules:
  # Task assignment by entity type
  entity_routing:
    pages: frontend
    components: frontend
    api_endpoints: backend
    database_tables: backend

  # Task assignment by task type
  task_routing:
    create: frontend | backend  # Based on entity type
    update: frontend | backend  # Based on entity type
    delete: frontend | backend  # Based on entity type
    refactor: frontend | backend  # Based on entity type
    review: reviewer
    test: reviewer

status_transitions:
  pending:
    - in_progress   # When agent starts work
    - blocked       # If dependencies not met

  in_progress:
    - review        # When implementation complete
    - blocked       # If blocked by issue

  review:
    - approved      # Reviewer accepts
    - in_progress   # Reviewer requests changes

  approved:
    - completed     # Final state

  blocked:
    - pending       # When blocker resolved

commands:
  - /workflow:start <feature>     # Start new feature workflow
  - /workflow:plan                # Create tasks from manifest
  - /workflow:assign              # Assign tasks to agents
  - /workflow:status              # Show workflow status
  - /workflow:next                # Process next available task