aiox-core 5.0.3 → 5.0.5

package/pro/squads/squad-creator-pro/data/squad-type-definitions.yaml

@@ -1,578 +0,0 @@
-# Squad Type Definitions v1.1
-# Reference file for squad type detection and validation rules
-# Based on analysis of well-structured squads
-
-version: "1.1.0"
-created: "2026-02-01"
-updated: "2026-02-05"
-
-# Squad types are detected dynamically based on structure
-# Examples below are illustrative - your squads may vary
-
-type_examples:
-  expert:
-    description: "Squad focused on cloning elite minds"
-    characteristics: ["many agents", "voice_dna", "thinking_dna"]
-  pipeline:
-    description: "Squad focused on multi-phase workflows"
-    characteristics: ["sequential phases", "orchestrator", "checkpoints"]
-  hybrid:
-    description: "Mix of expert agents and pipeline workflows"
-    characteristics: ["both patterns combined"]
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# SQUAD TYPES
-# ═══════════════════════════════════════════════════════════════════════════════
-
-squad_types:
-  # ─────────────────────────────────────────────────────────────────────────────
-  # EXPERT SQUAD
-  # ─────────────────────────────────────────────────────────────────────────────
-  expert:
-    description: |
-      Squads with multiple agents representing distinct expert personas.
-      Each agent is a "mind clone" of a real person with documented frameworks.
-      Focus: Knowledge capture, consistent voice, domain expertise.
-
-    # Examples are illustrative - your squads may vary
-    example_structure:
-      # A copywriting expert squad might have:
-      # - 15-25 agents based on renowned copywriters
-      # - Voice DNA for each expert persona
-      # - Tier organization (Chief, Masters, Specialists)
-      typical_agents: "5-25"
-      typical_description: "Domain experts with distinct voice/thinking DNA"
-
-    detection_signals:
-      strong:
-        - "agents_count >= 5"
-        - "agents_based_on_real_people == true"
-        - "multiple_voice_dna_sections == true"
-      moderate:
-        - "tier_organization_present == true"
-        - "orchestrator_is_chief_pattern == true"
-      weak:
-        - "agent_names_are_person_names == true"
-
-    detection_formula: |
-      score = 0
-      if agents_count >= 5: score += 3
-      if agents_based_on_real_people: score += 3
-      if voice_dna_in_50_percent_agents: score += 2
-      if tier_organization: score += 1
-      if orchestrator_chief_pattern: score += 1
-      return score >= 6  # threshold
-
-    required_components:
-      voice_dna:
-        required: true
-        minimum_coverage: "100% of agents"
-        structure:
-          - "sentence_starters (by context)"
-          - "metaphors (with usage)"
-          - "vocabulary.always_use (5+)"
-          - "vocabulary.never_use (3+)"
-
-      objection_algorithms:
-        required: true
-        minimum_coverage: "100% of agents"
-        minimum_count: 3
-        structure:
-          - "objection (trigger)"
-          - "response (domain-specific)"
-
-      output_examples:
-        required: true
-        minimum_coverage: "100% of agents"
-        minimum_count: 3
-        structure:
-          - "input"
-          - "output"
-          - "context (optional)"
-
-      tier_organization:
-        required: true
-        tiers:
-          tier_0: "Diagnosis agents (must exist)"
-          tier_1: "Master agents"
-          tier_2: "Systematizer agents"
-          tier_3: "Specialist agents"
-        orchestrator: "Chief/Orchestrator agent required"
-
-    optional_components:
-      - "frameworks (inline or referenced)"
-      - "swipe_files"
-      - "authority_proof_arsenal"
-      - "signature_phrases"
-
-    benchmarks:
-      agents:
-        minimum: 5
-        good: 10
-        excellent: 20
-      agent_lines:
-        minimum: 300
-        good: 800
-        excellent: 1200
-      agent_task_ratio:
-        minimum: "1:2"
-        good: "1:3"
-        excellent: "1:4"
-      checklist_coverage:
-        minimum: "30%"
-        good: "40%"
-        excellent: "50%"
-
-    veto_conditions:
-      - id: "VE1"
-        condition: "zero_agents_with_voice_dna"
-        message: "Expert squads require voice_dna in agents"
-      - id: "VE2"
-        condition: "no_tier_0_diagnosis"
-        message: "Expert squads require Tier 0 (diagnosis) capability"
-      - id: "VE3"
-        condition: "no_orchestrator"
-        message: "Expert squads require orchestrator/chief agent"
-
-  # ─────────────────────────────────────────────────────────────────────────────
-  # PIPELINE SQUAD
-  # ─────────────────────────────────────────────────────────────────────────────
-  pipeline:
-    description: |
-      Squads with sequential phase execution orchestrated by a central agent.
-      Focus: Multi-step workflows, quality gates, intermediate outputs.
-      Typically one orchestrator with many tasks following a defined pipeline.
-
-    # Examples are illustrative - your squads may vary
-    example_structure:
-      # A content pipeline squad might have:
-      # - 1-3 orchestrator agents
-      # - 7-12 sequential phases
-      # - Intermediate outputs between phases
-      typical_agents: "1-9"
-      typical_phases: "5-12"
-      typical_description: "Multi-phase workflow with quality gates"
-
-    detection_signals:
-      strong:
-        - "has_orchestrator_agent == true"
-        - "has_sequential_phases == true"
-        - "tasks_count > agents_count * 3"
-      moderate:
-        - "workflow_yaml_exists == true"
-        - "intermediate_outputs_defined == true"
-      weak:
-        - "quality_gate_task_exists == true"
-
-    detection_formula: |
-      score = 0
-      if has_orchestrator_agent: score += 3
-      if has_sequential_phases: score += 3
-      if tasks_count > agents_count * 3: score += 2
-      if workflow_yaml_exists: score += 1
-      if intermediate_outputs: score += 1
-      return score >= 6  # threshold
-
-    required_components:
-      workflow_definition:
-        required: true
-        location: "workflow.yaml OR orchestrator agent"
-        structure:
-          phases:
-            - "phase_number"
-            - "phase_name"
-            - "task_reference"
-            - "outputs"
-            - "dependencies (optional)"
-
-      phase_checkpoints:
-        required: true
-        structure:
-          - "human_review (at critical points)"
-          - "quality_gate (before final output)"
-          - "rework_rules (on failure)"
-
-      orchestrator:
-        required: true
-        capabilities:
-          - "phase_status_tracking"
-          - "command_to_task_mapping"
-          - "batch_processing (if applicable)"
-
-      intermediate_outputs:
-        required: true
-        structure:
-          - "each_phase_produces_output"
-          - "output_paths_consistent"
-          - "outputs_inspectable"
-
-      automation_script:
-        required: "conditional"  # Required if phases >= 8
-        condition: "phases_count >= 8"
-        description: |
-          YOLO mode script that can execute the entire pipeline autonomously,
-          without human intervention, while maintaining state and allowing
-          resume on failure.
-        location: "scripts/{squad_name}.sh"
-        reference: "scripts/{squad_name}.sh"
-        required_features:
-          - feature: "input_params"
-            description: "Accepts target/slug as argument"
-            pattern: "$1, ${1:-default}"
-          - feature: "help_docs"
-            description: "--help flag with usage examples"
-            pattern: "--help | -h | show_help"
-          - feature: "state_management"
-            description: "Persists state to JSON/YAML"
-            pattern: "state.json | STATE_FILE"
-          - feature: "progress_tracking"
-            description: "Shows current phase/status"
-            pattern: "echo progress"
-          - feature: "logging"
-            description: "Writes to logs/ directory"
-            pattern: "LOG_FILE | >> *.log"
-          - feature: "resume_capability"
-            description: "Can continue from last checkpoint"
-            pattern: "brownfield | resume | continue"
-          - feature: "error_handling"
-            description: "Handles errors gracefully"
-            pattern: "set -e | trap"
-        optional_features:
-          - "metrics_collection (JSONL format)"
-          - "parallel_execution"
-          - "ab_testing"
-          - "visual_dashboard"
-        minimum_required: 5  # of 7 features
-        scoring:
-          7_of_7: 10
-          6_of_7: 8
-          5_of_7: 7
-          below_5: "FAIL"
-
-    optional_components:
-      - "voice_dna (optional for orchestrators)"
-      - "objection_algorithms (optional)"
-      - "batch_processing"
-      - "auto_correction"
-      - "automation_script (required if phases >= 8)"
-
-    benchmarks:
-      phases:
-        minimum: 3
-        good: 7
-        excellent: 12
-      orchestrator_lines:
-        minimum: 300
-        good: 500
-        excellent: 700
-      task_lines_complex:
-        minimum: 300
-        good: 500
-        excellent: 800
-      agent_task_ratio:
-        minimum: "1:3"
-        good: "1:8"
-        excellent: "1:15"
-      checklist_coverage:
-        minimum: "20%"
-        good: "30%"
-        excellent: "40%"
-
-    veto_conditions:
-      - id: "VP1"
-        condition: "workflow_has_sequence_collisions"
-        message: "Pipeline squads cannot have sequence collisions"
-      - id: "VP2"
-        condition: "phase_outputs_dont_connect"
-        message: "Phase N output must match Phase N+1 input"
-      - id: "VP3"
-        condition: "no_quality_gate_before_final"
-        message: "Pipeline squads require quality gate before final output"
-      - id: "VP4"
-        condition: "orphan_tasks_above_threshold"
-        threshold: 3
-        message: "Too many orphan tasks (not referenced in workflow)"
-
-  # ─────────────────────────────────────────────────────────────────────────────
-  # HYBRID SQUAD
-  # ─────────────────────────────────────────────────────────────────────────────
-  hybrid:
-    description: |
-      Squads focused on process automation with heuristic-based validation.
-      Each agent handles one phase with explicit checkpoints and validation.
-      Focus: Process mapping, executor assignment, compliance, documentation.
-
-    # Examples are illustrative - your squads may vary
-    example_structure:
-      # A hybrid squad might have:
-      # - 3-10 agents with persona profiles
-      # - Heuristic validation at checkpoints
-      # - Process automation focus
-      typical_agents: "3-10"
-      typical_phases: "4-9"
-      typical_description: "Process automation with heuristic validation"
-
-    detection_signals:
-      strong:
-        - "has_process_focus == true"
-        - "has_heuristic_validation == true"
-        - "agents_per_phase ~= 1"
-      moderate:
-        - "persona_profile_in_agents == true"
-        - "behavioral_states_defined == true"
-      weak:
-        - "bpmn_notation_used == true"
-
-    detection_formula: |
-      score = 0
-      if has_process_focus: score += 3
-      if has_heuristic_validation: score += 3
-      if agents_count ~= phases_count: score += 2
-      if persona_profiles: score += 1
-      if behavioral_states: score += 1
-      return score >= 6  # threshold
-
-    required_components:
-      persona_profile:
-        required: true
-        structure:
-          - "archetype"
-          - "communication_style"
-          - "greeting_levels"
-          - "signature_closing"
-
-      behavioral_states:
-        required: true
-        structure:
-          - "operational_modes"
-          - "mode_triggers"
-          - "output_format_per_mode"
-
-      heuristic_validation:
-        required: true
-        structure:
-          - "heuristic_id (e.g., PV_*, SC_*)"
-          - "trigger_condition"
-          - "evaluation_criteria"
-          - "threshold"
-          - "veto_power (boolean)"
-          - "fallback_behavior"
-
-      process_standards:
-        required: true
-        structure:
-          - "task_anatomy_8_fields"
-          - "bpmn_or_equivalent"
-          - "integration_points"
-
-    optional_components:
-      - "voice_dna (replaced by persona_profile)"
-      - "objection_algorithms (replaced by behavioral_states)"
-      - "clickup_integration"
-      - "meta_axiomas"
-
-    benchmarks:
-      agents:
-        minimum: 3
-        good: 7
-        excellent: 10
-      agent_lines:
-        minimum: 200
-        good: 270
-        excellent: 350
-      heuristics:
-        minimum: 1
-        good: 3
-        excellent: 5
-      agent_task_ratio:
-        minimum: "1:1"
-        good: "1:1.3"
-        excellent: "1:1.5"
-      checklist_coverage:
-        minimum: "10%"
-        good: "20%"
-        excellent: "30%"
-
-    veto_conditions:
-      - id: "VH1"
-        condition: "no_heuristic_validation"
-        message: "Hybrid squads require heuristic validation"
-      - id: "VH2"
-        condition: "no_fallback_behavior"
-        message: "Hybrid squads require fallback behavior on heuristic failure"
-      - id: "VH3"
-        condition: "no_task_anatomy"
-        message: "Hybrid squads require Task Anatomy (8 fields)"
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# TYPE DETECTION ALGORITHM
-# ═══════════════════════════════════════════════════════════════════════════════
-
-detection_algorithm:
-  description: |
-    Algorithm to auto-detect squad type based on structural analysis.
-    Returns the type with highest confidence score.
-
-  steps:
-    - step: 1
-      action: "Count agents"
-      weight_if_high: "+expert, +hybrid"
-      weight_if_low: "+pipeline"
-
-    - step: 2
-      action: "Check for voice_dna in agents"
-      weight_if_present: "+expert (strong)"
-      weight_if_absent: "+pipeline, +hybrid"
-
-    - step: 3
-      action: "Check agent-to-task ratio"
-      weight_if_high_tasks: "+pipeline (strong)"
-      weight_if_balanced: "+expert, +hybrid"
-
-    - step: 4
-      action: "Check for heuristic_validation"
-      weight_if_present: "+hybrid (strong)"
-      weight_if_absent: "+expert, +pipeline"
-
-    - step: 5
-      action: "Check for workflow.yaml or sequential phases"
-      weight_if_present: "+pipeline (moderate)"
-      weight_if_absent: "neutral"
-
-    - step: 6
-      action: "Check for persona_profile pattern"
-      weight_if_present: "+hybrid (moderate)"
-      weight_if_absent: "+expert"
-
-  tie_breaker: |
-    If scores are equal:
-    1. Check for real person names in agents → expert
-    2. Check for phase numbering → pipeline
-    3. Check for process/automation keywords → hybrid
-    4. Default to pipeline
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# VALIDATION REQUIREMENTS BY TYPE
-# ═══════════════════════════════════════════════════════════════════════════════
-
-validation_requirements:
-  universal:
-    description: "Requirements for ALL squad types"
-    tier_1_structure:
-      - "config.yaml exists and valid"
-      - "entry_agent defined and exists"
-      - "all referenced files exist"
-      - "required directories present"
-    tier_2_coverage:
-      - "orphan_tasks <= 2"
-      - "data_file_usage >= 50%"
-
-  by_type:
-    expert:
-      tier_3_quality:
-        prompt_quality: "standard"
-        pipeline_coherence: "relaxed"
-        checklist_actionability: "standard"
-        documentation: "standard"
-      tier_4_contextual:
-        - "voice_dna in 100% agents"
-        - "objection_algorithms in 100% agents"
-        - "output_examples (3+) per agent"
-        - "tier_organization present"
-
-    pipeline:
-      tier_3_quality:
-        prompt_quality: "strict"
-        pipeline_coherence: "strict"
-        checklist_actionability: "strict"
-        documentation: "standard"
-      tier_4_contextual:
-        - "workflow_definition present"
-        - "phase_checkpoints at critical points"
-        - "intermediate_outputs defined"
-        - "quality_gate before final"
-
-    hybrid:
-      tier_3_quality:
-        prompt_quality: "standard"
-        pipeline_coherence: "standard"
-        checklist_actionability: "standard"
-        documentation: "standard"
-      tier_4_contextual:
-        - "persona_profile in agents"
-        - "behavioral_states defined"
-        - "heuristic_validation present"
-        - "task_anatomy_8_fields enforced"
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# CROSS-REFERENCE: CHECKLIST SECTIONS BY TYPE
-# ═══════════════════════════════════════════════════════════════════════════════
-
-checklist_sections:
-  expert:
-    required_sections:
-      - "4A.1 Voice DNA"
-      - "4A.2 Objection Algorithms"
-      - "4A.3 Output Examples"
-      - "4A.4 Tier Organization"
-    skip_sections:
-      - "4B Pipeline Squad Validation"
-      - "4C Hybrid Squad Validation"
-
-  pipeline:
-    required_sections:
-      - "4B.1 Workflow Definition"
-      - "4B.2 Phase Checkpoints"
-      - "4B.3 Orchestrator Completeness"
-      - "4B.4 Intermediate Outputs"
-    skip_sections:
-      - "4A Expert Squad Validation"
-      - "4C Hybrid Squad Validation"
-
-  hybrid:
-    required_sections:
-      - "4C.1 Persona Profile"
-      - "4C.2 Behavioral States"
-      - "4C.3 Heuristic Validation"
-      - "4C.4 Process Standards"
-    skip_sections:
-      - "4A Expert Squad Validation"
-      - "4B Pipeline Squad Validation"
-
-# ═══════════════════════════════════════════════════════════════════════════════
-# MIGRATION GUIDANCE
-# ═══════════════════════════════════════════════════════════════════════════════
-
-migration_guidance:
-  from_v2_checklist:
-    description: "How to migrate from v2.0 checklist to v3.0"
-    changes:
-      - change: "voice_dna is now contextual"
-        before: "Required for all agents"
-        after: "Required only for Expert squads"
-        action: "Skip for Pipeline/Hybrid validation"
-
-      - change: "objection_algorithms is now contextual"
-        before: "Required for all agents"
-        after: "Required only for Expert squads"
-        action: "Skip for Pipeline/Hybrid validation"
-
-      - change: "Added prompt quality dimension"
-        before: "Not evaluated"
-        after: "25% of Tier 3 score"
-        action: "Evaluate 3 representative tasks"
-
-      - change: "Added pipeline coherence dimension"
-        before: "Not evaluated"
-        after: "25% of Tier 3 score"
-        action: "Check output→input chain, sequence collisions"
-
-      - change: "Added checklist actionability dimension"
-        before: "Not evaluated"
-        after: "25% of Tier 3 score"
-        action: "Evaluate measurability of checklist items"
-
-      - change: "Coverage ratios added"
-        before: "Just file counts"
-        after: "Checklist:ComplexTask >= 30%, orphan detection"
-        action: "Run coverage checks in Tier 2"