npm - aiox-core - Versions diffs - 5.0.4 → 5.0.5 - Mend

aiox-core 5.0.4 → 5.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (618) hide show

package/pro/squads/squad-creator-pro/docs/squad-creation-pipeline-workflow.md DELETED Viewed

@@ -1,937 +0,0 @@
-# Workflow: Squad Creation Pipeline
-**Versão:** 2.0
-**Tipo:** Workflow de Criação de Squads
-**Autores:** @oalanicolas (Knowledge Architect) + @pedro-valerio (Process Architect)
-**Data de Criação:** 2026-02-10
-**Última Atualização:** 2026-02-10
-**Tags:** squad, creation, extraction, operationalization, pipeline, AN, PV
----
-## Visão Geral
-O **Squad Creation Pipeline** é o workflow completo para criação de squads baseados em experts. Ele implementa a separação fundamental entre **Knowledge** (extração de conhecimento) e **Operationalization** (transformação em processos executáveis).
-### Objetivo
-Garantir que squads sejam criados com:
-1. **Conhecimento autêntico** - Extraído de fontes reais, não inventado
-2. **Processos à prova de erro** - Operacionalizados com veto conditions
-3. **Rastreabilidade completa** - Citações, fontes, e validações documentadas
-### Princípio Fundamental
-```
-KNOWLEDGE ≠ OPERATIONALIZATION
-@oalanicolas (Knowledge Architect) extrai "O QUE o expert sabe/pensa"
-@pedro-valerio (Process Architect) transforma em "COMO fazer sem errar"
-```
-### Arquitetura de 3 Agentes
-```
-┌────────────┐     ┌───────────────────────┐     ┌────────────────┐     ┌────────────┐
-│   CHIEF    │ ──► │    @oalanicolas       │ ──► │ @pedro-valerio │ ──► │   CHIEF    │
-│  (triage)  │     │ (research+extraction) │     │ (operationalize)│     │ (assembly) │
-└────────────┘     └───────────────────────┘     └────────────────┘     └────────────┘
-```
-### Tipos de Projeto Suportados
-| Tipo | Descrição |
-|------|-----------|
-| `mind-clone` | Clonagem de expert individual (funcional, não perfeito) |
-| `multi-mind` | Squad com múltiplos experts clonados |
-| `domain-squad` | Squad temático (ex: Copy, Design, Data) |
-| `hybrid-squad` | Combinação de minds clonados + agents funcionais |
----
-## Arquitetura de Responsabilidades
-### Regra de Ouro
-| Se o artefato responde... | Owner |
-|---------------------------|-------|
-| "O que ele pensa?" | @oalanicolas |
-| "Como ele decide?" | @oalanicolas |
-| "Qual o modelo mental?" | @oalanicolas |
-| "Quais as heurísticas?" | @oalanicolas |
-| "Como fazer sem errar?" | @pedro-valerio |
-| "Qual a sequência?" | @pedro-valerio |
-| "Como validar?" | @pedro-valerio |
-### Mapeamento de Artefatos
-| Artefato | Tipo | Owner |
-|----------|------|-------|
-| `*-framework.md` | Knowledge | @oalanicolas |
-| `*_dna.yaml` | Knowledge | @oalanicolas |
-| `core_principles.yaml` | Knowledge | @oalanicolas |
-| `mental_models.yaml` | Knowledge | @oalanicolas |
-| `heuristics.yaml` | Knowledge | @oalanicolas |
-| `signature_phrases.yaml` | Knowledge | @oalanicolas |
-| `source-index.yaml` | Knowledge | @oalanicolas |
-| `*-sop.md` | Operationalization | @pedro-valerio |
-| `*-checklist.md` | Operationalization | @pedro-valerio |
-| `*-workflow.yaml` | Operationalization | @pedro-valerio |
-| `*-blueprint.yaml` | Operationalization | @pedro-valerio |
----
-## Diagrama Mermaid do Workflow
-### Pipeline Completo
-```mermaid
-flowchart TB
-    subgraph PHASE_0["Fase 0: INTAKE"]
-        START([User Request]) --> CHIEF["@squad-chief<br/>Triagem"]
-        CHIEF --> BRIEFING["📋 Briefing Document<br/>• Expert target<br/>• Domain<br/>• Sources hints<br/>• Agents needed"]
-        BRIEFING --> USER_APPROVAL{"User aprova<br/>escopo?"}
-        USER_APPROVAL -->|Não| CHIEF
-    end
-    subgraph PHASE_1["Fase 1: KNOWLEDGE (Research + Extraction)"]
-        USER_APPROVAL -->|Sim| AN["@oalanicolas<br/>Knowledge Architect"]
-        AN --> AN_RESEARCH["Research:<br/>• Buscar sources<br/>• Classificar ouro/bronze<br/>• Validar cobertura"]
-        AN_RESEARCH --> SOURCE_GATE{"SOURCE_COVERAGE<br/>5+ páginas?<br/>3+ citações?"}
-        SOURCE_GATE -->|FAIL| AN_RESEARCH
-        SOURCE_GATE -->|PASS| AN_EXTRACT["Extraction:<br/>• Voice DNA<br/>• Thinking DNA<br/>• Frameworks<br/>• Heuristics<br/>• Mental Models"]
-        AN_EXTRACT --> AN_VALIDATE{"Self-Validation<br/>15+ citações?<br/>5+ phrases?"}
-        AN_VALIDATE -->|FAIL| AN_EXTRACT
-        AN_VALIDATE -->|PASS| KNOWLEDGE_ARTIFACTS["📦 KNOWLEDGE ARTIFACTS<br/>• {expert}_dna.yaml<br/>• core_principles.yaml<br/>• heuristics.yaml<br/>• frameworks/*.md"]
-    end
-    subgraph HANDOFF_1["🚦 HANDOFF #1: AN → PV"]
-        KNOWLEDGE_ARTIFACTS --> GATE_1{"FRAMEWORK_HANDOFF_READY<br/>• 15+ citações?<br/>• Voice verificável?<br/>• Thinking aplicável?<br/>• Zero inferências?"}
-        GATE_1 -->|REJECT| AN_EXTRACT
-        GATE_1 -->|APPROVED| PV
-    end
-    subgraph PHASE_2["Fase 2: OPERATIONALIZATION"]
-        PV["@pedro-valerio<br/>Process Architect"]
-        PV --> PV_WORK["Executa:<br/>• SOPs (do framework)<br/>• Checklists (do SOP)<br/>• Workflows<br/>• Veto Conditions<br/>• Quality Gates"]
-        PV_WORK --> PV_VALIDATE{"Anti-Invention Check<br/>SOP ref. framework?<br/>Zero conceitos novos?"}
-        PV_VALIDATE -->|FAIL| PV_WORK
-        PV_VALIDATE -->|PASS| OPERATIONAL_ARTIFACTS["📦 OPERATIONAL ARTIFACTS<br/>• sops/*.md<br/>• checklists/*.md<br/>• workflows/*.yaml<br/>• blueprints/*.yaml"]
-    end
-    subgraph HANDOFF_2["🚦 HANDOFF #2: PV → CHIEF"]
-        OPERATIONAL_ARTIFACTS --> GATE_2{"SOP_INTEGRITY_GATE<br/>• SOP ref. framework?<br/>• Checklist ref. SOP?<br/>• Paths corretos?"}
-        GATE_2 -->|REJECT: invenção| PV_WORK
-        GATE_2 -->|REJECT: falta conhecimento| AN_EXTRACT
-        GATE_2 -->|APPROVED| ASSEMBLY
-    end
-    subgraph PHASE_3["Fase 3: ASSEMBLY"]
-        ASSEMBLY["@squad-chief<br/>ASSEMBLY"]
-        ASSEMBLY --> ASSEMBLY_WORK["Executa:<br/>• Agent files<br/>• Config.yaml<br/>• Routing setup<br/>• Inter-agent refs"]
-        ASSEMBLY_WORK --> SMOKE{"SMOKE TEST<br/>• Agent carrega?<br/>• Commands funcionam?<br/>• Paths resolvem?"}
-        SMOKE -->|FAIL| ASSEMBLY_WORK
-        SMOKE -->|PASS| OUTPUT
-    end
-    subgraph PHASE_4["Fase 4: OUTPUT"]
-        OUTPUT["📦 SQUAD COMPLETO"]
-        OUTPUT --> STRUCTURE["squads/{squad-name}/<br/>├── agents/<br/>├── tasks/<br/>├── checklists/<br/>├── workflows/<br/>├── sops/<br/>├── templates/<br/>├── data/<br/>│   └── minds/<br/>└── config.yaml"]
-    end
-    style PHASE_0 fill:#e1f5fe
-    style PHASE_1 fill:#e8f5e9
-    style HANDOFF_1 fill:#ffcdd2
-    style PHASE_2 fill:#f3e5f5
-    style HANDOFF_2 fill:#ffcdd2
-    style PHASE_3 fill:#e0f7fa
-    style PHASE_4 fill:#c8e6c9
-```
-### Diagrama de Estados
-```mermaid
-stateDiagram-v2
-    [*] --> Intake: User request
-    Intake --> Intake: User não aprova escopo
-    Intake --> Knowledge: Briefing approved
-    state Knowledge {
-        [*] --> Research
-        Research --> Research: Sources insuficientes
-        Research --> Extraction: SOURCE_COVERAGE PASS
-        Extraction --> Extraction: Self-validation FAIL
-        Extraction --> [*]: Self-validation PASS
-    }
-    Knowledge --> Handoff_AN_PV: Artifacts ready
-    Handoff_AN_PV --> Knowledge: VETO - falta citação
-    Handoff_AN_PV --> Operationalization: APPROVED
-    state Operationalization {
-        [*] --> SOP_Creation
-        SOP_Creation --> Anti_Invention_Check
-        Anti_Invention_Check --> SOP_Creation: FAIL
-        Anti_Invention_Check --> [*]: PASS
-    }
-    Operationalization --> Handoff_PV_Chief: Artifacts ready
-    Handoff_PV_Chief --> Knowledge: REJECT - falta conhecimento
-    Handoff_PV_Chief --> Operationalization: REJECT - invenção
-    Handoff_PV_Chief --> Assembly: APPROVED
-    Assembly --> Assembly: Smoke test FAIL
-    Assembly --> Done: Smoke test PASS
-    Done --> [*]
-    note right of Knowledge : @oalanicolas
-    note right of Operationalization : @pedro-valerio
-    note right of Assembly : @squad-chief
-```
-### Diagrama de Sequência
-```mermaid
-sequenceDiagram
-    participant U as User
-    participant SC as @squad-chief
-    participant AN as @oalanicolas
-    participant PV as @pedro-valerio
-    U->>SC: Request: Create squad for {expert}
-    rect rgb(225, 245, 254)
-        Note over SC: Fase 0: Intake
-        SC->>SC: Triagem e escopo
-        SC->>SC: Define sources necessárias
-        SC-->>U: Briefing document
-        U-->>SC: Aprova escopo
-    end
-    rect rgb(232, 245, 233)
-        Note over AN: Fase 1: Knowledge (Research + Extraction)
-        SC->>AN: Handoff: extract knowledge from {expert}
-        loop Research até SOURCE_COVERAGE
-            AN->>AN: Buscar sources
-            AN->>AN: Classificar ouro/bronze
-            AN->>AN: Validar cobertura
-        end
-        loop Extraction até 15+ citações
-            AN->>AN: Voice DNA extraction
-            AN->>AN: Thinking DNA extraction
-            AN->>AN: Framework identification
-            AN->>AN: Heuristics mining
-            AN->>AN: Self-validation
-        end
-        AN-->>SC: Knowledge artifacts
-    end
-    rect rgb(255, 205, 210)
-        Note over SC: Handoff #1: AN → PV
-        SC->>SC: Validate FRAMEWORK_HANDOFF_READY
-        alt Validation FAIL
-            SC-->>AN: REJECT: missing citations/phrases
-        else Validation PASS
-            SC->>PV: APPROVED: proceed
-        end
-    end
-    rect rgb(243, 229, 245)
-        Note over PV: Fase 2: Operationalization
-        loop Until no invention
-            PV->>PV: SOP creation (from framework)
-            PV->>PV: Checklist derivation (from SOP)
-            PV->>PV: Workflow design
-            PV->>PV: Anti-invention check
-        end
-        PV-->>SC: Operational artifacts
-    end
-    rect rgb(255, 205, 210)
-        Note over SC: Handoff #2: PV → Chief
-        SC->>SC: Validate SOP_INTEGRITY_GATE
-        alt SOP doesn't ref framework
-            SC-->>PV: REJECT: invention detected
-        else Missing knowledge
-            SC-->>AN: REJECT: need more extraction
-        else All valid
-            SC->>SC: APPROVED: proceed
-        end
-    end
-    rect rgb(224, 247, 250)
-        Note over SC: Fase 3: Assembly
-        SC->>SC: Create agent files
-        SC->>SC: Setup config.yaml
-        SC->>SC: Smoke test
-        SC-->>U: Squad complete!
-    end
-```
----
-## Steps Detalhados
-### Step 0: Intake (Fase 0)
-| Campo | Valor |
-|-------|-------|
-| **ID** | `intake` |
-| **Agente** | @squad-chief |
-| **Ação** | Triagem e criação de briefing |
-#### Inputs
-| Input | Tipo | Origem | Obrigatório |
-|-------|------|--------|-------------|
-| `expert_name` | string | User Input | Sim |
-| `domain` | string | User Input | Sim |
-| `sources_hints` | array | User Input | Não |
-| `agents_count` | number | User Input | Não |
-#### Outputs
-| Output | Tipo | Destino |
-|--------|------|---------|
-| `briefing.yaml` | arquivo | `docs/projects/{squad}/briefing.yaml` |
-| `expert_slug` | string | Contexto do workflow |
-#### Gate: USER_APPROVAL
-- User deve aprovar escopo antes de gastar tokens em research
-- Se escopo muito amplo → Chief refina
-- Se sources insuficientes conhecidas → Chief alerta
----
-### Step 1: Knowledge - Research (Fase 1a)
-| Campo | Valor |
-|-------|-------|
-| **ID** | `research` |
-| **Agente** | @oalanicolas |
-| **Ação** | Buscar e curar sources |
-| **Requer** | `intake` + User approval |
-#### Inputs
-| Input | Tipo | Origem | Obrigatório |
-|-------|------|--------|-------------|
-| `briefing.yaml` | arquivo | Step anterior | Sim |
-| `expert_name` | string | Briefing | Sim |
-| `source_hints` | array | User | Não |
-#### Outputs
-| Output | Tipo | Destino |
-|--------|------|---------|
-| `source-index.yaml` | arquivo | `squads/{squad}/data/source-index.yaml` |
-| `transcripts/` | diretório | `squads/{squad}/data/transcripts/` |
-| `citations.yaml` | arquivo | `squads/{squad}/data/citations.yaml` |
-#### Gate: SOURCE_COVERAGE (interno a AN)
-| Critério | Threshold | Ação se FAIL |
-|----------|-----------|--------------|
-| Páginas/minutos de conteúdo | ≥ 5 | Buscar mais sources |
-| Citações diretas utilizáveis | ≥ 3 | Procurar entrevistas/podcasts |
-| Tipos de source | ≥ 2 | Diversificar (livro + video + entrevista) |
----
-### Step 2: Knowledge - Extraction (Fase 1b)
-| Campo | Valor |
-|-------|-------|
-| **ID** | `extraction` |
-| **Agente** | @oalanicolas |
-| **Ação** | Extrair conhecimento do expert |
-| **Requer** | `research` com SOURCE_COVERAGE PASS |
-#### Inputs
-| Input | Tipo | Origem | Obrigatório |
-|-------|------|--------|-------------|
-| `source-index.yaml` | arquivo | Step anterior | Sim |
-| `transcripts/` | diretório | Step anterior | Sim |
-| `citations.yaml` | arquivo | Step anterior | Sim |
-#### Outputs
-| Output | Tipo | Destino |
-|--------|------|---------|
-| `{expert}_dna.yaml` | arquivo | `squads/{squad}/data/minds/` |
-| `core_principles.yaml` | arquivo | `squads/{squad}/data/minds/` |
-| `heuristics.yaml` | arquivo | `squads/{squad}/data/minds/` |
-| `mental_models.yaml` | arquivo | `squads/{squad}/data/minds/` |
-| `signature_phrases.yaml` | arquivo | `squads/{squad}/data/minds/` |
-| `frameworks/*.md` | diretório | `squads/{squad}/docs/frameworks/` |
-#### Checklist de Self-Validation
-- [ ] 15+ citações diretas com [SOURCE: página/minuto]
-- [ ] Voice DNA com 5+ signature phrases verificáveis
-- [ ] Thinking DNA com decision architecture mapeada
-- [ ] Heuristics com contexto de aplicação (QUANDO usar)
-- [ ] Anti-patterns documentados do EXPERT (não genéricos)
-- [ ] Nenhum conceito marcado como "inferido" sem fonte
-- [ ] Cada framework referencia source original
-#### Veto Conditions (Self)
-| Trigger | Ação |
-|---------|------|
-| < 15 citações | LOOP - voltar para extração |
-| Conceito sem fonte | LOOP - documentar ou remover |
-| Framework genérico | LOOP - especificar com exemplos do expert |
-| Heuristic sem contexto | LOOP - adicionar "QUANDO aplicar" |
----
-### Handoff #1: AN → PV
-| Campo | Valor |
-|-------|-------|
-| **ID** | `handoff_an_pv` |
-| **De** | @oalanicolas |
-| **Para** | @pedro-valerio |
-| **Gate** | FRAMEWORK_HANDOFF_READY |
-#### Veto Conditions
-| Trigger | Ação | Destino |
-|---------|------|---------|
-| Framework sem citações de fonte | REJECT | @oalanicolas |
-| DNA sem signature phrases reais | REJECT | @oalanicolas |
-| Heurísticas sem contexto de aplicação | REJECT | @oalanicolas |
-| Conceito inventado detectado | REJECT | @oalanicolas |
-#### Critérios de Aprovação
-AN entrega framework QUANDO:
-- [ ] 15+ citações diretas com fonte
-- [ ] Voice DNA com 5+ signature phrases verificáveis
-- [ ] Thinking DNA com decision architecture mapeada
-- [ ] Anti-patterns documentados do EXPERT (não genéricos)
-- [ ] Nenhum conceito marcado como "inferido" sem fonte
-PV recebe APENAS SE:
-- [ ] Framework passou no checklist acima
-- [ ] Nenhum conceito marcado como "inferido" sem fonte
----
-### Step 3: Operationalization (Fase 2)
-| Campo | Valor |
-|-------|-------|
-| **ID** | `operationalization` |
-| **Agente** | @pedro-valerio |
-| **Ação** | Transformar conhecimento em processos |
-| **Requer** | `handoff_an_pv` APPROVED |
-#### Inputs
-| Input | Tipo | Origem | Obrigatório |
-|-------|------|--------|-------------|
-| `{expert}_dna.yaml` | arquivo | Step anterior | Sim |
-| `frameworks/*.md` | diretório | Step anterior | Sim |
-| `heuristics.yaml` | arquivo | Step anterior | Sim |
-#### Outputs
-| Output | Tipo | Destino |
-|--------|------|---------|
-| `sops/*.md` | diretório | `squads/{squad}/sops/` |
-| `checklists/*.md` | diretório | `squads/{squad}/checklists/` |
-| `workflows/*.yaml` | diretório | `squads/{squad}/workflows/` |
-| `blueprints/*.yaml` | diretório | `squads/{squad}/templates/` |
-#### Regras de Derivação
-```
-Framework → SOP (procedimento step-by-step)
-SOP → Checklist (validação sim/não)
-Checklist → Workflow (orquestração)
-Heuristic → Veto Condition (gate automático)
-```
-#### Checklist de Anti-Invention
-- [ ] Cada SOP referencia framework fonte
-- [ ] Cada checklist deriva de SOP específico
-- [ ] Zero conceitos novos não presentes no framework
-- [ ] Veto conditions baseadas em heurísticas do expert
-- [ ] Nenhum passo inventado "para completar"
-#### Veto Conditions (Self)
-| Trigger | Ação |
-|---------|------|
-| SOP contém conceito não no framework | LOOP - remover ou escalar para AN |
-| Checklist órfão (sem SOP) | LOOP - criar SOP ou remover |
-| Workflow com passo sem checklist | LOOP - derivar checklist |
----
-### Handoff #2: PV → Chief
-| Campo | Valor |
-|-------|-------|
-| **ID** | `handoff_pv_chief` |
-| **De** | @pedro-valerio |
-| **Para** | @squad-chief |
-| **Gate** | SOP_INTEGRITY_GATE |
-#### Veto Conditions
-| Trigger | Ação | Destino |
-|---------|------|---------|
-| SOP não referencia framework | REJECT | @pedro-valerio (inventou) |
-| Falta conhecimento para SOP | REJECT | @oalanicolas (extração incompleta) |
-| Paths inconsistentes | REJECT | Owner do path |
-| Artefatos incompletos | REJECT | Owner do artefato |
----
-### Step 4: Assembly (Fase 3)
-| Campo | Valor |
-|-------|-------|
-| **ID** | `assembly` |
-| **Agente** | @squad-chief |
-| **Ação** | Montar squad final |
-| **Requer** | `handoff_pv_chief` APPROVED |
-#### Inputs
-| Input | Tipo | Origem | Obrigatório |
-|-------|------|--------|-------------|
-| Knowledge artifacts | diretório | Fase 1 | Sim |
-| Operational artifacts | diretório | Fase 2 | Sim |
-#### Outputs
-| Output | Tipo | Destino |
-|--------|------|---------|
-| `agents/*.md` | diretório | `squads/{squad}/agents/` |
-| `config.yaml` | arquivo | `squads/{squad}/config.yaml` |
-| `README.md` | arquivo | `squads/{squad}/README.md` |
-#### Smoke Test Checklist
-- [ ] Agent carrega sem erro
-- [ ] Commands funcionam
-- [ ] Paths resolvem corretamente
-- [ ] Lazy-load de tasks funciona
-- [ ] Inter-agent routing funciona
----
-## Agentes Participantes
-### @squad-chief - Orquestrador
-| Aspecto | Descrição |
-|---------|-----------|
-| **Ícone** | 👑 |
-| **Papel** | Pipeline Orchestrator & Quality Gatekeeper |
-| **Foco** | Coordenar fases, validar handoffs, montar squad final |
-| **Responsabilidades** | Intake, routing, gate validation, assembly, smoke test |
-**Comandos Relevantes:**
-- `*create-squad` - Iniciar pipeline
-- `*validate-squad` - Validar squad
-- `*assemble-squad` - Montar squad final
----
-### @oalanicolas - Knowledge Architect
-| Aspecto | Descrição |
-|---------|-----------|
-| **Ícone** | 🧠 |
-| **Título** | Knowledge Architect |
-| **Papel** | Research + Extraction Specialist |
-| **Foco** | Extrair conhecimento autêntico com rastreabilidade |
-| **Responsabilidades** | Source curation, Voice DNA, Thinking DNA, Frameworks, Heuristics |
-**Escopo no Squad Creator:**
-- Research (buscar, classificar, curar sources)
-- Extraction (DNA, frameworks, heuristics, mental models)
-- Basic mind cloning (funcional para a task, não clone perfeito)
-**NÃO é:**
-- Full MMOS pipeline (8 layers completos)
-- Clone perfeito 97% fidelity
-- Validação extensiva com blind test
-**Comandos Relevantes:**
-- `*assess-sources` - Avaliar e classificar sources (ouro/bronze)
-- `*extract-framework` - Extrair framework + Voice + Thinking
-- `*find-80-20` - Identificar 20% que produz 80%
-- `*deconstruct` - Perguntas de desconstrução estilo entrevista
-- `*fidelity-score` - Calcular qualidade da extração
-- `*validate-extraction` - Gate antes do handoff
----
-### @pedro-valerio - Process Architect
-| Aspecto | Descrição |
-|---------|-----------|
-| **Ícone** | ⚙️ |
-| **Título** | Process Architect |
-| **Papel** | Operationalization Expert |
-| **Foco** | Transformar conhecimento em processos à prova de erro |
-| **Responsabilidades** | SOPs, Checklists, Workflows, Veto Conditions |
-**Comandos Relevantes:**
-- `*extract-sop` - Criar SOP do framework
-- `*extract-checklist` - Derivar checklist do SOP
-- `*generate-blueprint` - Gerar blueprint YAML
-- `*validate-invention` - Anti-invention audit
-- `*audit` - Auditar workflow completo
-- `*design-heuristic` - Criar decision heuristic
----
-## Tasks Executadas
-### Mapa de Tasks por Fase
-```mermaid
-graph TD
-    subgraph "Fase 0: Intake"
-        T0[squad-briefing.md]
-    end
-    subgraph "Fase 1: Knowledge"
-        T1a[assess-sources.md]
-        T1b[extract-framework.md]
-        T1c[find-80-20.md]
-        T1d[extraction-self-validation.md]
-    end
-    subgraph "Handoff #1"
-        H1[handoff-an-pv-gate.md]
-    end
-    subgraph "Fase 2: Operationalization"
-        T2a[extract-sop.md]
-        T2b[extract-checklist.md]
-        T2c[design-workflow.md]
-        T2d[validate-invention.md]
-    end
-    subgraph "Handoff #2"
-        H2[handoff-pv-chief-gate.md]
-    end
-    subgraph "Fase 3: Assembly"
-        T3a[create-agent-files.md]
-        T3b[setup-config.md]
-        T3c[smoke-test.md]
-    end
-    T0 --> T1a
-    T1a --> T1b
-    T1b --> T1c
-    T1c --> T1d
-    T1d --> H1
-    H1 --> T2a
-    T2a --> T2b
-    T2b --> T2c
-    T2c --> T2d
-    T2d --> H2
-    H2 --> T3a
-    T3a --> T3b
-    T3b --> T3c
-```
----
-## Pré-requisitos
-### Configuração do Projeto
-1. **squad-creator config** em `squads/squad-creator-pro/config.yaml`
-2. **Templates disponíveis:**
-   - `templates/agent-tmpl.md`
-   - `templates/config-tmpl.yaml`
-   - `templates/sop-tmpl.md`
-   - `templates/checklist-tmpl.md`
-### Documentação Prerequisita
-| Documento | Local | Obrigatório |
-|-----------|-------|-------------|
-| Expert sources | Variável | Sim |
-| Domain definition | Briefing | Sim |
-| Existing frameworks (se houver) | `squads/*/docs/frameworks/` | Não |
-### Ferramentas Integradas
-| Ferramenta | Propósito | Agentes |
-|------------|-----------|---------|
-| `WebSearch` | Descoberta de sources | @oalanicolas |
-| `WebFetch` | Coleta de conteúdo | @oalanicolas |
-| `Grep/Glob` | Análise de patterns | @oalanicolas |
-| `Write/Edit` | Criação de artefatos | Todos |
----
-## Entradas e Saídas
-### Entradas do Workflow
-| Entrada | Tipo | Fonte | Descrição |
-|---------|------|-------|-----------|
-| Expert name | string | User | Nome do expert a clonar |
-| Domain | string | User | Domínio de expertise |
-| Source hints | array | User | URLs/referências iniciais |
-| Agent count | number | User | Quantos agents criar |
-### Saídas do Workflow
-| Saída | Tipo | Destino | Descrição |
-|-------|------|---------|-----------|
-| Squad completo | diretório | `squads/{squad-name}/` | Squad pronto para uso |
-| DNA files | yaml | `data/minds/` | Conhecimento extraído |
-| SOPs | md | `sops/` | Procedimentos operacionais |
-| Checklists | md | `checklists/` | Validações derivadas |
-| Workflows | yaml | `workflows/` | Orquestrações |
----
-## Pontos de Decisão
-### Diagrama de Decisões
-```mermaid
-graph TD
-    D0{User Approval<br/>Escopo OK?}
-    D0 -->|Sim| CONTINUE0[Prosseguir para Knowledge]
-    D0 -->|Não| REFINE0[Refinar escopo]
-    D1{SOURCE_COVERAGE<br/>5+ páginas?}
-    D1 -->|Sim| CONTINUE1[Prosseguir para Extraction]
-    D1 -->|Não| RETURN1[Loop: buscar mais sources]
-    D2{Self-Validation AN<br/>15+ citações?}
-    D2 -->|Sim| CONTINUE2[Prosseguir para Handoff #1]
-    D2 -->|Não| RETURN2[Loop: mais extração]
-    D3{Handoff #1<br/>Framework com fonte?}
-    D3 -->|Sim| CONTINUE3[Aprovar para PV]
-    D3 -->|Não| RETURN3[Rejeitar para AN]
-    D4{Anti-Invention Check<br/>SOP ref. framework?}
-    D4 -->|Sim| CONTINUE4[Prosseguir para Handoff #2]
-    D4 -->|Não| RETURN4[Loop: remover invenção]
-    D5{Handoff #2<br/>Integração válida?}
-    D5 -->|Sim| CONTINUE5[Aprovar para Assembly]
-    D5 -->|Não| RETURN5[Rejeitar para owner]
-    D6{Smoke Test<br/>Squad funciona?}
-    D6 -->|Sim| DONE[Squad Complete]
-    D6 -->|Não| RETURN6[Debug e fix]
-```
-### Condições de Bloqueio (HALT)
-O workflow deve HALT quando:
-1. **Sources insuficientes** - Expert não tem material público suficiente
-2. **Extração impossível** - Conhecimento muito tácito para documentar
-3. **Invenção detectada** - PV criou conceitos não no framework
-4. **Loop infinito** - 3+ rejeições consecutivas no mesmo handoff
-5. **Conflito de versão** - Framework atualizado durante operacionalização
----
-## Loops de Rejeição
-```mermaid
-flowchart LR
-    subgraph KNOWLEDGE_LOOP["Loop de Knowledge"]
-        AN_RESEARCH[AN research] --> SOURCE_GATE{Source coverage?}
-        SOURCE_GATE -->|FAIL| AN_RESEARCH
-        SOURCE_GATE -->|PASS| AN_EXTRACT[AN extraction]
-        AN_EXTRACT --> AN_SELF{Self-validation?}
-        AN_SELF -->|FAIL| AN_EXTRACT
-        AN_SELF -->|PASS| H1_GATE{Handoff #1?}
-        H1_GATE -->|REJECT| AN_EXTRACT
-    end
-    subgraph OPERATIONALIZATION_LOOP["Loop de Operacionalização"]
-        H1_GATE -->|APPROVE| PV_WORK[PV trabalha]
-        PV_WORK --> PV_SELF{Anti-invention?}
-        PV_SELF -->|FAIL| PV_WORK
-        PV_SELF -->|PASS| H2_GATE{Handoff #2?}
-        H2_GATE -->|REJECT: invenção| PV_WORK
-        H2_GATE -->|REJECT: falta conhecimento| AN_EXTRACT
-    end
-    subgraph ASSEMBLY_LOOP["Loop de Assembly"]
-        H2_GATE -->|APPROVE| CHIEF_WORK[Chief monta]
-        CHIEF_WORK --> SMOKE{Smoke test?}
-        SMOKE -->|FAIL| CHIEF_WORK
-        SMOKE -->|PASS| DONE[✅ Done]
-    end
-    style KNOWLEDGE_LOOP fill:#e8f5e9
-    style OPERATIONALIZATION_LOOP fill:#f3e5f5
-    style ASSEMBLY_LOOP fill:#e0f7fa
-```
----
-## Troubleshooting
-### Problemas Comuns
-#### 1. Sources insuficientes
-**Sintoma:** AN não consegue passar SOURCE_COVERAGE
-**Causas:**
-- Expert pouco documentado publicamente
-- Sources muito genéricas (bronze)
-- Transcrições de baixa qualidade
-**Solução:**
-1. Procurar podcasts longos (2h+)
-2. Buscar entrevistas em profundidade
-3. Verificar se expert tem livros/artigos
-4. Considerar HALT se expert muito tácito
-#### 2. Extração fica em loop
-**Sintoma:** AN não consegue 15 citações
-**Causas:**
-- Sources insuficientes (voltar para research)
-- Expert muito tácito
-- Foco muito amplo
-**Solução:**
-1. Restringir escopo do domain
-2. Usar entrevistas longas (podcasts 2h+)
-3. Procurar livros/artigos do expert
-#### 3. Handoff #1 rejeita repetidamente
-**Sintoma:** Framework volta para AN várias vezes
-**Causas:**
-- Framework muito genérico
-- Falta signature phrases reais
-- Heurísticas sem contexto
-**Solução:**
-1. Revisar checklist de self-validation
-2. Adicionar mais citações diretas
-3. Especificar contexto de aplicação
-#### 4. PV detecta que precisa de mais conhecimento
-**Sintoma:** SOP não pode ser criado sem informação faltante
-**Causas:**
-- Framework incompleto
-- Gap de conhecimento não detectado em Handoff #1
-**Solução:**
-1. Escalar para AN com request específico
-2. AN extrai conhecimento adicional
-3. Resubmeter para PV
-#### 5. Smoke test falha
-**Sintoma:** Agent não carrega ou commands não funcionam
-**Causas:**
-- Path inconsistente
-- YAML malformado
-- Referência circular
-**Solução:**
-1. Validar YAML syntax
-2. Verificar paths com `ls -la`
-3. Testar comando isolado
----
-## Métricas de Qualidade
-### Knowledge Quality Score
-| Métrica | Peso | Threshold |
-|---------|------|-----------|
-| Citações diretas | 30% | ≥ 15 |
-| Signature phrases | 20% | ≥ 5 |
-| Frameworks documentados | 20% | ≥ 1 |
-| Source diversity | 15% | ≥ 2 tipos |
-| Rastreabilidade | 15% | 100% |
-### Operationalization Quality Score
-| Métrica | Peso | Threshold |
-|---------|------|-----------|
-| SOP-Framework linkage | 30% | 100% |
-| Checklist coverage | 25% | 100% |
-| Veto conditions | 20% | ≥ 1 por SOP |
-| Zero invention | 25% | 100% |
----
-## Tabela de Handoffs
-| # | De → Para | Trigger | Artefato | Veto Condition |
-|---|-----------|---------|----------|----------------|
-| 0 | User → Chief | Request | Briefing | — |
-| 0.5 | Chief → User | Briefing pronto | Aprovação escopo | User não aprova |
-| 1 | Chief → AN | Escopo aprovado | Sources + extraction | — |
-| 1.5 | AN interno | Sources coletadas | SOURCE_COVERAGE | Sources insuficientes |
-| 2 | AN → PV | Framework completo | Knowledge artifacts | Sem citações, inventou |
-| 3 | PV → Chief | SOPs completos | Operational artifacts | SOP não ref. framework |
-| 4 | Chief → Output | Smoke test PASS | Squad completo | Paths quebrados |
----
-## Referências
-### Arquivos Relacionados
-| Arquivo | Caminho |
-|---------|---------|
-| Squad Chief Agent | `squads/squad-creator-pro/agents/squad-chief.md` |
-| Oalanicolas Agent | `squads/squad-creator-pro/agents/oalanicolas.md` |
-| Pedro Valerio Agent | `squads/squad-creator-pro/agents/pedro-valerio.md` |
-| Extraction Tasks | `squads/squad-creator-pro/tasks/extract-*.md` |
-| Validation Checklists | `squads/squad-creator-pro/checklists/` |
-### Documentação Adicional
-- [CONCEPTS.md](../../squads/squad-creator-pro/docs/CONCEPTS.md) - Conceitos fundamentais
-- [ARCHITECTURE-DIAGRAMS.md](../../squads/squad-creator-pro/docs/ARCHITECTURE-DIAGRAMS.md) - Diagramas de arquitetura
-- [deep-research-quality.md](../../squads/squad-creator-pro/checklists/deep-research-quality.md) - Checklist de research
----
-## Changelog
-| Versão | Data | Mudanças |
-|--------|------|----------|
-| 1.0 | 2026-02-10 | Versão inicial com separação AN/PV |
-| 2.0 | 2026-02-10 | Removido Tim Ferriss, AN absorve research+extraction, títulos atualizados |
----
-*Documentação criada por @oalanicolas (Knowledge Architect) + @pedro-valerio (Process Architect)*
-*"Curadoria > Volume" — @oalanicolas*
-*"A melhor coisa é impossibilitar caminhos" — @pedro-valerio*