aiox-core 5.0.3 → 5.0.5

package/pro/squads/squad-creator-pro/docs/squad-chief-agent-flow.md

@@ -1,981 +0,0 @@
-# Sistema do Agente @squad-chief
-
-> **Versão:** 1.0.0
-> **Criado:** 2026-02-10
-> **Owner:** @squad-chief (Squad Architect)
-> **Status:** Documentação Oficial
-> **Pattern:** SC-DP-001 (Agent Flow Documentation)
-
----
-
-## Índice
-
-1. [Visão Geral](#visão-geral)
-2. [Lista Completa de Arquivos](#lista-completa-de-arquivos)
-3. [Diagramas](#diagramas)
-4. [Mapeamento de Comandos](#mapeamento-de-comandos)
-5. [Integrações entre Agentes](#integrações-entre-agentes)
-6. [Veto Conditions](#veto-conditions)
-7. [Configuração](#configuração)
-8. [Modos de Execução](#modos-de-execução)
-9. [Best Practices](#best-practices)
-10. [Troubleshooting](#troubleshooting)
-11. [Referências](#referências)
-12. [Resumo](#resumo)
-13. [Changelog](#changelog)
-
----
-
-## Visão Geral
-
-O agente **@squad-chief (Squad Architect)** é o **Master Orchestrator** do squad-creator. Este agente atua como **Orchestrator Tier 0** que coordena criação de squads, roteamento para especialistas, e garantia de qualidade.
-
-### Quando Usar
-
-**USE @squad-chief para:**
-- Criar squads completos de qualquer domínio
-- Orquestrar mind cloning de experts reais
-- Validar squads existentes
-- Análise de ecosistema e registry
-- Descoberta de ferramentas (MCPs, APIs, CLIs)
-
-**NÃO USE @squad-chief para:**
-- Extração de Voice/Thinking DNA detalhada → use @oalanicolas
-- Validação de workflows/processos → use @pedro-valerio
-- Deconstructing frameworks específicos → use @tim-ferriss
-
-### Características Principais
-
-| Característica | Descrição |
-|----------------|-----------|
-| **Persona** | Squad Architect |
-| **Arquétipo** | Orchestrator |
-| **Tier** | 0 (Master Coordinator) |
-| **Tom** | Inquisitive, methodical, template-driven, quality-focused |
-| **Foco** | Creating high-quality squads based on elite minds |
-| **Fechamento** | "Clone minds > create bots" |
-
-### Vocabulário Característico
-
-**Sempre usar:**
-- "elite minds - not experts or professionals"
-- "documented framework - not experience or knowledge"
-- "tier - not level or rank"
-- "checkpoint - not review or check"
-- "veto condition - not blocker or issue"
-- "heuristic - not rule or guideline"
-- "quality gate - not validation or test"
-- "research loop - not search or lookup"
-
-**Nunca usar:**
-- "expert" - too generic
-- "best practices" - too vague
-- "simple" - minimizes complexity
-- "just" - minimizes effort
-- "I think" - use "Based on research..."
-- "maybe" - use decisive language
-
----
-
-## Lista Completa de Arquivos
-
-### Arquivos Core de Tasks do @squad-chief
-
-| Arquivo | Comando | Propósito |
-|---------|---------|-----------|
-| `squads/squad-creator-pro/tasks/create-squad.md` | `*create-squad` | Criar squad completo através do workflow guiado |
-| `squads/squad-creator-pro/tasks/create-agent.md` | `*create-agent` | Criar agent individual para squad |
-| `squads/squad-creator-pro/tasks/create-workflow.md` | `*create-workflow` | Criar multi-phase workflow |
-| `squads/squad-creator-pro/tasks/create-task.md` | `*create-task` | Criar atomic task |
-| `squads/squad-creator-pro/tasks/create-template.md` | `*create-template` | Criar output template |
-| `squads/squad-creator-pro/tasks/create-pipeline.md` | `*create-pipeline` | Gerar pipeline code scaffolding |
-| `squads/squad-creator-pro/tasks/validate-squad.md` | `*validate-squad` | Validar squad completo |
-| `squads/squad-creator-pro/tasks/upgrade-squad.md` | `*upgrade-squad` | Upgrade squad to current standards |
-| `squads/squad-creator-pro/tasks/squad-analytics.md` | `*squad-analytics` | Detailed analytics dashboard |
-| `squads/squad-creator-pro/tasks/refresh-registry.md` | `*refresh-registry` | Scan squads/ and update registry |
-| `squads/squad-creator-pro/tasks/discover-tools.md` | `*discover-tools` | Research MCPs, APIs, CLIs for domain |
-| `squads/squad-creator-pro/tasks/optimize.md` | `*optimize` | Optimize squad/task execution |
-
-### Arquivos de Mind Cloning (Delegados para @oalanicolas)
-
-| Arquivo | Comando | Propósito |
-|---------|---------|-----------|
-| `squads/squad-creator-pro/tasks/collect-sources.md` | `*collect-sources` | Source collection & validation |
-| `squads/squad-creator-pro/tasks/auto-acquire-sources.md` | `*auto-acquire-sources` | Auto-fetch YouTube, podcasts, articles |
-| `squads/squad-creator-pro/tasks/extract-voice-dna.md` | `*extract-voice-dna` | Communication/writing style extraction |
-| `squads/squad-creator-pro/tasks/extract-thinking-dna.md` | `*extract-thinking-dna` | Frameworks/heuristics/decisions extraction |
-| `squads/squad-creator-pro/tasks/update-mind.md` | `*update-mind` | Brownfield: update existing mind DNA |
-| `squads/squad-creator-pro/tasks/an-diagnose-clone.md` | - | Diagnosticar problemas em clone |
-| `squads/squad-creator-pro/tasks/an-assess-sources.md` | - | Avaliar qualidade de fontes |
-| `squads/squad-creator-pro/tasks/an-extract-dna.md` | - | Extrair DNA completo |
-| `squads/squad-creator-pro/tasks/an-extract-framework.md` | - | Extrair frameworks específicos |
-| `squads/squad-creator-pro/tasks/an-fidelity-score.md` | - | Calcular fidelity score |
-| `squads/squad-creator-pro/tasks/an-validate-clone.md` | - | Validar clone final |
-| `squads/squad-creator-pro/tasks/an-design-clone.md` | - | Design de clone strategy |
-| `squads/squad-creator-pro/tasks/an-clone-review.md` | - | Review de clone existente |
-
-### Arquivos de Process Validation (Delegados para @pedro-valerio)
-
-| Arquivo | Comando | Propósito |
-|---------|---------|-----------|
-| `squads/squad-creator-pro/tasks/pv-audit.md` | `*audit` | Auditar workflow |
-| `squads/squad-creator-pro/tasks/pv-axioma-assessment.md` | `*axioma-assessment` | Avaliar axiomas de processo |
-| `squads/squad-creator-pro/tasks/pv-modernization-score.md` | `*modernization-score` | Score de modernização |
-
-### Arquivos de Utility Tasks
-
-| Arquivo | Comando | Propósito |
-|---------|---------|-----------|
-| `squads/squad-creator-pro/tasks/deep-research-pre-agent.md` | - | Deep research before agent creation |
-| `squads/squad-creator-pro/tasks/qa-after-creation.md` | - | QA após criação |
-| `squads/squad-creator-pro/tasks/install-commands.md` | `*install` | Instalar comandos no IDE |
-| `squads/squad-creator-pro/tasks/sync-ide-command.md` | `*sync` | Sync squad commands to .claude/commands/ |
-| `squads/squad-creator-pro/tasks/migrate-workflows-to-yaml.md` | - | Migrate MD workflows to YAML |
-| `squads/squad-creator-pro/tasks/squad-fusion.md` | `*fusion` | Merge squads |
-| `squads/squad-creator-pro/tasks/extract-sop.md` | - | Extract SOP from transcript |
-| `squads/squad-creator-pro/tasks/extract-knowledge.md` | - | Extract knowledge from sources |
-| `squads/squad-creator-pro/tasks/create-documentation.md` | `*create-doc` | Criar documentação padronizada |
-| `squads/squad-creator-pro/tasks/deconstruct.md` | `*deconstruct` | Deconstruct existing system |
-| `squads/squad-creator-pro/tasks/find-0.8.md` | `*find-0.8` | Find 80% coverage points |
-| `squads/squad-creator-pro/tasks/validate-extraction.md` | - | Validate extraction quality |
-| `squads/squad-creator-pro/tasks/extract-implicit.md` | - | Extract implicit knowledge |
-
-### Arquivos de Definição do Agente
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/agents/squad-chief.md` | Definição core do agente (1329 linhas) |
-| `.claude/commands/squad-creator/agents/squad-chief.md` | Comando Claude Code para ativar |
-
-### Arquivos de Workflows
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/workflows/wf-create-squad.yaml` | Orquestrar criação completa de squad (6 phases) |
-| `squads/squad-creator-pro/workflows/wf-clone-mind.yaml` | Extrair DNA completo de expert |
-| `squads/squad-creator-pro/workflows/wf-mind-research-loop.yaml` | Pesquisa iterativa com devil's advocate (3-5 iterations) |
-| `squads/squad-creator-pro/workflows/wf-research-then-create-agent.yaml` | Research + agent creation |
-| `squads/squad-creator-pro/workflows/wf-discover-tools.yaml` | Deep parallel tool discovery |
-| `squads/squad-creator-pro/workflows/wf-auto-acquire-sources.yaml` | Auto-acquisition de fontes |
-| `squads/squad-creator-pro/workflows/wf-squad-fusion.yaml` | Merge de squads |
-| `squads/squad-creator-pro/workflows/wf-extraction-pipeline.yaml` | Pipeline de extração |
-| `squads/squad-creator-pro/workflows/validate-squad.yaml` | Validação granular de squad |
-
-### Arquivos de Data/Knowledge
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/data/squad-registry.yaml` | Ecosystem awareness - all squads |
-| `squads/squad-creator-pro/data/tool-registry.yaml` | Global tool catalog (MCPs, APIs, CLIs) |
-| `squads/squad-creator-pro/data/squad-analytics-guide.md` | Guide for *squad-analytics |
-| `squads/squad-creator-pro/data/squad-kb.md` | Knowledge base for squad creation |
-| `squads/squad-creator-pro/data/best-practices.md` | Best practices reference |
-| `squads/squad-creator-pro/data/decision-heuristics-framework.md` | Decision heuristics |
-| `squads/squad-creator-pro/data/quality-dimensions-framework.md` | Quality scoring framework |
-| `squads/squad-creator-pro/data/tier-system-framework.md` | Agent tier organization |
-| `squads/squad-creator-pro/data/executor-matrix-framework.md` | Executor profiles reference |
-| `squads/squad-creator-pro/data/executor-decision-tree.md` | Executor assignment via 6-question elicitation |
-| `squads/squad-creator-pro/data/pipeline-patterns.md` | Pipeline patterns (state, progress, runner) |
-| `squads/squad-creator-pro/data/core-heuristics.md` | Core heuristics reference |
-| `squads/squad-creator-pro/data/tool-evaluation-framework.md` | Tool evaluation criteria |
-| `squads/squad-creator-pro/data/squad-type-definitions.yaml` | Squad type definitions |
-| `squads/squad-creator-pro/data/fusion-decision-points-analysis.md` | Fusion decision analysis |
-| `squads/squad-creator-pro/data/fusion-executor-analysis.md` | Fusion executor analysis |
-| `squads/squad-creator-pro/data/pm-best-practices.md` | PM best practices |
-
-### Arquivos de Data (@oalanicolas)
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/data/an-source-tiers.yaml` | Source quality tiers |
-| `squads/squad-creator-pro/data/an-clone-validation.yaml` | Clone validation rules |
-| `squads/squad-creator-pro/data/an-output-examples.yaml` | Output examples reference |
-| `squads/squad-creator-pro/data/an-clone-anti-patterns.yaml` | Clone anti-patterns |
-| `squads/squad-creator-pro/data/an-anchor-words.yaml` | Anchor words for extraction |
-| `squads/squad-creator-pro/data/an-source-signals.yaml` | Source quality signals |
-| `squads/squad-creator-pro/data/an-diagnostic-framework.yaml` | Diagnostic framework |
-
-### Arquivos de Data (@pedro-valerio)
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/data/pv-workflow-validation.yaml` | Workflow validation rules |
-| `squads/squad-creator-pro/data/pv-anchor-words.yaml` | Anchor words for validation |
-| `squads/squad-creator-pro/data/pv-authenticity-markers.yaml` | Authenticity markers |
-| `squads/squad-creator-pro/data/pv-output-examples.yaml` | Output examples |
-| `squads/squad-creator-pro/data/pv-meta-axiomas.yaml` | Meta axiomas de processo |
-
-### Arquivos de Checklists
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/checklists/squad-checklist.md` | Squad completion checklist |
-| `squads/squad-creator-pro/checklists/mind-validation.md` | Mind validation before inclusion |
-| `squads/squad-creator-pro/checklists/deep-research-quality.md` | Research quality validation |
-| `squads/squad-creator-pro/checklists/agent-quality-gate.md` | Agent validation (SC_AGT_001) |
-| `squads/squad-creator-pro/checklists/task-anatomy-checklist.md` | Task validation (8 fields) |
-| `squads/squad-creator-pro/checklists/quality-gate-checklist.md` | General quality gates |
-| `squads/squad-creator-pro/checklists/smoke-test-agent.md` | 3 smoke tests obrigatórios |
-| `squads/squad-creator-pro/checklists/agent-depth-checklist.md` | Agent depth validation |
-| `squads/squad-creator-pro/checklists/executor-matrix-checklist.md` | Executor matrix validation |
-| `squads/squad-creator-pro/checklists/sop-validation.md` | SOP validation |
-
-### Arquivos de Templates
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/templates/config-tmpl.yaml` | Squad config template |
-| `squads/squad-creator-pro/templates/readme-tmpl.md` | Squad README template |
-| `squads/squad-creator-pro/templates/agent-tmpl.md` | Agent definition template |
-| `squads/squad-creator-pro/templates/task-tmpl.md` | Task template |
-| `squads/squad-creator-pro/templates/workflow-tmpl.yaml` | Multi-phase workflow template |
-| `squads/squad-creator-pro/templates/template-tmpl.yaml` | Template for templates |
-| `squads/squad-creator-pro/templates/quality-dashboard-tmpl.md` | Quality metrics dashboard |
-| `squads/squad-creator-pro/templates/quality-gate-tmpl.yaml` | Quality gate template |
-| `squads/squad-creator-pro/templates/pipeline-state-tmpl.py` | PipelineState scaffold |
-| `squads/squad-creator-pro/templates/pipeline-progress-tmpl.py` | ProgressTracker scaffold |
-| `squads/squad-creator-pro/templates/pipeline-runner-tmpl.py` | PhaseRunner scaffold |
-| `squads/squad-creator-pro/templates/research-prompt-tmpl.md` | Research prompt template |
-| `squads/squad-creator-pro/templates/research-output-tmpl.md` | Research output template |
-| `squads/squad-creator-pro/templates/squad-prd-tmpl.md` | Squad PRD template |
-| `squads/squad-creator-pro/templates/story-create-agent-tmpl.md` | Story template for agent creation |
-| `squads/squad-creator-pro/templates/pop-extractor-prompt.md` | POP extractor prompt |
-| `squads/squad-creator-pro/templates/squad-readme-tmpl.md` | Squad README template |
-| `squads/squad-creator-pro/templates/agent-flow-doc-tmpl.md` | Agent flow documentation template |
-| `squads/squad-creator-pro/templates/workflow-doc-tmpl.md` | Workflow documentation template |
-
----
-
-## Diagramas
-
-### Flowchart: Sistema Completo do @squad-chief
-
-```mermaid
-flowchart TB
-    subgraph ACTIVATION["ATIVAÇÃO DO AGENTE"]
-        A["@squad-chief"] --> B["Carrega Persona"]
-        B --> C["Execute generate-squad-greeting.js"]
-        C --> D["Exibe Greeting + Commands"]
-        D --> E["HALT - Aguarda Usuário"]
-    end
-
-    subgraph TRIAGE["TRIAGE & ROUTING"]
-        E --> F{"Request Type?"}
-
-        F -->|"CREATE"| G["New squad, agent, workflow"]
-        F -->|"MODIFY"| H["Update existing (brownfield)"]
-        F -->|"VALIDATE"| I["Check quality"]
-        F -->|"EXPLORE"| J["Research, analyze"]
-    end
-
-    subgraph ROUTING["SPECIALIST ROUTING"]
-        G --> K{"Needs Specialist?"}
-
-        K -->|"Mind Cloning"| L["@oalanicolas"]
-        K -->|"Process Design"| M["@pedro-valerio"]
-        K -->|"General Creation"| N["Handle Internally"]
-    end
-
-    subgraph EXECUTION["EXECUÇÃO"]
-        N --> O["Load Task/Workflow"]
-        L --> O
-        M --> O
-
-        O --> P["Execute with Checkpoints"]
-        P --> Q{"Quality Gate"}
-
-        Q -->|"PASS"| R["Output + Handoff"]
-        Q -->|"FAIL"| S["Loop/Retry"]
-        S --> P
-    end
-
-    style ACTIVATION fill:#e3f2fd
-    style TRIAGE fill:#e8f5e9
-    style ROUTING fill:#fff8e1
-    style EXECUTION fill:#f3e5f5
-```
-
-### Diagrama de Estados do @squad-chief
-
-```mermaid
-stateDiagram-v2
-    [*] --> Idle: Ativação
-
-    Idle --> Triage: Request recebido
-
-    state Triage {
-        [*] --> IdentifyType
-        IdentifyType --> CheckRegistry: CREATE request
-        CheckRegistry --> RouteSpecialist: Domain match
-        RouteSpecialist --> [*]
-    }
-
-    Triage --> Research: CREATE squad
-    Triage --> Validation: VALIDATE request
-    Triage --> Execution: Direct command
-
-    state Research {
-        [*] --> MindResearchLoop
-        MindResearchLoop --> DevilsAdvocate: Iteration N
-        DevilsAdvocate --> MindResearchLoop: Refine
-        DevilsAdvocate --> FrameworkValidation: 3-5 iterations done
-        FrameworkValidation --> [*]
-    }
-
-    Research --> Creation: Elite minds selected
-
-    state Creation {
-        [*] --> CloneMind
-        CloneMind --> CreateAgent: DNA extracted
-        CreateAgent --> QualityGate
-        QualityGate --> [*]: PASS
-        QualityGate --> CloneMind: FAIL
-    }
-
-    Creation --> Idle: Squad complete
-    Validation --> Idle: Report generated
-    Execution --> Idle: Task complete
-
-    Idle --> [*]: *exit
-```
-
-### Fluxo de Criação de Squad (wf-create-squad)
-
-```mermaid
-flowchart TB
-    subgraph PHASE_0["Phase 0: Discovery"]
-        A["Input: Domain Request"] --> B["Check squad-registry.yaml"]
-        B --> C{"Existing Squad?"}
-        C -->|"Yes"| D["Offer: Use/Extend/Create New"]
-        C -->|"No"| E["Proceed to Research"]
-    end
-
-    subgraph PHASE_1["Phase 1: Research"]
-        E --> F["Execute mind-research-loop"]
-        F --> G["Iteration 1: Broad Search"]
-        G --> H["Iteration 2-3: Devil's Advocate"]
-        H --> I["Iteration 4-5: Framework Validation"]
-        I --> J["Present Elite Minds"]
-    end
-
-    subgraph PHASE_2["Phase 2: Architecture"]
-        J --> K["Define Tier Structure"]
-        K --> L["Map Handoffs"]
-        L --> M["Design Orchestration"]
-    end
-
-    subgraph PHASE_3["Phase 3: Creation"]
-        M --> N{"For Each Mind"}
-        N --> O["/clone-mind"]
-        O --> P["Voice DNA + Thinking DNA"]
-        P --> Q["create-agent.md"]
-        Q --> R["Quality Gate SC_AGT_001"]
-        R -->|"PASS"| N
-        R -->|"FAIL"| O
-    end
-
-    subgraph PHASE_4["Phase 4: Integration"]
-        N -->|"All Done"| S["Generate config.yaml"]
-        S --> T["Generate README.md"]
-        T --> U["Wire Handoffs"]
-    end
-
-    subgraph PHASE_5["Phase 5: Validation"]
-        U --> V["Run smoke-test-agent"]
-        V --> W["Overall Quality Score"]
-        W --> X{"Score >= 7.0?"}
-        X -->|"No"| Y["Identify Gaps"]
-        Y --> N
-    end
-
-    subgraph PHASE_6["Phase 6: Handoff"]
-        X -->|"Yes"| Z["Generate Dashboard"]
-        Z --> AA["Document Next Steps"]
-        AA --> AB["Squad Ready"]
-    end
-
-    style PHASE_0 fill:#e3f2fd
-    style PHASE_1 fill:#e8f5e9
-    style PHASE_2 fill:#fff8e1
-    style PHASE_3 fill:#f3e5f5
-    style PHASE_4 fill:#fce4ec
-    style PHASE_5 fill:#e0f2f1
-    style PHASE_6 fill:#fff3e0
-```
-
----
-
-## Mapeamento de Comandos
-
-### Comandos de Criação
-
-| Comando | Task/Workflow | Operação |
-|---------|---------------|----------|
-| `*create-squad` | `wf-create-squad.yaml` | Criar squad completo (6 phases) |
-| `*create-agent` | `create-agent.md` | Criar agent individual |
-| `*create-workflow` | `create-workflow.md` | Criar multi-phase workflow |
-| `*create-task` | `create-task.md` | Criar atomic task |
-| `*create-template` | `create-template.md` | Criar output template |
-| `*create-pipeline` | `create-pipeline.md` | Gerar pipeline scaffolding |
-
-### Comandos de Mind Cloning
-
-| Comando | Task/Workflow | Operação |
-|---------|---------------|----------|
-| `*clone-mind` | `/clone-mind` skill | Complete mind cloning |
-| `*extract-voice-dna` | `extract-voice-dna.md` | Voice DNA only |
-| `*extract-thinking-dna` | `extract-thinking-dna.md` | Thinking DNA only |
-| `*update-mind` | `update-mind.md` | Brownfield update |
-| `*auto-acquire-sources` | `auto-acquire-sources.md` | Auto-fetch sources |
-
-### Comandos de Validação
-
-| Comando | Task/Workflow | Operação |
-|---------|---------------|----------|
-| `*validate-squad` | `validate-squad.md` | Validate entire squad |
-| `*validate-agent` | inline | Validate single agent |
-| `*validate-task` | inline | Validate single task |
-| `*validate-workflow` | inline | Validate single workflow |
-| `*quality-dashboard` | `quality-dashboard-tmpl.md` | Generate quality metrics |
-
-### Comandos de Tool Discovery
-
-| Comando | Task/Workflow | Operação |
-|---------|---------------|----------|
-| `*discover-tools` | `wf-discover-tools.yaml` | Deep parallel discovery |
-| `*show-tools` | inline | Display tool-registry.yaml |
-| `*add-tool` | inline | Add tool to squad dependencies |
-
-### Comandos de Analytics
-
-| Comando | Task/Workflow | Operação |
-|---------|---------------|----------|
-| `*list-squads` | inline | List all created squads |
-| `*show-registry` | inline | Display squad-registry.yaml |
-| `*squad-analytics` | `squad-analytics.md` | Detailed analytics dashboard |
-| `*refresh-registry` | `refresh-registry.md` | Scan and update registry |
-
-### Comandos de Utility
-
-| Comando | Task/Workflow | Operação |
-|---------|---------------|----------|
-| `*guide` | inline | Interactive onboarding guide |
-| `*sync` | `sync-ide-command.md` | Sync to .claude/commands/ |
-| `*optimize` | `optimize.md` | Optimize squad/task |
-| `*upgrade-squad` | `upgrade-squad.md` | Upgrade to current standards |
-| `*help` | inline | Show all commands |
-| `*exit` | inline | Deactivate persona |
-
----
-
-## Integrações entre Agentes
-
-### Diagrama de Colaboração
-
-```mermaid
-flowchart TB
-    subgraph SQUAD_CREATOR["SQUAD-CREATOR ECOSYSTEM"]
-        CHIEF["@squad-chief<br/>(Orchestrator)"]
-    end
-
-    subgraph SPECIALISTS["TIER 1 SPECIALISTS"]
-        AN["@oalanicolas<br/>(Mind Cloner)"]
-        PV["@pedro-valerio<br/>(Process Absolutist)"]
-        TF["@tim-ferriss<br/>(Deconstructor)"]
-    end
-
-    subgraph EXTERNAL["EXTERNAL AGENTS"]
-        QA["@qa-architect<br/>(Deep Validation)"]
-        DEV["@dev<br/>(Implementation)"]
-        DESIGN["@design<br/>(UI/UX)"]
-    end
-
-    subgraph USER["USER INPUT"]
-        USER_REQ["Domain Request"]
-    end
-
-    USER_REQ -->|"create squad"| CHIEF
-
-    CHIEF -->|"mind cloning"| AN
-    CHIEF -->|"workflow validation"| PV
-    CHIEF -->|"deconstruction"| TF
-
-    AN -->|"DNA extracted"| CHIEF
-    PV -->|"audit report"| CHIEF
-    TF -->|"frameworks"| CHIEF
-
-    CHIEF -->|"deep validation"| QA
-    CHIEF -->|"code needed"| DEV
-    CHIEF -->|"UI needed"| DESIGN
-
-    style CHIEF fill:#e8f5e9
-    style AN fill:#e3f2fd
-    style PV fill:#fff8e1
-    style TF fill:#fce4ec
-    style QA fill:#f3e5f5
-    style DEV fill:#e0f2f1
-    style DESIGN fill:#fff3e0
-```
-
-### Fluxo de Colaboração
-
-| De | Para | Trigger | Ação |
-|----|------|---------|------|
-| User | @squad-chief | "create squad for {domain}" | Initiate research loop |
-| @squad-chief | @oalanicolas | "clone mind {name}" | Extract Voice + Thinking DNA |
-| @oalanicolas | @squad-chief | DNA complete | Continue agent creation |
-| @squad-chief | @pedro-valerio | "validate workflow" | Audit for veto conditions |
-| @pedro-valerio | @squad-chief | Audit report | Apply fixes or approve |
-| @squad-chief | @tim-ferriss | "deconstruct {system}" | Extract frameworks |
-| @tim-ferriss | @squad-chief | Frameworks extracted | Use in agent creation |
-
-### Handoff Rules
-
-| Domínio | Trigger | Destino |
-|---------|---------|---------|
-| Mind cloning, DNA extraction | "clone mind", "extract DNA", "fidelity" | @oalanicolas |
-| Workflow design, process validation | "validate workflow", "veto conditions", "checkpoint" | @pedro-valerio |
-| Deconstruction, framework extraction | "deconstruct", "extract framework" | @tim-ferriss |
-| Deep validation beyond standard gates | "deep audit", "comprehensive validation" | @qa-architect |
-| Code implementation needed | "needs coding", "implement" | @dev |
-| UI/UX design needed | "design UI", "interface" | @design |
-
-### Routing Triggers
-
-```yaml
-routing_triggers:
-  oalanicolas:
-    - "clone mind"
-    - "extract DNA"
-    - "source curation"
-    - "fidelity"
-    - "voice DNA"
-    - "thinking DNA"
-
-  pedro_valerio:
-    - "workflow design"
-    - "process validation"
-    - "veto conditions"
-    - "checkpoint"
-    - "handoff issues"
-
-  tim_ferriss:
-    - "deconstruct"
-    - "framework extraction"
-    - "reverse engineer"
-```
-
----
-
-## Veto Conditions
-
-### Condições que Bloqueiam Execução
-
-| Trigger | Ação | Severidade |
-|---------|------|------------|
-| Squad request without research | VETO - Must run mind-research-loop first | CRITICAL |
-| Agent creation from memory | VETO - Must validate framework documentation | CRITICAL |
-| Agent under 300 lines | VETO - Does not meet quality standard | HIGH |
-| Missing voice_dna section | VETO - Agent will have inconsistent outputs | HIGH |
-| Missing output_examples (< 3) | VETO - Unpredictable behavior | HIGH |
-| Workflow without checkpoints | VETO - No validation points | MEDIUM |
-| Task under 500 lines (complex) | VETO - Missing depth | MEDIUM |
-| Famous mind without documented framework | VETO - Fame ≠ replicable method | HIGH |
-
-### Blocking Conditions
-
-O @squad-chief deve **HALT** e perguntar ao usuário quando:
-- Scope > 3 agents and architecture unclear
-- Domain has no discoverable elite minds with frameworks
-- Existing squad covers 80%+ of requested domain
-- Quality score < 7.0 after 3 iterations
-- Mind has insufficient source material for DNA extraction
-
-### Anti-Patterns (NEVER DO)
-
-```yaml
-never_do:
-  - "Create agents from memory/assumptions without research"
-  - "Skip the mind-research-loop for any domain"
-  - "Accept famous names without validating documented frameworks"
-  - "Create agents under 300 lines"
-  - "Create tasks under 500 lines for complex operations"
-  - "Skip quality gates to save time"
-  - "Use generic terms instead of AIOS vocabulary"
-  - "Ask clarifying questions before research when user requests squad"
-  - "Propose agent architecture before researching elite minds"
-  - "Create workflows without checkpoints"
-  - "Create squads without orchestrator agent"
-```
-
----
-
-## Configuração
-
-### Arquivos de Configuração Relevantes
-
-| Arquivo | Propósito |
-|---------|-----------|
-| `squads/squad-creator-pro/config.yaml` | Squad configuration |
-| `squads/squad-creator-pro/agents/squad-chief.md` | Agent definition (1329 lines) |
-| `squads/squad-creator-pro/data/squad-registry.yaml` | Ecosystem awareness |
-| `squads/squad-creator-pro/data/tool-registry.yaml` | Tool catalog |
-
-### Mission Router
-
-```yaml
-# Mapeamento comando → arquivo
-mission_router:
-  "*create-squad": "workflows/wf-create-squad.yaml"
-  "*create-agent": "tasks/create-agent.md"
-  "*create-workflow": "tasks/create-workflow.md"
-  "*create-task": "tasks/create-task.md"
-  "*create-template": "tasks/create-template.md"
-  "*create-pipeline": "tasks/create-pipeline.md"
-  "*clone-mind": "/clone-mind skill"
-  "*extract-voice-dna": "tasks/extract-voice-dna.md"
-  "*extract-thinking-dna": "tasks/extract-thinking-dna.md"
-  "*validate-squad": "tasks/validate-squad.md"
-  "*discover-tools": "workflows/wf-discover-tools.yaml"
-  "*squad-analytics": "tasks/squad-analytics.md"
-  "*refresh-registry": "tasks/refresh-registry.md"
-  "*optimize": "tasks/optimize.md"
-  "*upgrade-squad": "tasks/upgrade-squad.md"
-
-# Data files carregados por comando
-data_loading:
-  "*create-squad":
-    - "data/squad-registry.yaml"
-    - "data/squad-kb.md"
-  "*validate-squad":
-    - "data/quality-dimensions-framework.md"
-    - "data/decision-heuristics-framework.md"
-  "*discover-tools":
-    - "data/tool-registry.yaml"
-    - "data/tool-evaluation-framework.md"
-```
-
-### Lazy Loading Strategy
-
-```yaml
-# Arquivos carregados APENAS quando necessários
-lazy_load:
-  tasks/: "Carregado quando comando é invocado"
-  workflows/: "Carregado quando workflow triggered"
-  data/: "Carregado quando task precisa"
-  checklists/: "Carregado em validações"
-  templates/: "Carregado em criações"
-
-# NUNCA carregar na ativação
-never_preload:
-  - "data/*.yaml"
-  - "data/*.md"
-  - "tasks/*.md"
-  - "checklists/*.md"
-```
-
-### Auto-Triggers
-
-```yaml
-# Patterns que disparam ações automáticas
-auto_triggers:
-  squad_request:
-    patterns:
-      - "create squad"
-      - "create team"
-      - "want a squad"
-      - "need experts in"
-      - "best minds for"
-      - "team of [domain]"
-      - "squad de"
-      - "quero um squad"
-      - "preciso de especialistas"
-
-    action: |
-      IMMEDIATELY execute workflows/mind-research-loop.md
-      NO questions before research
-      Present elite minds THEN ask about creation
-```
-
----
-
-## Modos de Execução
-
-### YOLO Mode (Default)
-
-| Aspecto | Configuração |
-|---------|--------------|
-| **Interação** | Mínima |
-| **Pesquisa** | Automática, sem materiais do usuário |
-| **Fidelidade** | 60-75% |
-| **Duração** | 4-6h |
-| **Checkpoints** | Apenas críticos |
-
-```bash
-# Exemplo
-*create-squad copywriting --mode yolo
-```
-
-### Quality Mode
-
-| Aspecto | Configuração |
-|---------|--------------|
-| **Interação** | Validações em cada fase |
-| **Pesquisa** | Com materiais do usuário |
-| **Fidelidade** | 85-95% |
-| **Duração** | 6-8h |
-| **Checkpoints** | Todos (human review) |
-
-```bash
-# Exemplo
-*create-squad copywriting --mode quality --materials ./sources/
-```
-
-### Hybrid Mode
-
-| Aspecto | Configuração |
-|---------|--------------|
-| **Interação** | Por expert |
-| **Pesquisa** | Mix: alguns com materiais, outros YOLO |
-| **Fidelidade** | Varia por expert |
-| **Duração** | 5-7h |
-| **Checkpoints** | Seletivos |
-
-```bash
-# Exemplo
-*create-squad copywriting --mode hybrid
-```
-
-### Pre-Flight Check
-
-Antes de qualquer criação, verificar:
-
-```yaml
-pre_flight:
-  - "Check squad-registry.yaml for existing coverage"
-  - "Validate domain has discoverable elite minds"
-  - "Confirm user understands time investment"
-  - "Verify output path is writable"
-```
-
----
-
-## Best Practices
-
-### Quando Usar o @squad-chief
-
-**USE @squad-chief para:**
-- Criar squads completos de qualquer domínio
-- Orquestrar pesquisa de elite minds
-- Coordenar mind cloning entre specialists
-- Validar squads existentes
-- Análise de ecosistema e gaps
-- Descoberta de ferramentas
-
-**NÃO USE @squad-chief para:**
-- Extração detalhada de Voice/Thinking DNA → @oalanicolas
-- Validação de processos/workflows → @pedro-valerio
-- Deconstructing frameworks específicos → @tim-ferriss
-- Implementação de código → @dev
-- Design de UI/UX → @design
-
-### Ciclo de Execução Recomendado
-
-1. **Ative o agente** com `@squad-chief` ou `/squad-creator:agents:squad-chief`
-2. **Aguarde o greeting** antes de enviar comandos
-3. **Solicite squad por domínio** (não tente sugerir experts)
-4. **Aguarde pesquisa completa** (3-5 iterações)
-5. **Aprove elite minds** selecionados
-6. **Aguarde clonagem** de cada mind
-7. **Valide output** com `*validate-squad`
-8. **Use o squad** criado
-
-### Convenções
-
-| Aspecto | Convenção |
-|---------|-----------|
-| Comandos | Sempre com `*` prefix |
-| Argumentos | Entre `{}` ou após espaço |
-| Paths | Relativos ao squad (`squads/squad-creator-pro/`) |
-| Data files | YAML ou MD format |
-| Task files | Markdown format |
-| Workflow files | YAML format |
-| Output | `squads/{squad-name}/` |
-
-### Quality Standards
-
-| Artifact | Min Lines | Required Sections |
-|----------|-----------|-------------------|
-| Agent | 300 | voice_dna, output_examples (3), anti_patterns |
-| Task (complex) | 500 | Multiple PHASES, YAML templates inline |
-| Workflow | 500 | Phases with checkpoints, inline structures |
-| Squad | - | Orchestrator agent, config.yaml, README.md |
-
----
-
-## Troubleshooting
-
-### Comando não reconhecido
-
-```
-Erro: Comando '*xyz' não encontrado no mission router
-```
-
-**Causas:**
-- Typo no comando
-- Comando não existe para este agente
-- Agente não foi ativado corretamente
-
-**Solução:**
-1. Verificar lista de comandos com `*help`
-2. Confirmar spelling do comando
-3. Reativar agente se necessário
-
-### Research loop não encontra elite minds
-
-```
-Erro: Insufficient elite minds with documented frameworks for domain
-```
-
-**Causas:**
-- Domínio muito nichado
-- Elite minds existem mas sem frameworks públicos
-- Search queries inadequadas
-
-**Solução:**
-1. Expandir domínio (ex: "legal contracts" → "legal")
-2. Fornecer materiais manualmente
-3. Usar `*auto-acquire-sources` para busca alternativa
-
-### Quality gate falha repetidamente
-
-```
-Erro: Quality score < 7.0 after 3 iterations
-```
-
-**Causas:**
-- Fontes insuficientes para DNA extraction
-- Mind não tem framework documentado
-- Agent missing required sections
-
-**Solução:**
-1. Verificar quais sections estão faltando
-2. Adicionar mais fontes
-3. Considerar mind diferente com melhor documentação
-
-### Agent creation blocks on /clone-mind
-
-```
-Erro: VETO - Agent based on real person must run /clone-mind first
-```
-
-**Causas:**
-- Tentativa de criar agent sem extrair DNA
-- Bypass do clone-before-create rule
-
-**Solução:**
-1. Executar `/clone-mind {name}` primeiro
-2. Aguardar DNA extraction completar
-3. Então executar `*create-agent`
-
-### Handoff para specialist falha
-
-```
-Erro: Handoff para @oalanicolas falhou - context insufficient
-```
-
-**Causas:**
-- Context não inclui informações necessárias
-- Specialist agent não está disponível
-- Missing required parameters
-
-**Solução:**
-1. Verificar handoff rules no agente
-2. Incluir: mind_name, domain, sources_path
-3. Retentar com context completo
-
----
-
-## Referências
-
-### Tasks por Categoria
-
-| Categoria | Tasks |
-|-----------|-------|
-| Creation | `create-squad.md`, `create-agent.md`, `create-workflow.md`, `create-task.md`, `create-template.md`, `create-pipeline.md` |
-| Mind Cloning | `collect-sources.md`, `auto-acquire-sources.md`, `extract-voice-dna.md`, `extract-thinking-dna.md`, `update-mind.md` |
-| Validation | `validate-squad.md`, `qa-after-creation.md` |
-| Analytics | `squad-analytics.md`, `refresh-registry.md` |
-| Utility | `optimize.md`, `upgrade-squad.md`, `sync-ide-command.md`, `install-commands.md` |
-
-### Workflows
-
-| Workflow | Phases | Duration |
-|----------|--------|----------|
-| `wf-create-squad.yaml` | 6 | 4-8h |
-| `wf-clone-mind.yaml` | 5 | 2-3h |
-| `wf-mind-research-loop.yaml` | 3-5 iterations | 15-30 min |
-| `wf-discover-tools.yaml` | 5 sub-agents | 30-60 min |
-
-### Checklists
-
-| Checklist | Purpose |
-|-----------|---------|
-| `squad-checklist.md` | Squad completion |
-| `agent-quality-gate.md` | SC_AGT_001 |
-| `mind-validation.md` | Pre-inclusion validation |
-| `smoke-test-agent.md` | 3 behavioral tests |
-| `task-anatomy-checklist.md` | 8 required fields |
-
-### Data Files
-
-| Data File | Purpose |
-|-----------|---------|
-| `squad-registry.yaml` | Ecosystem map |
-| `tool-registry.yaml` | Tool catalog |
-| `quality-dimensions-framework.md` | Scoring |
-| `tier-system-framework.md` | Agent organization |
-| `decision-heuristics-framework.md` | Decision rules |
-
-### Documentação Relacionada
-
-| Documento | Path |
-|-----------|------|
-| Squad README | `squads/squad-creator-pro/README.md` |
-| Concepts | `squads/squad-creator-pro/docs/CONCEPTS.md` |
-| FAQ | `squads/squad-creator-pro/docs/FAQ.md` |
-| Architecture | `squads/squad-creator-pro/docs/ARCHITECTURE-DIAGRAMS.md` |
-
----
-
-## Resumo
-
-| Aspecto | Detalhes |
-|---------|----------|
-| **Total de Tasks** | 41 task files |
-| **Comandos Principais** | 25+ comandos |
-| **Data Files** | 29 arquivos |
-| **Checklists** | 10 checklists |
-| **Templates** | 19 templates |
-| **Workflows** | 9 workflows |
-| **Agentes no Squad** | 4 (@squad-chief, @oalanicolas, @pedro-valerio, @tim-ferriss) |
-| **Veto Conditions** | 8 condições críticas |
-| **Handoff Rules** | 6 regras de delegação |
-| **Linhas do Agent** | 1329 linhas |
-
----
-
-## Changelog
-
-| Data | Autor | Descrição |
-|------|-------|-----------|
-| 2026-02-10 | @pedro-valerio | Documento inicial criado aplicando agent-flow-doc-tmpl.md |
-
----
-
-*"Clone minds > create bots"*
-
----
-
-*Documentação gerada seguindo SC-DP-001 (Agent Flow Documentation)*
-*Padrão baseado em: docs/guides/aios-agent-flows/*