sf-agent-framework/sf-core/config/workflow-tracks.yaml

AI Agent Orchestration Framework for Salesforce Development - Two-phase architecture with 70% context reduction

# Workflow Tracks Configuration
# Defines the three workflow tracks: Quick, Balanced, Enterprise
# Version: 1.0.0
# Last Updated: 2025-11-25

version: 1.0.0
framework: sf-agent-framework
feature: workflow-tracks

# ═══════════════════════════════════════════════════════════════════════════════
# WORKFLOW TRACK DEFINITIONS
# ═══════════════════════════════════════════════════════════════════════════════

tracks:
  # ─────────────────────────────────────────────────────────────────────────────
  # QUICK FLOW - For simple changes and bug fixes
  # ─────────────────────────────────────────────────────────────────────────────
  quick:
    name: "⚡ Quick Flow"
    description: "Streamlined workflow for bug fixes and small changes"
    estimated_time: "5-10 minutes"
    complexity_range: "0-30"

    characteristics:
      - minimal-overhead
      - fast-execution
      - implementation-focused
      - single-agent-capable

    phases:
      - implementation

    agents:
      required:
        - sf-developer-lean
      optional:
        - sf-qa-lean
        - sf-devops-lead-lean

    outputs:
      - source-code
      - unit-tests
      - deployment-notes.md

    best_for:
      - "Bug fixes"
      - "Hot fixes"
      - "Small enhancements"
      - "Configuration changes"
      - "Quick patches"

    not_suitable_for:
      - "New features"
      - "Architecture changes"
      - "Integration projects"
      - "Compliance-driven work"

    workflow_steps:
      1_analyze_and_fix:
        agent: sf-developer-lean
        duration: "3-5 min"
        actions:
          - analyze-issue
          - implement-fix
          - write-tests

      2_quick_validation:
        agent: sf-qa-lean
        duration: "2-3 min"
        optional: true
        actions:
          - run-tests
          - validate-fix

      3_deploy:
        agent: sf-devops-lead-lean
        duration: "1-2 min"
        actions:
          - deploy-fix
          - verify-deployment

    success_criteria:
      - issue-resolved
      - tests-passing
      - deployed-successfully

  # ─────────────────────────────────────────────────────────────────────────────
  # BALANCED FLOW - For standard features and projects
  # ─────────────────────────────────────────────────────────────────────────────
  balanced:
    name: "📋 Balanced Flow"
    description: "Comprehensive yet efficient workflow for standard development"
    estimated_time: "15-30 minutes"
    complexity_range: "30-70"

    characteristics:
      - comprehensive-planning
      - architecture-design
      - quality-focused
      - deployment-ready

    phases:
      - planning
      - implementation
      - validation

    agents:
      required:
        - sf-business-analyst
        - sf-architect
        - sf-developer-lean
        - sf-qa-lean
      optional:
        - sf-devops-lead-lean
        - sf-technical-architect
        - sf-ux-expert

    outputs:
      - requirements.md
      - architecture.md
      - source-code
      - test-classes
      - test-results.md
      - deployment-plan.md

    best_for:
      - "New features"
      - "Standard projects"
      - "UI enhancements"
      - "Integration work"
      - "Most common scenarios"

    not_suitable_for:
      - "Simple bug fixes"
      - "Emergency hotfixes"

    workflow_steps:
      1_requirements:
        agent: sf-business-analyst
        duration: "5-8 min"
        actions:
          - gather-requirements
          - document-user-stories
          - define-acceptance-criteria

      2_architecture:
        agent: sf-architect
        duration: "5-10 min"
        dependencies:
          - requirements
        actions:
          - design-solution
          - document-architecture
          - identify-patterns
          - create-implementation-stories

      3_implementation:
        agent: sf-developer-lean
        duration: "10-15 min"
        dependencies:
          - architecture
        actions:
          - implement-code
          - write-tests
          - document-changes

      4_testing:
        agent: sf-qa-lean
        duration: "5-8 min"
        dependencies:
          - implementation
        actions:
          - execute-test-plan
          - validate-requirements
          - report-results

      5_deployment:
        agent: sf-devops-lead-lean
        duration: "3-5 min"
        dependencies:
          - testing
        actions:
          - prepare-deployment
          - deploy-changes
          - verify-deployment

    handoffs:
      - from: sf-business-analyst
        to: sf-architect
        artifacts:
          - requirements.md
          - user-stories.md

      - from: sf-architect
        to: sf-developer-lean
        artifacts:
          - architecture.md
          - technical-design.md
          - implementation-stories.md

      - from: sf-developer-lean
        to: sf-qa-lean
        artifacts:
          - source-code
          - test-instructions.md

      - from: sf-qa-lean
        to: sf-devops-lead-lean
        artifacts:
          - test-results.md
          - deployment-checklist.md

    success_criteria:
      - requirements-documented
      - architecture-approved
      - code-implemented
      - tests-passing
      - deployed-successfully

  # ─────────────────────────────────────────────────────────────────────────────
  # ENTERPRISE FLOW - For complex, compliance-driven projects
  # ─────────────────────────────────────────────────────────────────────────────
  enterprise:
    name: "🏢 Enterprise Flow"
    description: "Comprehensive workflow with full governance and compliance"
    estimated_time: "30-60 minutes"
    complexity_range: "70-100"

    characteristics:
      - complete-analysis
      - full-architecture-review
      - security-compliance
      - data-architecture
      - comprehensive-testing
      - release-management

    phases:
      - analysis
      - planning
      - solutioning
      - implementation
      - deployment

    agents:
      required:
        - sf-product-manager
        - sf-business-analyst
        - sf-architect
        - sf-technical-architect
        - sf-data-architect
        - sf-security-architect
        - sf-developer-lean
        - sf-qa-lean
        - sf-devops-lead-lean
        - sf-release-manager
      optional:
        - sf-integration-architect
        - sf-ux-expert
        - sf-data-migration-specialist
        - sf-platform-owner
        - sf-coe-director

    outputs:
      - product-strategy.md
      - business-requirements.md
      - architecture-document.md
      - technical-design.md
      - data-architecture.md
      - security-design.md
      - integration-architecture.md
      - source-code
      - test-plans.md
      - test-results.md
      - deployment-plan.md
      - release-notes.md
      - compliance-report.md

    best_for:
      - "Enterprise initiatives"
      - "Complex integrations"
      - "Compliance-driven projects"
      - "Multi-org deployments"
      - "Mission-critical systems"
      - "Major org transformations"
      - "Package development"

    not_suitable_for:
      - "Simple changes"
      - "Quick bug fixes"
      - "Minor enhancements"

    workflow_steps:
      1_analysis:
        duration: "10-15 min"
        agents:
          lead: sf-product-manager
          supporting:
            - sf-business-analyst
        actions:
          - market-research
          - feasibility-study
          - stakeholder-analysis
          - high-level-requirements

      2_planning:
        duration: "15-20 min"
        agents:
          lead: sf-business-analyst
          supporting:
            - sf-product-manager
            - sf-architect
        dependencies:
          - analysis
        actions:
          - detailed-requirements
          - user-stories
          - acceptance-criteria
          - initial-architecture

      3_solutioning:
        duration: "20-30 min"
        agents:
          lead: sf-architect
          supporting:
            - sf-technical-architect
            - sf-data-architect
            - sf-security-architect
            - sf-integration-architect
        dependencies:
          - planning
        actions:
          - solution-architecture
          - technical-design
          - data-architecture
          - security-architecture
          - integration-design
          - architecture-review

      4_implementation:
        duration: "20-30 min"
        agents:
          lead: sf-developer-lean
          supporting:
            - sf-admin-lean
        dependencies:
          - solutioning
        actions:
          - code-implementation
          - configuration
          - unit-testing
          - integration-development

      5_testing:
        duration: "15-20 min"
        agents:
          lead: sf-qa-lean
          supporting:
            - sf-data-validation-engineer
        dependencies:
          - implementation
        actions:
          - comprehensive-testing
          - integration-testing
          - performance-testing
          - security-testing
          - compliance-validation

      6_deployment:
        duration: "10-15 min"
        agents:
          lead: sf-release-manager
          supporting:
            - sf-devops-lead-lean
        dependencies:
          - testing
        actions:
          - release-planning
          - deployment-orchestration
          - go-live-management
          - post-deployment-validation
          - documentation

    approval_gates:
      architecture_approval:
        phase: solutioning
        required_approvers:
          - sf-architect
          - sf-technical-architect
          - sf-security-architect
        artifacts:
          - architecture-document.md
          - technical-design.md
          - security-design.md

      deployment_approval:
        phase: deployment
        required_approvers:
          - sf-release-manager
          - sf-platform-owner
        artifacts:
          - test-results.md
          - deployment-plan.md
          - rollback-plan.md

    success_criteria:
      - stakeholders-aligned
      - requirements-documented
      - architecture-approved
      - security-reviewed
      - code-implemented
      - comprehensive-testing-complete
      - compliance-validated
      - deployment-approved
      - successfully-deployed
      - documented-and-trained

