aiox-core 5.0.5 → 5.0.7

package/pro/squads/squad-creator/workflows/wf-create-squad.yaml

@@ -0,0 +1,1916 @@
+workflow:
+  id: wf-create-squad
+  name: Create Complete Squad
+  version: "3.2"
+  purpose: Orchestrate the complete creation of an AIOX squad from research to operational validation
+  description: Legacy phase-based orchestration for complete squad creation. Workspace integration ownership stays with COO/c-level.
+  type: orchestration
+  state_machine:
+    states:
+      - init
+      - discovery
+      - deep_tool_discovery
+      - research
+      - architecture
+      - creation
+      - integration
+      - publish
+      - validation
+      - operational_test
+      - complete
+      - failed
+    transitions:
+      - trigger: start
+        source: init
+        dest: discovery
+      - trigger: discovery_complete
+        source: discovery
+        dest: deep_tool_discovery
+      - trigger: discovery_failed
+        source: discovery
+        dest: failed
+      - trigger: deep_tool_discovery_complete
+        source: deep_tool_discovery
+        dest: research
+      - trigger: deep_tool_discovery_failed
+        source: deep_tool_discovery
+        dest: failed
+      - trigger: research_complete
+        source: research
+        dest: architecture
+      - trigger: research_failed
+        source: research
+        dest: failed
+      - trigger: architecture_complete
+        source: architecture
+        dest: creation
+      - trigger: architecture_failed
+        source: architecture
+        dest: failed
+      - trigger: creation_complete
+        source: creation
+        dest: integration
+      - trigger: creation_failed
+        source: creation
+        dest: failed
+      - trigger: integration_complete
+        source: integration
+        dest: publish
+      - trigger: integration_failed
+        source: integration
+        dest: failed
+      - trigger: publish_complete
+        source: publish
+        dest: validation
+      - trigger: publish_failed
+        source: publish
+        dest: failed
+      - trigger: validation_complete
+        source: validation
+        dest: operational_test
+      - trigger: validation_failed
+        source: validation
+        dest: failed
+      - trigger: operational_test_complete
+        source: operational_test
+        dest: complete
+      - trigger: operational_test_failed
+        source: operational_test
+        dest: failed
+      - trigger: fail
+        source: "*"
+        dest: failed
+  sequence:
+    - step: phase-0
+      id: phase-0
+      phase: 1
+      phase_name: DISCOVERY
+      agent: squad-chief
+      task_ref: create-squad-discover
+      action: execute_discovery
+      next: phase-0-5
+    - step: phase-0-5
+      id: phase-0-5
+      phase: 2
+      phase_name: DEEP TOOL DISCOVERY
+      agent: squad-chief
+      task_ref: discover-tools-scan
+      action: execute_deep-tool-discovery
+      outputs:
+        - .aiox/squad-runtime/discovery/{domain}/tool-discovery-report.md
+        - .aiox/squad-runtime/discovery/{domain}/tool-integration-plan.md
+        - .aiox/squad-runtime/discovery/{domain}/capability-tools.yaml
+        - .aiox/squad-runtime/discovery/{domain}/tool-registry.yaml (updated)
+      next: phase-1
+    - step: phase-1
+      id: phase-1
+      phase: 3
+      phase_name: RESEARCH
+      agent: squad-chief
+      task_ref: create-squad-discover
+      action: execute_research
+      next: phase-2
+    - step: phase-2
+      id: phase-2
+      phase: 4
+      phase_name: ARCHITECTURE
+      agent: squad-chief
+      task_ref: create-squad-design
+      action: execute_architecture
+      next: phase-3
+    - step: phase-3
+      id: phase-3
+      phase: 5
+      phase_name: CREATION
+      agent: squad-chief
+      task_ref: create-squad-build
+      action: execute_creation
+      next: phase-4
+    - step: phase-4
+      id: phase-4
+      phase: 6
+      phase_name: INTEGRATION
+      agent: squad-chief
+      task_ref: create-squad-build
+      action: execute_integration
+      next: phase-5
+    - step: phase-5
+      id: phase-5
+      phase: 7
+      phase_name: PUBLISH
+      agent: squad-chief
+      task_ref: create-squad-publish
+      action: execute_publish
+      next: phase-6
+    - step: phase-6
+      id: phase-6
+      phase: 8
+      phase_name: VALIDATION
+      agent: squad-chief
+      task_ref: create-squad-validate
+      action: execute_validation
+      outputs:
+        - squad_path
+        - activation_command
+        - quality_score
+        - governance_compliance
+      next: phase-7
+    - step: phase-7
+      id: phase-7
+      phase: 9
+      phase_name: OPERATIONAL TEST
+      agent: squad-chief
+      task_ref: create-squad-publish
+      action: execute_operational-test
+      outputs:
+        - smoke_test_report
+        - operational_status
+    - workflow_end:
+        id: complete
+        action: workflow_complete
+  quality_gates:
+    - id: SC_DISC_001
+      phase: discovery
+      type: automated
+      placement: exit
+      severity: blocking
+      description: "Discovery gate — ensures domain research is sufficient before architecture"
+      criteria:
+        - field: domain_research
+          operator: "!="
+          value: null
+        - field: squad_type
+          operator: "in"
+          value: [operational, strategic, tactical, hybrid]
+      on_fail: block
+    - id: SC_ARCH_001
+      phase: architecture
+      type: hybrid
+      placement: exit
+      severity: blocking
+      description: "Architecture gate — validates blueprint completeness before creation"
+      criteria:
+        - field: squad_blueprint
+          operator: "!="
+          value: null
+        - field: agent_count
+          operator: ">="
+          value: 1
+      on_fail: block
+    - id: SC_VAL_001
+      phase: validation
+      type: automated
+      placement: exit
+      severity: blocking
+      description: "Validation gate — quality score must meet squad threshold"
+      criteria:
+        - field: quality_score
+          operator: ">="
+          value: 7.0
+        - field: governance_compliance
+          operator: "=="
+          value: true
+      on_fail: block
+    - id: SC_OPS_001
+      phase: operational_test
+      type: automated
+      placement: exit
+      severity: warning
+      description: "Operational test gate — smoke test must pass before completion"
+      criteria:
+        - field: operational_status
+          operator: "=="
+          value: "PASS"
+      on_fail: warn
+  orchestrator: "@squad-chief"
+  mode: yolo
+  squad_type: auto
+  governance_protocol: squads/squad-creator/protocols/ai-first-governance.md
+  ci_policy:
+    blocking_deterministic_only: true
+    semantic_checks_in_checkpoints: true
+routing:
+  preflight_task: detect-squad-context
+  routes:
+    greenfield_or_resume: wf-context-aware-create-squad
+    brownfield_upgrade: wf-brownfield-upgrade-squad
+  note: Use detect-squad-context before starting this legacy orchestration path.
+specialists:
+  mind_cloning:
+    agent: "@oalanicolas"
+    role: Mind Cloning Architect
+    invoke_in_phases:
+      - phase_3
+    responsibilities:
+      - Curadoria de fontes (ouro vs bronze)
+      - Extração de Voice DNA + Thinking DNA
+      - Validação de fidelidade (85-97%)
+      - Playbook + Framework + Swipe File trinity
+  process_design:
+    agent: "@pedro-valerio"
+    role: Process Absolutist
+    invoke_in_phases:
+      - phase_5
+    responsibilities:
+      - Validar se workflows impedem caminhos errados
+      - Criar veto conditions em quality gates
+      - Auditar checkpoints para gaps de tempo
+      - Garantir fluxo unidirecional
+yolo_mode:
+  philosophy: |
+    "Run autonomously until you hit a wall.
+     Only stop when data is genuinely missing.
+     Warn about quality trade-offs, but don't block."
+  auto_proceed_when:
+    - 10+ fontes web encontradas por mind
+    - Triangulação possível (3+ fontes por claim principal)
+    - Quality gates passam automaticamente
+    - Usuário escolheu YOLO mode no pre-flight
+  must_stop_when:
+    - < 5 fontes encontradas para um mind (muito obscuro)
+    - Usuário disse que tem materiais mas não forneceu path
+    - Quality gate CRÍTICO falha sem recovery possível
+    - Usuário marcou que conhece expert (DNA validation obrigatória)
+  quality_warning: |
+    ═══════════════════════════════════════════════════════════════════
+    ⚠️ AVISO DE QUALIDADE - YOLO MODE
+    ═══════════════════════════════════════════════════════════════════
+
+    COM materiais próprios (livros, PDFs, cursos):
+    ┌─────────────────────────────────────────────────────────────────┐
+    │ • Fidelidade: 85-95%                                            │
+    │ • Frameworks: Completos                                         │
+    │ • Voice DNA: Preciso (de fontes originais)                      │
+    │ • Contradições: Capturadas (aparecem em long-form)              │
+    └─────────────────────────────────────────────────────────────────┘
+
+    APENAS com pesquisa web:
+    ┌─────────────────────────────────────────────────────────────────┐
+    │ • Fidelidade: 60-75%                                            │
+    │ • Frameworks: Parciais (só o que é público)                     │
+    │ • Voice DNA: Aproximado                                         │
+    │ • Contradições: Podem faltar (não aparecem em highlights)       │
+    └─────────────────────────────────────────────────────────────────┘
+
+    "Materiais próprios = CLONE. Web only = APROXIMAÇÃO."
+    ═══════════════════════════════════════════════════════════════════
+pre_flight:
+  trigger: Início do workflow (ANTES de tudo)
+  blocking: true
+  purpose: Informar usuário sobre o que vai precisar e escolher modo
+  message: |
+    ═══════════════════════════════════════════════════════════════════
+    📋 PRE-FLIGHT: CRIAÇÃO DE SQUAD
+    ═══════════════════════════════════════════════════════════════════
+
+    Vou criar um squad de {domain}.
+
+    PARA MÁXIMA QUALIDADE, idealmente você teria:
+    ┌─────────────────────────────────────────────────────────────────┐
+    │ 📚 POR CADA EXPERT:                                             │
+    │ • 2-3 livros principais (PDF ou referência)                     │
+    │ • 5-10 entrevistas/podcasts (links ou transcrições)             │
+    │ • Artigos/newsletters escritos pelo expert                      │
+    │ • Cursos/workshops (se tiver acesso)                            │
+    └─────────────────────────────────────────────────────────────────┘
+
+    ⏱️ TEMPO ESTIMADO:
+    • Com materiais: 4-5 horas
+    • Só web: 6-8 horas (mais pesquisa, menos qualidade)
+
+    ═══════════════════════════════════════════════════════════════════
+  questions:
+    - id: execution_mode
+      question: Como você quer executar?
+      required: true
+      options:
+        - id: yolo
+          label: 🚀 YOLO MODE - Não tenho materiais
+          description: Rodo automaticamente com pesquisa web. Paro só se algo crítico faltar.
+          quality: 60-75%
+          interaction: Mínima (só aprovação final)
+        - id: quality
+          label: 💎 QUALITY MODE - Tenho materiais para fornecer
+          description: Você fornece materiais. Valido DNA extraído com você.
+          quality: 85-95%
+          interaction: Moderada (coleta + validação)
+        - id: hybrid
+          label: 🔀 HYBRID MODE - Tenho materiais de alguns
+          description: "Mix: alguns experts com materiais, outros com web."
+          quality: Variável por expert
+          interaction: Por expert
+    - id: expert_knowledge
+      question: Você conhece PROFUNDAMENTE algum expert do domínio?
+      description: Se sim, vou pedir para validar o DNA extraído
+      required: true
+      options:
+        - id: "yes"
+          label: Sim - Posso validar
+          action: CP3 (DNA Validation) será OBRIGATÓRIO
+        - id: "no"
+          label: Não - Confio na extração
+          action: CP3 será AUTOMÁTICO
+    - id: time_commitment
+      question: Quanto tempo você tem para interações?
+      required: true
+      options:
+        - id: minimal
+          label: Mínimo - Só me chame se for CRÍTICO
+          checkpoints:
+            - CP6 only
+        - id: moderate
+          label: Moderado - Checkpoints principais
+          checkpoints:
+            - CP1
+            - CP3
+            - CP6
+        - id: high
+          label: Alto - Validar cada etapa
+          checkpoints:
+            - ALL
+    - id: output_type
+      question: O squad deve EXECUTAR ações ou apenas RECOMENDAR?
+      required: true
+      description: |
+        EXECUTAR = Squad faz coisas automaticamente (cria forms, pausa campanhas, envia notificações)
+        RECOMENDAR = Squad gera análises, estratégias, relatórios (você implementa manualmente)
+      options:
+        - id: operational
+          label: 🚀 EXECUTAR - Squad com autonomia
+          description: Squad conecta com APIs externas e executa ações reais
+          examples:
+            - Criar forms no Typeform
+            - Pausar campanhas ruins
+            - Enviar alertas no Slack
+          requires: API connections setup
+        - id: textual
+          label: 📝 RECOMENDAR - Squad consultivo
+          description: Squad gera análises e recomendações que você implementa
+          examples:
+            - Relatórios de performance
+            - Estratégias de campanha
+            - Análises competitivas
+          requires: Standard documentation only
+        - id: auto
+          label: 🔄 DETECTAR AUTOMATICAMENTE
+          description: Analiso o briefing e detecto se precisa de conexões externas
+          action: Run detect-operational-mode.md
+  decision_matrix:
+    yolo_minimal:
+      checkpoints_active:
+        - CP6
+      auto_proceed: true
+      stops_for:
+        - Critical failures only
+    yolo_moderate:
+      checkpoints_active:
+        - CP1
+        - CP6
+      auto_proceed: true
+      stops_for:
+        - Mind selection
+        - Final approval
+    quality_any:
+      checkpoints_active:
+        - CP_MATERIALS
+        - CP1
+        - CP3
+        - CP4
+        - CP6
+      auto_proceed: false
+      stops_for:
+        - Materials collection
+        - DNA validation
+    hybrid_any:
+      checkpoints_active:
+        - CP_MATERIALS per mind
+        - CP3 for known experts
+        - CP6
+      auto_proceed: per mind based on materials
+    operational_any:
+      checkpoints_active:
+        - CP6
+        - CP7
+        - CP8
+      additional_phases:
+        - phase_7
+        - phase_8
+        - phase_9
+      requires:
+        - API connection setup (setup-runtime)
+        - E2E operational test
+        - Auto-heal configuration
+      stops_for:
+        - API connection failures
+        - Operational test failures
+    textual_any:
+      checkpoints_active:
+        - CP6
+      skip_phases:
+        - phase_7
+        - phase_8
+        - phase_9
+      note: Standard squad creation without operational infrastructure
+  post_pre_flight: |
+    {quality_warning}
+
+    Modo selecionado: {execution_mode}
+    Checkpoints ativos: {active_checkpoints}
+
+    Posso começar?
+phase_materials:
+  id: phase_materials
+  name: MATERIALS COLLECTION
+  condition: mode == 'quality' OR mode == 'hybrid'
+  trigger: After minds are identified (post Phase 1)
+  blocking: true
+  purpose: |
+    Coletar materiais do usuário ANTES de iniciar extração.
+    Materiais do usuário = Tier 0 (máxima confiança).
+  prompt_template: |
+    ═══════════════════════════════════════════════════════════════════
+    📚 COLETA DE MATERIAIS
+    ═══════════════════════════════════════════════════════════════════
+
+    Identifiquei {minds_count} elite minds para seu squad:
+    {minds_list}
+
+    PARA CADA EXPERT, me diga se você tem materiais:
+
+    {for_each_mind}
+    ┌─────────────────────────────────────────────────────────────────┐
+    │ {mind_name}                                                     │
+    │                                                                 │
+    │ Você tem materiais deste expert?                                │
+    │ □ Sim - Path/links: _______________________________             │
+    │ □ Não - Use pesquisa web                                        │
+    │                                                                 │
+    │ Tipos que você tem:                                             │
+    │ □ Livros (PDF)                                                  │
+    │ □ Transcrições de cursos                                        │
+    │ □ Entrevistas/podcasts                                          │
+    │ □ Artigos/newsletters                                           │
+    │ □ Outros: ______________                                        │
+    └─────────────────────────────────────────────────────────────────┘
+    {end_for_each}
+
+    Quando terminar, me avise para prosseguir.
+    ═══════════════════════════════════════════════════════════════════
+  processing:
+    for_each_response:
+      if_has_materials:
+        - action: Index materials as Tier 0
+        - action: Validate files exist/accessible
+        - action: Add to sources_inventory
+      if_no_materials:
+        - action: Mark mind for web-only research
+        - action: Warn about reduced quality for this mind
+  output:
+    materials_inventory:
+      per_mind:
+        - mind_name: ""
+          has_user_materials: true/false
+          materials_path: ""
+          material_types: []
+          expected_quality: 85-95% | 60-75%
+  quality_standard:
+    agents: 300+ lines, voice_dna, output_examples
+    workflows: 500+ lines, 3+ phases, checkpoints
+    tasks: 500+ lines complex, 300+ simple, Task Anatomy (8 fields)
+    overall_score: ">= 7.0"
+  frameworks_used:
+    - id: tier-system-framework
+      file: data/tier-system-framework.md
+      applied_in:
+        - phase_2
+        - phase_3
+    - id: quality-dimensions-framework
+      file: data/quality-dimensions-framework.md
+      applied_in:
+        - phase_1
+        - phase_5
+    - id: decision-heuristics-framework
+      file: data/decision-heuristics-framework.md
+      applied_in:
+        - phase_0
+        - phase_1
+        - phase_3
+        - phase_5
+    - id: executor-matrix-framework
+      file: data/executor-matrix-framework.md
+      applied_in:
+        - phase_3
+  config_files:
+    - id: heuristics-engine
+      file: config/heuristics.yaml
+      version: "2.0"
+      purpose: "6 heuristics: SC_HE_001-003 (PV) + AN_HE_001-003 (AN) with veto mappings"
+      agents:
+        pedro_valerio:
+          - SC_HE_001
+          - SC_HE_002
+          - SC_HE_003
+        oalanicolas:
+          - AN_HE_001
+          - AN_HE_002
+          - AN_HE_003
+      applied_in:
+        - phase_0
+        - phase_3
+        - phase_5
+    - id: veto-conditions
+      file: config/veto-conditions.yaml
+      version: "2.0"
+      purpose: "15 veto conditions: SC_VC_001-010 (PV) + AN_VC_001-005 (AN)"
+      agents:
+        pedro_valerio:
+          - SC_VC_001
+          - SC_VC_002
+          - SC_VC_003
+          - SC_VC_004
+          - SC_VC_005
+          - SC_VC_006
+          - SC_VC_007
+          - SC_VC_008
+          - SC_VC_009
+          - SC_VC_010
+        oalanicolas:
+          - AN_VC_001
+          - AN_VC_002
+          - AN_VC_003
+          - AN_VC_004
+          - AN_VC_005
+      applied_in:
+        - phase_0
+        - phase_1
+        - phase_3
+        - phase_5
+    - id: axioma-validator
+      file: config/axioma-validator.yaml
+      purpose: 10 axioma dimensions (D1-D10) for quality scoring
+      applied_in:
+        - phase_5
+    - id: quality-gates
+      file: config/quality-gates.yaml
+      purpose: 10 quality gates (QG-SC-1.1 to 6.2) for checkpoints
+      applied_in:
+        - phase_0
+        - phase_1
+        - phase_3
+        - phase_4
+        - phase_5
+    - id: task-anatomy
+      file: config/task-anatomy.yaml
+      purpose: 8 mandatory fields for task validation
+      applied_in:
+        - phase_3
+        - phase_5
+  validation_script: scripts/coherence-validator.py
+  pattern_library: docs/PATTERN-LIBRARY.md
+  estimated_duration:
+    incremental: 60-90 minutes
+    yolo: 30-45 minutes
+inputs:
+  required:
+    - name: domain
+      type: string
+      description: Domain expertise area (e.g., 'copywriting', 'legal', 'data')
+      example: copywriting
+    - name: purpose
+      type: string
+      description: What the squad should accomplish
+      example: Create high-converting sales pages and marketing copy
+    - name: target_user
+      type: string
+      description: Who will use this squad
+      example: Marketing teams at SaaS companies
+    - name: use_cases
+      type: list
+      description: 3-5 key use cases
+      example:
+        - Sales pages
+        - Email sequences
+        - Ad copy
+        - Landing pages
+  optional:
+    - name: mode
+      type: enum
+      values:
+        - incremental
+        - yolo
+      default: incremental
+      description: Workflow execution mode
+    - name: squad_name
+      type: string
+      description: Override default squad name (kebab-case)
+      example: copy
+    - name: existing_research
+      type: path
+      description: Path to existing research if available
+      example: docs/research/copywriting-research.md
+preconditions:
+  system:
+    - squad-chief agent is active
+    - WebSearch tool available for research
+    - Write permissions for squads/ directory
+    - All 4 frameworks loaded and accessible
+  user:
+    - Clear domain understanding
+    - Defined use cases (3-5)
+    - Available for checkpoints (incremental mode)
+phases:
+  - id: phase_0
+    name: DISCOVERY
+    purpose: Validate domain viability and define squad structure
+    duration: 5-10 minutes
+    mode: interactive
+    steps:
+      - id: step_0_0
+        name: Persist Creation Plan (MANDATORY)
+        action: Persist a trackable creation plan BEFORE creating any squad file
+        blocking: true
+        rule: |
+          NON-NEGOTIABLE: Toda criação de squad DEVE persistir um plano
+          rastreável ANTES de criar qualquer arquivo. Jamais confiar
+          apenas na janela de contexto.
+          Formato mínimo: .aiox/squad-runtime/create-squad/{squad_name}/creation-plan.yaml
+          Formato completo: docs/projects/{squad_name}/prd.md
+          O plano DEVE listar TODOS os artefatos com [ ] checklist.
+        workflow:
+          - Map ALL artifacts the squad needs (agents, tasks, workflows, checklists, templates, data, scripts)
+          - Count total artifacts
+          - Persist creation plan with checklist to disk
+          - THEN proceed to scope complexity check
+        veto: "Não pode criar nenhum arquivo do squad sem plano persistido"
+
+      - id: step_0_1
+        name: Scope Complexity Check (PRD Gate)
+        action: Map workflows and check if PRD is required
+        heuristic:
+          id: SC_SCP_001
+          name: Scope Complexity Gate
+          blocking: true
+          reference: data/decision-heuristics-framework.md#10
+        workflow:
+          - Map ALL workflows the squad needs to handle
+          - Count total workflows and artifacts
+          - Estimate agents needed
+          - Check for existing similar squads
+        thresholds:
+          total_artifacts_require_prd: 15
+          workflows_require_prd: 10
+          agents_require_prd: 8
+        decision:
+          if_workflows_gte_10:
+            action: VETO - PRD Required
+            message: |
+              ═══════════════════════════════════════════════════════════════════
+              ❌ ESCOPO GRANDE DEMAIS PARA CRIAÇÃO DIRETA
+              ═══════════════════════════════════════════════════════════════════
+
+              Mapeei {workflows_count} workflows.
+              Threshold para criação direta: < 10 workflows.
+
+              AÇÃO NECESSÁRIA:
+              ┌─────────────────────────────────────────────────────────────────┐
+              │ 1. Criar PRD: docs/projects/{domain}/prd.md                     │
+              │ 2. Dividir em Epics (por Tier ou funcionalidade)                │
+              │ 3. Criar Stories com acceptance criteria                        │
+              │ 4. Implementar por fases                                        │
+              └─────────────────────────────────────────────────────────────────┘
+
+              Benefícios do PRD:
+              • Nenhum workflow esquecido
+              • Roadmap claro de implementação
+              • Validação por Epic
+              • Possibilidade de pausa/retomada
+
+              Quer que eu crie o PRD agora? (Sim/Não)
+              ═══════════════════════════════════════════════════════════════════
+            next_action: Create PRD using templates/squad-prd-tmpl.md
+            reference_files:
+              - data/pm-best-practices.md
+              - templates/squad-prd-tmpl.md
+            story_generation_rules:
+              agent_stories:
+                template: templates/story-create-agent-tmpl.md
+                rule: |
+                  ❌ NUNCA especificar agent YAML inline na story
+                  ✅ SEMPRE referenciar workflow de criação
+                wrong_pattern: |
+                  # Story especifica o agent completo (200+ linhas de YAML)
+                  # Executor apenas copia → Agent genérico/fraco
+                correct_pattern: |
+                  # Story referencia workflow
+                  workflow: "wf-clone-mind.yaml" | "create-agent.md"
+                  inputs: [agent_id, domain, sources_path]
+                  quality_gates: [SC_AGT_001, SC_AGT_002, SC_AGT_003]
+                  # Executor EXECUTA workflow → Agent com profundidade
+                quality_gates_required:
+                  - "SC_AGT_001: Structure (300+ lines)"
+                  - "SC_AGT_002: Content (all levels present)"
+                  - "SC_AGT_003: Depth (frameworks with theory)"
+                  - "SMOKE_TEST: 3/3 behavioral tests"
+                rationale: |
+                  Stories com especificação inline geram agents fracos porque:
+                  1. Pulam pesquisa de fontes
+                  2. Pulam extração de thinking DNA
+                  3. Pulam extração de voice DNA
+                  4. Não passam no depth gate (SC_AGT_003)
+
+                  Referência de qualidade: squads com agents de 1500+ lines com profundidade
+          if_agents_gte_8:
+            action: VETO - Roadmap Required
+            message: Muitos agents ({agents_count}) - precisa roadmap
+          else:
+            action: PROCEED
+            message: Escopo adequado para criação direta
+        output:
+          workflows_mapped: count
+          agents_needed: count
+          prd_required: true|false
+          decision: proceed|prd_required
+      - id: step_0_1
+        name: Validate Domain Viability
+        action: Assess if domain has sufficient documented frameworks
+        depends_on: step_0_0.decision == 'proceed'
+        heuristic:
+          id: SC_DSC_001
+          name: Discovery Complete
+          blocking: true
+        criteria:
+          documented_methodologies: ">= 2"
+          elite_practitioners: ">= 3"
+          validation_possible: true
+        output:
+          viability_score: 0-10
+          recommendation: proceed | limited_scope | abort
+      - id: step_0_2
+        name: Check Existing Squads
+        action: Search for similar squads that might overlap
+        search_paths:
+          - squads/*
+          - .claude/agents/*
+        decision:
+          if_80_percent_overlap: suggest extend existing
+          if_partial_overlap: warn about integration
+          if_no_overlap: proceed
+      - id: step_0_3
+        name: Define squad structure
+        action: Elicit squad metadata
+        elicit:
+          - squad_name: kebab-case identifier
+          - pack_title: Human-readable title
+          - version: 1.0.0
+          - entry_agent: "Primary activation agent id (default: {squad_name}-chief)"
+          - slash_prefix: camelCase
+          - pattern_prefix: 2-letter code
+        output:
+          pack_config: Initial config.yaml content
+    checkpoint:
+      id: CP_PHASE_0
+      name: Discovery Complete
+      blocking: true
+      criteria:
+        - viability_score: ">= 6"
+        - squad_name: defined
+        - no_duplicate: true
+      on_fail:
+        action: Present issues, suggest alternatives
+      approval:
+        incremental: Human approval required
+        yolo: Auto-approve if criteria met
+  - id: phase_0_5
+    name: DEEP TOOL DISCOVERY
+    purpose: Launch parallel sub-agents for deep research of MCPs, APIs, CLIs, Libraries, GitHub projects
+    duration: 15-25 minutes
+    mode: autonomous
+    depends_on:
+      - phase_0
+    philosophy: |
+      "A squad should leverage ALL available tools to deliver maximum value
+      with minimum user intervention."
+
+      This phase launches 5 SPECIALIZED SUB-AGENTS in PARALLEL:
+      1. MCP Discovery Agent - Model Context Protocol servers
+      2. API Discovery Agent - REST/GraphQL services
+      3. CLI Discovery Agent - Command-line tools
+      4. Library Discovery Agent - Python/Node packages
+      5. GitHub Project Discovery Agent - Reusable components
+
+      Each agent performs DEEP SEARCH in its category, then results are
+      synthesized into a decision matrix (Impact vs Effort).
+    execute:
+      workflow: workflows/wf-discover-tools.yaml
+      inputs:
+        domain: "{domain}"
+        use_cases: "{use_cases}"
+        budget_tier: "{from pre_flight or default: low_cost}"
+        search_depth: standard
+    parallel_execution:
+      enabled: true
+      agents:
+        - name: MCP Discovery Agent
+          searches:
+            - modelcontextprotocol/servers
+            - github topics:mcp-server
+            - glama.ai/mcp
+        - name: API Discovery Agent
+          searches:
+            - RapidAPI
+            - PublicAPIs
+            - ProgrammableWeb
+        - name: CLI Discovery Agent
+          searches:
+            - awesome-cli-apps
+            - homebrew
+            - npm cli tools
+        - name: Library Discovery Agent
+          searches:
+            - PyPI
+            - npm
+            - GitHub SDKs
+        - name: GitHub Project Discovery Agent
+          searches:
+            - github topics
+            - github collections
+            - awesome lists
+    synthesis:
+      scoring_dimensions:
+        impact:
+          - capability_coverage: 0.2
+          - automation_potential: 0.15
+          - quality_improvement: 0.15
+          - uniqueness: 0.1
+        effort:
+          - installation_complexity: 0.1
+          - integration_effort: 0.1
+          - maintenance_burden: 0.1
+          - cost: 0.1
+      decision_matrix:
+        quick_wins: impact >= 7 AND effort_score >= 7
+        strategic: impact >= 7 AND effort_score < 7
+        fill_ins: impact < 7 AND effort_score >= 7
+        avoid: impact < 7 AND effort_score < 7
+    outputs:
+      - .aiox/squad-runtime/discovery/{domain}/tool-discovery-report.md
+      - .aiox/squad-runtime/discovery/{domain}/tool-integration-plan.md
+      - .aiox/squad-runtime/discovery/{domain}/capability-tools.yaml
+      - .aiox/squad-runtime/discovery/{domain}/tool-registry.yaml (updated)
+    checkpoint:
+      id: CP_PHASE_0_5
+      name: Deep Tool Discovery Complete
+      blocking: true
+      heuristic: SC_TLD_001
+      criteria:
+        - parallel_agents_executed: ">= 3 of 5"
+        - total_tools_discovered: ">= 10"
+        - decision_matrix_generated: true
+        - integration_plan_created: true
+        - reports_generated: true
+        - capability_mapping_created: true
+        - tool_registry_updated: true
+      veto_conditions:
+        - all_agents_failed: VETO - Retry required
+        - zero_tools_found: VETO - Domain may be too niche, manual research needed
+      output:
+        tools_discovered: count
+        quick_wins: count
+        strategic: count
+        decision_matrix: generated
+        report_path: .aiox/squad-runtime/discovery/{domain}/tool-discovery-report.md
+        integration_plan_path: .aiox/squad-runtime/discovery/{domain}/tool-integration-plan.md
+    yolo_mode_behavior: |
+      In YOLO mode:
+      - Execute all 5 parallel agents
+      - Generate decision matrix automatically
+      - Add quick_wins to squad dependencies
+      - Log summary (skip detailed presentation)
+      - Continue to Phase 1 immediately
+  - id: phase_1
+    name: RESEARCH
+    purpose: Identify elite minds with documented frameworks
+    duration: 15-30 minutes
+    mode: autonomous
+    depends_on:
+      - phase_0
+      - phase_0_5
+    steps:
+      - id: step_1_1
+        name: Execute Mind Research Loop
+        action: Run iterative research workflow
+        execute:
+          workflow: workflows/wf-mind-research-loop.yaml
+          inputs:
+            domain: "{domain}"
+            min_minds: 5
+            max_minds: 10
+            iterations: 3-5
+        output:
+          minds_list: Curated list of elite minds
+          frameworks_per_mind: Documented frameworks
+          tier_preliminary: Initial tier classification
+      - id: step_1_2
+        name: Validate Research Quality
+        action: Apply quality dimensions to research output
+        framework: quality-dimensions-framework
+        dimensions:
+          - accuracy: Minds are real with verifiable work
+          - coherence: Frameworks complement each other
+          - strategic_alignment: Cover the use cases
+        heuristic:
+          id: SC_RES_001
+          name: Research Quality Gate
+          blocking: true
+          threshold: 7
+          veto_conditions:
+            - minds_count: < 3
+            - no_tier_0: true
+    checkpoint:
+      id: CP_PHASE_1
+      name: Research Complete
+      blocking: true
+      criteria:
+        - minds_found: ">= 5"
+        - all_have_frameworks: true
+        - tier_0_covered: true
+        - use_cases_coverage: ">= 80%"
+      output:
+        minds_table: |
+          | Mind | Tier | Frameworks | Use Cases |
+          |------|------|------------|-----------|
+          | ... | ... | ... | ... |
+    fallback:
+      on_minds_below_5:
+        action: Expand search to adjacent domains
+        retry_with:
+          - Related experts in broader {domain}
+          - Historical figures in {domain}
+          - Practitioners vs theorists mix
+        max_iterations: 2
+      on_no_tier_0:
+        action: Research for diagnostic/analysis experts
+        search_queries:
+          - "\"{domain}\" diagnostic framework\""
+          - "\"{domain}\" assessment methodology\""
+      on_retry_fail: |
+        ESCALATE: Cannot find 5+ elite minds for {domain}.
+        → Present available minds (even if < 5)
+        → Ask user for manual expert suggestions
+        → Proceed with reduced scope if user approves
+  - id: phase_2
+    name: ARCHITECTURE
+    purpose: Design squad structure and relationships
+    duration: 10-20 minutes
+    mode:
+      incremental: interactive
+      yolo: autonomous
+    depends_on:
+      - phase_1
+    steps:
+      - id: step_2_1
+        name: Define Tier Structure
+        action: Assign minds to tiers using tier-system-framework
+        framework: tier-system-framework
+        structure:
+          orchestrator:
+            required: true
+            purpose: Coordinates all tiers, routes requests
+          tier_0:
+            required: true
+            purpose: Diagnosis, analysis, classification
+          tier_1:
+            purpose: Masters with proven results
+          tier_2:
+            purpose: Systematizers, framework creators
+          tier_3:
+            purpose: Format/channel specialists
+          tools:
+            purpose: Validation, checklists, calculators
+      - id: step_2_2
+        name: Plan Agent Relationships
+        action: Define handoffs and synergies
+        define:
+          handoff_map: Who hands off to whom
+          synergies: Agents that work well together
+          conflicts: Agents that shouldn't be combined
+      - id: step_2_3
+        name: Design Quality Gates
+        action: Define validation points between phases
+        template:
+          - id: QG-001
+            transition: Input → Tier 0
+            type: routing
+          - id: QG-002
+            transition: Tier 0 → Tier 1
+            type: blocking
+          - id: QG-003
+            transition: Execution → Output
+            type: blocking
+    checkpoint:
+      id: CP_PHASE_2
+      name: Architecture Approved
+      blocking: true
+      criteria:
+        - tier_0_defined: true
+        - orchestrator_planned: true
+        - quality_gates: ">= 3"
+        - handoff_map: complete
+      approval:
+        incremental: Human review architecture
+        yolo: Auto-approve if criteria met
+  - id: phase_3
+    name: CREATION
+    purpose: Create all squad components
+    duration: 30-60 minutes
+    mode: autonomous
+    depends_on:
+      - phase_2
+    steps:
+      - id: step_3_1
+        name: Create Directory Structure
+        action: Initialize squad directories
+        create:
+          base: squads/{squad_name}/
+          subdirs:
+            - agents/
+            - tasks/
+            - workflows/
+            - templates/
+            - checklists/
+            - data/
+            - docs/
+          files:
+            - config.yaml
+            - README.md
+      - id: step_3_2
+        name: Clone Mind & Create Agents
+        action: Execute full mind cloning pipeline for each mind
+        specialist: "@oalanicolas"
+        specialist_guidance: |
+          Apply DNA Mental™ 8-layer architecture.
+          Curate sources (ouro > bronze).
+          Extract Playbook + Framework + Swipe File trinity.
+          Validate fidelity 85%+ for quality mode.
+        execute:
+          workflow: workflows/wf-clone-mind.yaml
+          for_each: minds_list
+          inputs_per_mind:
+            mind_name: "{mind.name}"
+            domain: "{domain}"
+            user_materials: "{materials_inventory[mind.name]}"
+          sub_phases:
+            - "Phase 0: Source Collection (collect-sources.md)"
+            - "Phase 1: Voice DNA Extraction (extract-voice-dna.md)"
+            - "Phase 2: Thinking DNA Extraction (extract-thinking-dna.md)"
+            - "Phase 3: Synthesis → mind_dna_complete.yaml"
+          final_step:
+            task: create-agent.md
+            input: mind_dna_complete.yaml
+          quality_gate:
+            id: SC_AGT_001
+            blocking: true
+            retry_on_fail: true
+        conditional_checkpoints:
+          yolo_mode:
+            - Auto-proceed unless sources < 5
+          quality_mode:
+            - "CP_SOURCES: Validate sources per mind"
+            - "CP_DNA: Validate DNA if user knows expert"
+          hybrid_mode:
+            - Per-mind based on materials_inventory
+        fallback:
+          on_clone_fail:
+            action: Isolate failed mind, continue with remaining
+            recovery_path:
+              - Log failure reason (sources_insufficient | dna_incomplete | smoke_test_fail)
+              - Create placeholder agent with reduced fidelity warning
+              - Add to remediation_queue for later improvement
+              - Continue squad creation with available agents
+          on_multiple_fails:
+            threshold: "> 50% of minds fail"
+            action: |
+              ESCALATE: Too many agent creation failures.
+              → Present failure analysis
+              → Ask user to provide additional materials
+              → Option: create squad with reduced scope
+          max_retries_per_mind: 2
+      - id: step_3_3
+        name: Create Orchestrator
+        action: Create squad orchestrator agent
+        template: templates/agent-tmpl.md
+        special:
+          tier: orchestrator
+          capabilities:
+            - Route requests to appropriate tier
+            - Manage multi-agent workflows
+            - Track context across handoffs
+      - id: step_3_4
+        name: Create Workflows
+        action: Create multi-phase workflows
+        criteria:
+          - spans_multiple_agents: true
+          - has_checkpoints: true
+        execute:
+          task: tasks/create-workflow.md
+        quality:
+          min_lines: 500
+          min_phases: 3
+      - id: step_3_5
+        name: Create Tasks
+        action: Create atomic tasks with Task Anatomy
+        framework: executor-matrix-framework
+        execute:
+          task: tasks/create-task.md
+        quality:
+          simple: 300+ lines
+          complex: 500+ lines
+          anatomy_fields: 8
+    checkpoint:
+      id: CP_PHASE_3
+      name: Creation Complete
+      blocking: true
+      criteria:
+        - orchestrator_created: true
+        - tier_0_agents: ">= 1"
+        - all_agents_pass_quality: true
+        - workflows_have_checkpoints: true
+      metrics:
+        agents_created: count
+        total_lines: sum
+        quality_scores: average
+  - id: phase_4
+    name: INTEGRATION
+    purpose: Wire components and generate documentation
+    duration: 10-15 minutes
+    mode: autonomous
+    depends_on:
+      - phase_3
+    steps:
+      - id: step_4_1
+        name: Wire Dependencies
+        action: Verify and link all component dependencies
+        for_each_agent:
+          - verify_tasks_exist: true
+          - verify_templates_exist: true
+          - verify_checklists_exist: true
+          - update_dependencies: true
+        create_missing:
+          action: Create stubs with TODO
+      - id: step_4_2
+        name: Create Knowledge Base
+        action: Generate domain knowledge documentation
+        output:
+          file: data/{squad_name}-kb.md
+          sections:
+            - domain_overview
+            - key_concepts
+            - best_practices
+            - common_patterns
+            - anti_patterns
+      - id: step_4_3
+        name: Generate README
+        action: Create comprehensive documentation
+        template: templates/readme-tmpl.md
+        sections:
+          - overview
+          - installation
+          - quick_start
+          - agents_list
+          - workflows_list
+          - tasks_list
+          - usage_examples
+      - id: step_4_4
+        name: Finalize config.yaml
+        action: Complete squad configuration
+        validate:
+          - yaml_syntax: true
+          - all_components_listed: true
+          - entry_agent_defined: true
+          - version_correct: true
+    checkpoint:
+      id: CP_PHASE_4
+      name: Integration Complete
+      blocking: false
+      criteria:
+        - all_dependencies_wired: true
+        - readme_complete: true
+        - config_valid: true
+  - id: phase_5
+    name: VALIDATION
+    purpose: Validate squad meets quality standards
+    duration: 5-10 minutes
+    mode: autonomous
+    depends_on:
+      - phase_4
+    specialist: "@pedro-valerio"
+    specialist_guidance: |
+      Audit all workflows for:
+      - Veto conditions in every checkpoint
+      - Zero caminhos errados possíveis
+      - Fluxo unidirecional (cards nunca voltam)
+      - Zero gaps de tempo em handoffs
+      Apply: "Se executor CONSEGUE fazer errado → processo está errado"
+    steps:
+      - id: step_5_1
+        name: Run Squad Checklist
+        action: Execute comprehensive validation
+        checklist: checklists/squad-checklist.md
+        categories:
+          - structure
+          - agents
+          - workflows
+          - tasks
+          - documentation
+          - integration
+      - id: step_5_2
+        name: Quality Dimensions Scoring
+        action: Score squad against quality dimensions
+        framework: quality-dimensions-framework
+        dimensions:
+          accuracy:
+            weight: 0.2
+            check: Agents based on real minds
+          coherence:
+            weight: 0.2
+            check: Components work together
+          strategic_alignment:
+            weight: 0.15
+            check: Squad serves stated purpose
+          operational_excellence:
+            weight: 0.2
+            check: Squad is usable
+          innovation_capacity:
+            weight: 0.1
+            check: Squad can grow
+          risk_management:
+            weight: 0.15
+            check: Guardrails in place
+        threshold: 7
+        veto_if_below_5:
+          - accuracy
+          - coherence
+          - operational_excellence
+      - id: step_5_3
+        name: Fix Blocking Issues
+        action: Resolve any blocking validation failures
+        for_each_failure:
+          - identify_root_cause: true
+          - determine_fix: true
+          - execute_fix: true
+          - revalidate: true
+        max_iterations: 3
+        on_max_exceeded:
+          action: Report remaining issues to human
+    checkpoint:
+      id: CP_PHASE_5
+      name: Squad Validated
+      blocking: true
+      criteria:
+        - checklist_pass: true
+        - quality_score: ">= 7.0"
+        - no_blocking_issues: true
+      output:
+        final_score: X/10
+        status: PASS | FAIL
+        issues_remaining: count
+  - id: phase_6
+    name: HANDOFF
+    purpose: Present squad and document next steps
+    duration: 2-5 minutes
+    mode: interactive
+    depends_on:
+      - phase_5
+    steps:
+      - id: step_6_0
+        name: Generate Quality Dashboard
+        action: Create comprehensive quality metrics dashboard
+        template: templates/quality-dashboard-tmpl.md
+        output:
+          file: squads/{squad_name}/docs/quality-dashboard.md
+        metrics:
+          per_agent:
+            - sources_count
+            - tier_1_ratio
+            - voice_score
+            - thinking_score
+            - fidelity_estimate
+          squad_level:
+            - coverage_gaps
+            - handoff_clarity
+            - integration_test_status
+          triangulation:
+            - claims_validated
+            - overall_score
+      - id: step_6_1
+        name: Present Squad Summary
+        action: Display final creation summary
+        present:
+          created:
+            - agents: count
+            - workflows: count
+            - tasks: count
+            - templates: count
+            - checklists: count
+          quality:
+            - overall_score: X/10
+            - research_foundation: X elite minds
+            - tier_coverage: Full/Partial
+            - fidelity_estimate: X%
+            - dashboard: squads/{squad_name}/docs/quality-dashboard.md
+          activation:
+            - install: npm run install:squad {squad_name}
+            - activate: "@{squad_name}"
+      - id: step_6_2
+        name: Document Next Steps
+        action: Provide recommendations for squad usage
+        recommendations:
+          immediate:
+            - Test squad with sample request
+            - Activate orchestrator and verify routing
+          optional:
+            - Add more Tier 3 specialists
+            - Create additional templates
+            - Add integration tests
+    output:
+      squad_path: squads/{squad_name}/
+      activation_command: "@{squad_name}"
+      quality_score: X/10
+      agents_created: count
+      status: STRUCTURAL_COMPLETE
+      next_phase: phase_7 if operational_mode else COMPLETE
+  - id: phase_7
+    name: OPERATIONALIZE
+    purpose: Configure API connections for autonomous squad execution
+    duration: 10-20 minutes
+    mode: interactive
+    depends_on:
+      - phase_6
+    condition: operational_mode == true
+    philosophy: |
+      "A squad is not operational until it produces REAL output.
+       Structure is necessary but not sufficient.
+       Connections must be validated with actual API calls."
+    steps:
+      - id: step_7_1
+        name: Detect Operational Requirements
+        action: Analyze skills and outputs for external API dependencies
+        execute:
+          task: tasks/detect-operational-mode.md
+          inputs:
+            briefing: "{original_briefing}"
+            outputs_defined: "{squad_outputs}"
+            skills_detected: "{skills_list}"
+        output:
+          mode_detected: OPERATIONAL|TEXTUAL
+          apis_required:
+            - "{list}"
+          env_vars_needed:
+            - "{list}"
+      - id: step_7_2
+        name: Generate API Requirements
+        condition: mode_detected == OPERATIONAL
+        action: Map required APIs and generate env template
+        output:
+          file: squads/{squad_name}/data/api-requirements.yaml
+          content:
+            required_apis: "{from_detection}"
+            env_vars: "{per_api}"
+            validation_endpoints: "{per_api}"
+      - id: step_7_3
+        name: Run Setup Wizard
+        condition: mode_detected == OPERATIONAL
+        action: Execute interactive setup for API connections
+        execute:
+          task: tasks/setup-runtime.md
+          inputs:
+            squad_name: "{squad_name}"
+            required_apis: "{apis_required}"
+            validation_mode: strict
+        output:
+          connections_configured:
+            - "{list}"
+          runtime_baseline: squads/{squad_name}/data/runtime-baseline.yaml
+      - id: step_7_4
+        name: Generate Operational Tasks
+        condition: mode_detected == OPERATIONAL
+        action: Copy and customize operational task templates
+        create:
+          - source: templates/setup-runtime-task-tmpl.md
+            target: squads/{squad_name}/tasks/setup-runtime.md
+            customize: API requirements from detection
+          - source: templates/operational-test-task-tmpl.md
+            target: squads/{squad_name}/tasks/operational-test.md
+            customize: Test flow based on squad domain
+          - source: templates/auto-heal-task-tmpl.md
+            target: squads/{squad_name}/tasks/auto-heal.md
+            customize: Error patterns for detected APIs
+    checkpoint:
+      id: CP_PHASE_7
+      name: Operationalization Setup Complete
+      blocking: true
+      condition: operational_mode == true
+      criteria:
+        - critical_apis_connected: true
+        - runtime_baseline_created: true
+        - operational_tasks_generated: true
+      on_fail:
+        action: Identify missing API, guide user to configure
+        retry: true
+      output:
+        apis_connected: count
+        apis_skipped: count
+        ready_for_test: true
+  - id: phase_8
+    name: OPERATIONAL TEST
+    purpose: Execute real E2E test to prove squad is operational
+    duration: 5-10 minutes
+    mode: autonomous
+    depends_on:
+      - phase_7
+    condition: operational_mode == true AND runtime_baseline_exists
+    philosophy: |
+      "Squad is only operational after producing REAL output.
+       Structural validation is not enough - we need proof of execution."
+    steps:
+      - id: step_8_1
+        name: Pre-Flight Check
+        action: Verify all connections are valid
+        execute:
+          task: tasks/operational-test-preflight.md
+          inputs:
+            squad_name: "{squad_name}"
+        output:
+          all_connections_valid: true
+          test_target_available: true
+      - id: step_8_2
+        name: Execute Smoke Workflow
+        action: Run minimal E2E workflow with real data
+        execute:
+          task: tasks/operational-test-smoke.md
+          inputs:
+            squad_name: "{squad_name}"
+            test_mode: live
+            test_scope: minimal
+        tests:
+          - t1_fetch: Fetch data from connected API
+          - t2_process: Apply core skill logic (dry run)
+          - t3_output: Generate artifact
+          - t4_notify: Send test notification (if configured)
+        output:
+          tests_passed: "{count}/{total}"
+          artifacts_generated:
+            - "{list}"
+      - id: step_8_3
+        name: Register Operational Baseline
+        action: Save known-good state for future comparison
+        output:
+          file: squads/{squad_name}/data/operational-baseline.yaml
+          content:
+            test_date: "{timestamp}"
+            tests_passed: "{count}"
+            artifacts:
+              - "{list}"
+            status: OPERATIONAL
+    checkpoint:
+      id: CP_PHASE_8
+      name: Operational Test Passed
+      blocking: true
+      condition: operational_mode == true
+      criteria:
+        - tests_passed: ">= 3/4"
+        - real_output_generated: true
+        - operational_baseline_created: true
+      on_fail:
+        action: Diagnose failure, attempt auto-heal, retry
+        max_retries: 2
+        on_max_retries:
+          action: Escalate to user with diagnostic report
+      output:
+        score: "{passed}/{total}"
+        status: OPERATIONAL | PARTIAL | FAILED
+  - id: phase_9
+    name: OPERATIONAL HANDOFF
+    purpose: Present fully operational squad with activation instructions
+    duration: 2-5 minutes
+    mode: interactive
+    depends_on:
+      - phase_8
+    condition: operational_mode == true
+    steps:
+      - id: step_9_1
+        name: Present Operational Summary
+        action: Display comprehensive operational status
+        present: |
+          ═══════════════════════════════════════════════════════════════════════════════
+          ✅ {SQUAD_NAME}: SQUAD TOTALMENTE OPERACIONAL
+          ═══════════════════════════════════════════════════════════════════════════════
+
+          CONEXOES:
+          ┌─────────────────────────────────────────────────────────────────────────────┐
+          {for each api in configured_apis}
+          │ {api.name}       │ {api.status} │ {api.details}                            │
+          {/for}
+          └─────────────────────────────────────────────────────────────────────────────┘
+
+          TESTE OPERACIONAL:
+          ┌─────────────────────────────────────────────────────────────────────────────┐
+          │ Testes executados    │ {tests_passed}/{tests_total}                        │
+          │ Artefatos gerados    │ {artifacts_count}                                   │
+          │ Status               │ OPERACIONAL                                         │
+          └─────────────────────────────────────────────────────────────────────────────┘
+
+          O QUE O SQUAD FAZ AGORA:
+          - {capability_1}
+          - {capability_2}
+          - {capability_3}
+
+          COMANDOS DISPONIVEIS:
+          - *setup-runtime --status    → Ver conexoes
+          - *operational-test          → Re-executar teste E2E
+          - *auto-heal --status        → Ver correcoes automaticas
+
+          ═══════════════════════════════════════════════════════════════════════════════
+          Show! Squad operacional. A melhor coisa e voce impossibilitar caminhos. ⚙️
+          ═══════════════════════════════════════════════════════════════════════════════
+      - id: step_9_2
+        name: Document Operational Commands
+        action: Add operational commands to squad README
+        update:
+          file: squads/{squad_name}/README.md
+          section: "## Operational Commands"
+          content: |
+            ### Runtime Management
+            - `*setup-runtime` - Configure API connections
+            - `*setup-runtime --status` - Check connection status
+            - `*setup-runtime --refresh {api}` - Refresh expired token
+
+            ### Testing & Monitoring
+            - `*operational-test` - Run E2E validation
+            - `*auto-heal --status` - View auto-corrections
+    output:
+      squad_path: squads/{squad_name}/
+      activation_command: "@{squad_name}"
+      quality_score: X/10
+      operational_status: FULLY_OPERATIONAL
+      agents_created: count
+      apis_connected: count
+      status: COMPLETE
+transitions:
+  - from: pre_flight
+    to: phase_0
+    condition: execution_mode_selected
+    description: User selected YOLO/QUALITY/HYBRID mode
+  - from: phase_0
+    to: phase_0_5
+    condition: discovery_complete
+    checkpoint_required: true
+    heuristic: SC_HE_001
+    veto_check: SC_VC_001
+    description: Domain viable, squad structure defined
+  - from: phase_0_5
+    to: phase_1
+    condition: tools_discovered
+    checkpoint_required: true
+    description: Tool discovery complete, decision matrix generated
+  - from: phase_1
+    to: phase_materials
+    condition: minds_identified AND mode != 'yolo'
+    checkpoint_required: true
+    veto_check: SC_VC_002
+    description: Elite minds found, materials collection needed
+  - from: phase_1
+    to: phase_2
+    condition: minds_identified AND mode == 'yolo'
+    checkpoint_required: true
+    description: Elite minds found, skip materials (YOLO mode)
+  - from: phase_materials
+    to: phase_2
+    condition: materials_collected
+    description: User materials indexed
+  - from: phase_2
+    to: phase_3
+    condition: architecture_approved
+    checkpoint_required: true
+    heuristic: SC_HE_002
+    veto_check: SC_VC_005
+    description: Tier structure and handoffs defined
+  - from: phase_3
+    to: phase_3_sources
+    condition: architecture_approved
+    checkpoint_required: true
+    agent: "@oalanicolas"
+    description: Architecture approved, start source curation
+  - from: phase_3_sources
+    to: phase_3_extraction
+    condition: sources_curated AND ouro_ratio >= 0.6
+    checkpoint_required: true
+    agent: "@oalanicolas"
+    heuristic: AN_HE_003
+    veto_check:
+      - AN_VC_001
+      - AN_VC_003
+    description: Sources curated with Pareto ao Cubo, proceed to extraction
+  - from: phase_3_extraction
+    to: phase_3_validation
+    condition: dna_extracted AND trinity_complete
+    checkpoint_required: true
+    agent: "@oalanicolas"
+    heuristic: AN_HE_001
+    veto_check:
+      - AN_VC_002
+      - AN_VC_004
+    description: DNA extracted with trinity complete (Playbook + Framework + Swipe)
+  - from: phase_3_validation
+    to: phase_3_handoff
+    condition: self_validation_passed
+    checkpoint_required: true
+    agent: "@oalanicolas"
+    heuristic: AN_HE_002
+    veto_check: AN_VC_005
+    description: Self-validation passed (15+ citations, 5+ phrases, trinity complete)
+  - from: phase_3_handoff
+    to: phase_3_build
+    condition: insumos_ready
+    checkpoint_required: true
+    handoff_from: "@oalanicolas"
+    handoff_to: "@pedro-valerio"
+    handoff_format: INSUMOS_READY
+    description: Insumos validated, handoff to @pedro-valerio for agent creation
+  - from: phase_3
+    to: phase_4
+    condition: agents_created AND quality_gate_passed
+    checkpoint_required: true
+    veto_check:
+      - SC_VC_003
+      - SC_VC_004
+      - SC_VC_006
+    description: All agents pass SC_AGT_001, smoke tests pass
+  - from: phase_4
+    to: phase_5
+    condition: integration_complete
+    checkpoint_required: false
+    description: Dependencies wired, docs generated, COO workspace handoff prepared when needed
+  - from: phase_5
+    to: phase_6
+    condition: validation_passed AND axioma_score >= 7.0
+    checkpoint_required: true
+    heuristic: SC_HE_003
+    veto_check:
+      - SC_VC_007
+      - SC_VC_008
+      - SC_VC_009
+      - SC_VC_010
+    description: All quality gates pass, no blocking issues
+  - from: phase_6
+    to: phase_7
+    condition: handoff_accepted AND operational_mode == true
+    description: Textual complete, proceed to operationalize
+  - from: phase_6
+    to: complete
+    condition: handoff_accepted AND operational_mode == false
+    description: Textual squad complete (no operational mode)
+  - from: phase_7
+    to: phase_8
+    condition: runtime_setup_complete AND critical_apis_connected
+    checkpoint_required: true
+    description: API connections configured, proceed to operational test
+  - from: phase_8
+    to: phase_9
+    condition: operational_test_passed AND real_output_generated
+    checkpoint_required: true
+    description: E2E test passed, proceed to operational handoff
+  - from: phase_9
+    to: complete
+    condition: operational_handoff_accepted
+    description: Fully operational squad delivered
+outputs:
+  primary:
+    - name: Squad Directory
+      location: squads/{squad_name}/
+      description: Complete squad structure
+    - name: Agents
+      location: squads/{squad_name}/agents/
+      description: All agent definitions
+    - name: Workflows
+      location: squads/{squad_name}/workflows/
+      description: Multi-phase workflows
+    - name: Tasks
+      location: squads/{squad_name}/tasks/
+      description: Atomic tasks
+    - name: Documentation
+      location: squads/{squad_name}/README.md
+      description: Usage documentation
+  secondary:
+    - name: Research Files
+      location: docs/research/{domain}-*.md
+      description: Research documentation
+    - name: Tool Discovery Report
+      location: .aiox/squad-runtime/discovery/{domain}/tool-discovery-report.md
+      description: Comprehensive tool research findings (MCPs, APIs, CLIs, Libraries)
+    - name: Tool Integration Plan
+      location: .aiox/squad-runtime/discovery/{domain}/tool-integration-plan.md
+      description: Prioritized implementation steps for discovered tools
+    - name: Capability-Tools Mapping
+      location: .aiox/squad-runtime/discovery/{domain}/capability-tools.yaml
+      description: Domain capability to tool mapping
+    - name: Session Report
+      location: squads/{squad_name}/docs/creation-report.md
+      description: Creation session documentation
+heuristics:
+  - id: SC_SCP_001
+    name: Scope Complexity Gate (PRD Gate)
+    phase: phase_0
+    blocking: true
+    thresholds:
+      workflows: ">= 10 → PRD required"
+      agents: ">= 8 → PRD required"
+  - id: SC_DSC_001
+    name: Discovery Complete
+    phase: phase_0
+    blocking: true
+  - id: SC_TLD_001
+    name: Deep Tool Discovery Complete
+    phase: phase_0_5
+    blocking: true
+    description: |
+      5 parallel sub-agents executed deep search for MCPs, APIs, CLIs, Libraries, GitHub projects.
+      Tools ranked by RELATIVE TIERS (percentile comparison), not absolute thresholds.
+      Comparative report generated with flags for human attention.
+    criteria:
+      - parallel_agents_executed: ">= 3 of 5"
+      - tools_discovered: ">= 5"
+      - tier_distribution_calculated: true
+      - comparative_report_generated: true
+    notes:
+      - No tool automatically eliminated - all get tiers
+      - Even Tier 4 tools included as they may be best option
+  - id: SC_TLD_002
+    name: Relative Ranking Complete
+    phase: phase_0_5.step_2_3
+    blocking: true
+    description: All tools ranked by percentile within dataset found
+    criteria:
+      - all_tools_have_tiers: true
+      - percentile_calculation_done: true
+    notes:
+      - NO absolute thresholds like 'stars >= 100'
+      - 30 stars can be Tier 1 if best in niche
+  - id: SC_TLD_003
+    name: Attention Flags Identified
+    phase: phase_0_5.step_2_4
+    blocking: false
+    description: Security, maturity, and license flags identified for human review
+    criteria:
+      - flags_checked: true
+    notes:
+      - FLAGS require attention, not automatic elimination
+      - Tool with flag may still be recommended if best available
+  - id: SC_TLD_004
+    name: Cost Comparison Complete
+    phase: phase_0_5.step_2_5
+    blocking: false
+    description: Paid vs OSS compared by tier within same capability
+    criteria:
+      - paid_vs_oss_grouped_by_capability: true
+      - tier_comparison_generated: true
+    notes:
+      - NO fixed ROI thresholds
+      - OSS preferred when same tier as paid
+      - Present analysis for human decision
+  - id: SC_TLD_005
+    name: Decision Matrix Generated
+    phase: phase_0_5.step_2_8
+    blocking: true
+    description: Tools assigned to quadrants based on relative tiers
+    criteria:
+      - quadrants_assigned: true
+      - recommendations_per_gap: true
+    notes:
+      - Quick Win = Tier 1-2 Value + Tier 1-2 Effort
+      - No tool excluded - all get quadrant assignment
+  - id: SC_RES_001
+    name: Research Quality Gate
+    phase: phase_1
+    blocking: true
+  - id: SC_ARC_001
+    name: Architecture Approved
+    phase: phase_2
+    blocking: true
+  - id: SC_AGT_001
+    name: Agent Quality Gate
+    phase: phase_3
+    blocking: true
+  - id: SC_CRT_001
+    name: Creation Quality
+    phase: phase_3
+    blocking: true
+  - id: SC_INT_001
+    name: Integration Complete
+    phase: phase_4
+    blocking: false
+  - id: SC_VAL_001
+    name: Squad Validated
+    phase: phase_5
+    blocking: true
+error_handling:
+  veto_conditions_reference:
+    phase_0_discovery:
+      - SC_VC_001
+    phase_2_architecture:
+      - SC_VC_002
+    phase_3_dna_extraction:
+      - SC_VC_003
+      - SC_VC_004
+    phase_3_agent_creation:
+      - SC_VC_005
+      - SC_VC_006
+    phase_5_validation:
+      - SC_VC_007
+      - SC_VC_008
+      - SC_VC_009
+      - SC_VC_010
+    phase_3_sources:
+      - AN_VC_001
+      - AN_VC_003
+    phase_3_extraction:
+      - AN_VC_002
+      - AN_VC_004
+    phase_3_validation:
+      - AN_VC_005
+  research_fails:
+    - action: Retry with different queries
+    - if_still_fails: Abort with explanation
+    - veto_triggered: SC_VC_001 (Domain Viability)
+  agent_creation_fails:
+    - action: Identify missing research
+    - action: Supplement research
+    - action: Retry creation
+    - if_still_fails: Create simpler agent, note for improvement
+    - veto_triggered: SC_VC_005 (Agent Coherence) or SC_VC_006 (Smoke Test)
+  validation_fails:
+    - action: Log specific failures
+    - action: Attempt automated fix
+    - if_cannot_fix: Report to human for decision
+    - run_coherence_validator: python scripts/coherence-validator.py
+  checkpoint_fails:
+    - blocking_checkpoint:
+        action: Halt and report
+        require: Human intervention or fix
+        check_vetos: config/veto-conditions.yaml
+    - non_blocking_checkpoint:
+        action: Log warning
+        proceed: true
+metrics:
+  track:
+    - duration_per_phase: minutes
+    - agents_created: count
+    - total_lines_generated: sum
+    - quality_scores: per component
+    - checkpoint_passes: count
+    - issues_fixed: count
+    - tools_discovered: count
+    - tools_integrated: count
+    - capability_gaps_filled: count
+  report_at_end: true
+  save_to: squads/{squad_name}/docs/metrics.yaml