# ═══════════════════════════════════════════════════════════════════════════════
# TRACK SELECTION CRITERIA
# ═══════════════════════════════════════════════════════════════════════════════

selection_criteria:
  complexity_scoring:
    project_type:
      bug-fix: 10
      small-enhancement: 20
      new-feature: 40
      new-application: 60
      org-migration: 80
      integration: 70
      enterprise-initiative: 90

    org_complexity:
      simple: 0
      medium: 10
      complex: 20
      enterprise: 25

    team_size:
      solo: 0
      small: 5
      medium: 10
      large: 15

    special_requirements:
      compliance: 5
      security: 4
      complex-integrations: 5
      data-migration: 4
      performance: 3
      multi-org: 5
      package-dev: 4

    timeline:
      urgent: 0
      standard: 3
      extended: 6
      long-term: 10

  track_mapping:
    quick:
      score_range: "0-29"
      typical_scenarios:
        - "Hotfix for production issue"
        - "Small configuration change"
        - "Quick UI fix"
        - "Minor code adjustment"

    balanced:
      score_range: "30-69"
      typical_scenarios:
        - "New feature development"
        - "UI enhancement with backend"
        - "Standard integration"
        - "Report/dashboard creation"
        - "Workflow automation"

    enterprise:
      score_range: "70-100"
      typical_scenarios:
        - "Multi-system integration"
        - "Compliance-driven project"
        - "Org-wide transformation"
        - "Package development"
        - "Mission-critical system"
        - "Multi-cloud implementation"

# ═══════════════════════════════════════════════════════════════════════════════
# TRACK TRANSITIONS
# ═══════════════════════════════════════════════════════════════════════════════

track_transitions:
  quick_to_balanced:
    triggers:
      - scope-increase
      - complexity-discovery
      - additional-requirements
    process:
      - pause-quick-workflow
      - capture-current-work
      - initialize-balanced-workflow
      - transfer-artifacts
      - resume-from-planning

  balanced_to_enterprise:
    triggers:
      - compliance-requirements-discovered
      - security-concerns
      - multi-org-scope
      - integration-complexity
    process:
      - pause-balanced-workflow
      - elevate-to-analysis-phase
      - engage-enterprise-agents
      - comprehensive-review
      - resume-from-solutioning

  enterprise_to_balanced:
    triggers:
      - scope-reduction
      - simplified-requirements
    process:
      - complete-current-phase
      - streamline-remaining-phases
      - reduce-agent-involvement
      - continue-with-balanced-track

# ═══════════════════════════════════════════════════════════════════════════════
# METRICS & MONITORING
# ═══════════════════════════════════════════════════════════════════════════════

metrics:
  track_performance:
    quick:
      target_duration: "5-10 min"
      success_rate_target: "95%"
      first_pass_accuracy: "90%"

    balanced:
      target_duration: "15-30 min"
      success_rate_target: "92%"
      first_pass_accuracy: "88%"

    enterprise:
      target_duration: "30-60 min"
      success_rate_target: "90%"
      first_pass_accuracy: "92%"

  quality_metrics:
    - requirements-completeness
    - architecture-quality
    - code-quality
    - test-coverage
    - deployment-success-rate
    - post-deployment-issues

# ═══════════════════════════════════════════════════════════════════════════════
# CUSTOMIZATION
# ═══════════════════════════════════════════════════════════════════════════════

customization:
  allow_track_modification: true
  allow_custom_tracks: true
  custom_track_location: .sf-agent/workflow-overrides/

  override_options:
    - modify-agents
    - adjust-phases
    - change-durations
    - add-approval-gates
    - customize-outputs