aiox-core 5.0.2 → 5.0.3

package/pro/squads/squad-creator-pro/minds/oalanicolas/artifacts/HANDOFF_PROTOCOL.md

@@ -0,0 +1,269 @@
+# HANDOFF_PROTOCOL - Self-Validation Checklist
+
+**Type:** Quality Gate Artifact
+**Agent:** @oalanicolas
+**Purpose:** Validação obrigatória antes de handoff para @pedro-valerio
+
+## Core Principle
+
+> "Se não passar no checklist, LOOP. Não handoff."
+> — Alan Nicolas
+
+PV não pode operacionalizar inferências. Só entrega insumos verificáveis.
+
+---
+
+## Pre-Handoff Checklist
+
+### 1. Citation Coverage
+
+```yaml
+checkpoint: "citation_coverage"
+requirement: "15+ citações com [SOURCE:]"
+format: "[SOURCE: livro/página ou vídeo/minuto]"
+
+validation:
+  count_citations: "grep -c '\\[SOURCE:' extraction.md"
+  threshold: ">= 15"
+
+  if_fail:
+    action: "LOOP - extract more citations"
+    focus: "Buscar mais fontes ouro, extrair citações específicas"
+
+examples:
+  valid:
+    - "[SOURCE: $100M Offers, p.47]"
+    - "[SOURCE: Lex Fridman #234, 1:23:45]"
+    - "[SOURCE: Instagram comment, 2024-01-15]"
+
+  invalid:
+    - "Hormozi sempre diz isso" # No source
+    - "[SOURCE: internet]" # Too vague
+    - "Based on his philosophy" # Inference
+```
+
+### 2. Signature Phrases
+
+```yaml
+checkpoint: "signature_phrases"
+requirement: "5+ signature phrases verificáveis"
+
+validation:
+  criteria:
+    - "Phrase is unique to this expert"
+    - "Phrase appears in multiple sources (triangulated)"
+    - "Phrase has [SOURCE:] reference"
+  threshold: ">= 5 verified phrases"
+
+  if_fail:
+    action: "LOOP - mine more signature phrases"
+    technique: "Search for repeated expressions across sources"
+
+examples:
+  valid:
+    - "Se entrar cocô, sai cocô" [SOURCE: DNA Mental, aula 3]
+    - "Value Equation" [SOURCE: $100M Offers, p.23]
+    - "Speed to lead" [SOURCE: $100M Leads, p.156]
+
+  invalid:
+    - "Work hard" # Generic, not signature
+    - "Be authentic" # Everyone says this
+```
+
+### 3. Trinity Completeness
+
+```yaml
+checkpoint: "trinity_complete"
+requirement: "Playbook + Framework + Swipe File"
+
+validation:
+  components:
+    playbook:
+      check: "Has sequential steps"
+      verify: "Each step has [SOURCE:]"
+    framework:
+      check: "Has SE/ENTÃO rules"
+      verify: "Decision logic documented"
+    swipe:
+      check: "Has real examples"
+      verify: "Examples from expert, not generic"
+
+  if_fail:
+    action: "LOOP - complete missing component"
+    priority: "Framework > Swipe > Playbook (usually)"
+
+diagnostic_questions:
+  - "O clone sabe O QUE fazer? (Playbook)"
+  - "O clone sabe QUANDO/COMO decidir? (Framework)"
+  - "O clone tem referência de QUALIDADE? (Swipe)"
+```
+
+### 4. Zero Unvalidated Inferences
+
+```yaml
+checkpoint: "no_unvalidated_inferences"
+requirement: "Zero conceitos [INFERRED] sem tentativa de validação"
+
+validation:
+  search: "grep '\\[INFERRED\\]' extraction.md"
+
+  for_each_inferred:
+    required: "Validation attempt documented"
+    format: "[INFERRED] concept - validation: searched X, Y, Z"
+
+  if_fail:
+    action: "LOOP - validate or remove inferences"
+    options:
+      - "Find source → convert to [SOURCE:]"
+      - "Document validation attempt → keep [INFERRED]"
+      - "Remove if cannot validate"
+
+examples:
+  valid:
+    - "[INFERRED] Likely uses 80/20 for hiring - validation: searched 3 podcasts, no direct mention, but consistent with other frameworks"
+
+  invalid:
+    - "[INFERRED] Probably thinks X" # No validation attempt
+    - "He probably..." # Not even marked
+```
+
+### 5. Pareto ao Cubo Applied
+
+```yaml
+checkpoint: "pareto_applied"
+requirement: "4 zonas classificadas com [SOURCE:]"
+
+validation:
+  zones_documented:
+    - "0,8% (Genialidade) - items listed"
+    - "4% (Excelência) - items listed"
+    - "20% (Impacto) - items listed"
+    - "80% (Eliminar) - items listed"
+
+  each_zone:
+    required: "At least 1 item with [SOURCE:]"
+
+  if_fail:
+    action: "LOOP - apply AN_KE_003"
+    task: "tasks/find-0.8.md"
+```
+
+---
+
+## Checklist Summary
+
+```yaml
+handoff_checklist:
+  - id: "CHK-01"
+    name: "Citation Coverage"
+    threshold: ">= 15 citations"
+    blocking: true
+
+  - id: "CHK-02"
+    name: "Signature Phrases"
+    threshold: ">= 5 verified"
+    blocking: true
+
+  - id: "CHK-03"
+    name: "Trinity Complete"
+    threshold: "3/3 components"
+    blocking: true
+
+  - id: "CHK-04"
+    name: "No Unvalidated Inferences"
+    threshold: "0 unmarked"
+    blocking: true
+
+  - id: "CHK-05"
+    name: "Pareto Applied"
+    threshold: "4 zones documented"
+    blocking: false  # Can proceed with warning
+```
+
+---
+
+## Handoff Format: INSUMOS_READY
+
+When all checks pass, format handoff as:
+
+```yaml
+handoff_to: "@pedro-valerio"
+status: "INSUMOS_READY"
+timestamp: "YYYY-MM-DD HH:MM"
+
+summary:
+  expert: "Expert Name"
+  sources_count: "X ouro, Y bronze"
+  ouro_ratio: "X%"
+  citations_count: "X"
+  signature_phrases_count: "X"
+  trinity_status: "complete"
+
+checklist_results:
+  CHK-01: "PASS - 18 citations"
+  CHK-02: "PASS - 7 phrases"
+  CHK-03: "PASS - 3/3 components"
+  CHK-04: "PASS - 0 unvalidated"
+  CHK-05: "PASS - 4 zones documented"
+
+deliverables:
+  voice_dna: "path/to/voice-dna.md"
+  thinking_dna: "path/to/thinking-dna.md"
+  frameworks: "path/to/frameworks.md"
+  heuristics: "path/to/heuristics.md"
+  source_map: "path/to/source-map.yaml"
+
+notes_for_pv:
+  - "Insight X precisa de validação extra"
+  - "Framework Y tem variação em contexto Z"
+```
+
+---
+
+## Veto Conditions
+
+| Condition | Veto Code | Action |
+|-----------|-----------|--------|
+| citations < 15 | AN_VC_004 | LOOP - extract more |
+| phrases < 5 | AN_VC_004 | LOOP - mine more |
+| trinity incomplete | AN_VC_002 | LOOP - complete component |
+| unvalidated inferences | AN_VC_004 | LOOP - validate or remove |
+| handoff without checklist | AN_VC_005 | HARD VETO |
+
+---
+
+## Anti-Patterns
+
+### "Good Enough" Trap
+
+```yaml
+anti_pattern: "Handoff com 12 citations 'porque já tá bom'"
+symptom: "PV recebe insumos fracos, clone fica genérico"
+prevention: "Threshold é 15, não 'cerca de 15'"
+rule: "Se não passou, não passou. LOOP."
+```
+
+### "I'll Fix Later" Trap
+
+```yaml
+anti_pattern: "Marcar [INFERRED] e deixar pra lá"
+symptom: "Clone fala coisas que expert nunca disse"
+prevention: "Every [INFERRED] needs validation attempt"
+rule: "Unvalidated inference = potential hallucination"
+```
+
+### "Volume Compensation" Trap
+
+```yaml
+anti_pattern: "Entregar 50 citations bronze ao invés de 15 ouro"
+symptom: "Muito conteúdo, pouca profundidade"
+prevention: "Quality > quantity, sempre"
+rule: "15 ouro > 50 bronze"
+```
+
+---
+
+**Pattern Compliance:** Quality Gate Pattern
+**Veto Mapping:** AN_VC_005 (Handoff Without Validation)
+**Integration:** Final step of AN_KE_001 pipeline
+**Handoff Target:** @pedro-valerio (INSUMOS_READY format)

package/pro/squads/squad-creator-pro/minds/oalanicolas/artifacts/SOURCE_CLASSIFICATION.md

@@ -0,0 +1,258 @@
+# SOURCE_CLASSIFICATION - Ouro vs Bronze
+
+**Type:** Classification Artifact
+**Agent:** @oalanicolas
+**Purpose:** Critérios para classificar fontes de conhecimento
+
+## Core Principle
+
+> "Se entrar cocô, sai cocô do outro lado."
+> — Alan Nicolas
+
+Menos material ouro > muito material bronze.
+
+---
+
+## Classification Tiers
+
+### 🥇 OURO (Tier 1) - Autenticidade Máxima
+
+Fontes onde o expert fala sem filtro, responde perguntas reais, revela pensamento genuíno.
+
+```yaml
+ouro_sources:
+  tier_1a_pure_gold:
+    - type: "Comentários em posts"
+      why: "Respostas espontâneas, sem edição"
+      signal: "Expert respondendo dúvidas específicas"
+      example: "Comentário no YouTube explicando decisão"
+
+    - type: "Entrevistas longas (2h+)"
+      why: "Profundidade, repetição revela padrões"
+      signal: "Mesma história contada de formas diferentes"
+      example: "Lex Fridman, Joe Rogan, podcasts de 3h"
+
+    - type: "Stories/lives espontâneos"
+      why: "Sem preparação, autêntico"
+      signal: "Bastidores, decisões em tempo real"
+      example: "Instagram stories explicando o dia"
+
+  tier_1b_high_quality:
+    - type: "Livros próprios"
+      why: "Pensamento estruturado, revisado"
+      signal: "Frameworks completos, citações verificáveis"
+      caution: "Pode ser ghostwritten, verificar voz"
+
+    - type: "Podcast próprio"
+      why: "Controle editorial, temas escolhidos"
+      signal: "Repetição de princípios core"
+      example: "The Game w/ Alex Hormozi"
+
+    - type: "Cases documentados"
+      why: "Prova de resultados, não teoria"
+      signal: "Números, antes/depois, contexto"
+      example: "Portfolio company transformations"
+
+extraction_priority: "1a > 1b sempre"
+minimum_ratio: "60% ouro no total de fontes"
+```
+
+### 🥉 BRONZE (Tier 2) - Usar com Cautela
+
+Fontes editadas, genéricas, ou de contexto limitado.
+
+```yaml
+bronze_sources:
+  tier_2a_acceptable:
+    - type: "Palestras em eventos"
+      why: "Preparado, audience genérica"
+      signal: "Mesmas histórias, menos profundidade"
+      use_when: "Não tem ouro suficiente"
+
+    - type: "Entrevistas curtas (<30min)"
+      why: "Superficial, talking points"
+      signal: "Respostas ensaiadas"
+      caution: "Não revela decision-making"
+
+    - type: "Posts de blog/LinkedIn"
+      why: "Editado, otimizado para engagement"
+      signal: "Pode ter ghostwriter"
+      use_for: "Signature phrases, não frameworks"
+
+  tier_2b_low_quality:
+    - type: "Conteúdo antigo (5+ anos)"
+      why: "Pessoa mudou, contexto diferente"
+      signal: "Contradiz posições atuais"
+      action: "Marcar [OUTDATED] se usar"
+
+    - type: "Terceiros falando sobre expert"
+      why: "Interpretação, não fonte primária"
+      signal: "Telephone game effect"
+      action: "NUNCA usar como fonte única"
+
+    - type: "Clips sem contexto"
+      why: "Cherry-picked, pode distorcer"
+      signal: "Viral mas incompleto"
+      action: "Buscar fonte original"
+
+maximum_ratio: "40% bronze no total"
+veto_trigger: "> 50% bronze = VETO"
+```
+
+### ⛔ ELIMINAR (Tier 3) - Não Usar
+
+```yaml
+eliminate_sources:
+  - type: "Conteúdo de fãs/admiradores"
+    reason: "Fanfic, não realidade"
+
+  - type: "Resumos de terceiros"
+    reason: "Interpretação da interpretação"
+
+  - type: "IA-generated sobre expert"
+    reason: "Circularidade, sem source real"
+
+  - type: "Gossip/especulação"
+    reason: "Sem verificação possível"
+
+action: "DELETE do pipeline, não marcar bronze"
+```
+
+---
+
+## Classification Process
+
+### Step 1: Inventory
+
+```yaml
+inventory_template:
+  source_name: ""
+  source_type: ""
+  date: ""
+  duration_length: ""
+  url_reference: ""
+  initial_tier: "ouro | bronze | eliminate"
+  classification_reason: ""
+```
+
+### Step 2: Scoring
+
+| Criterion | Weight | Ouro Threshold | Bronze Threshold |
+|-----------|--------|----------------|------------------|
+| Spontaneity | 0.9 | Unscripted | Scripted |
+| Depth | 0.8 | 2h+ or detailed | < 30min or surface |
+| Specificity | 0.8 | Answers real questions | Generic advice |
+| Recency | 0.6 | < 3 years | 3-5 years |
+| Primary source | 1.0 | Expert directly | Third party |
+
+### Step 3: Ratio Check
+
+```yaml
+ratio_validation:
+  calculate: "ouro_count / total_count"
+
+  thresholds:
+    green: ">= 0.7"   # Proceed confidently
+    yellow: "0.6-0.7" # Proceed with caution
+    red: "< 0.6"      # VETO - curate more
+
+  action_on_red:
+    - "Search for more ouro sources"
+    - "OR eliminate bronze sources"
+    - "OR scope down extraction"
+```
+
+---
+
+## Quality Signals
+
+### Ouro Signals (Look For)
+
+```yaml
+positive_signals:
+  - "Expert corrigindo mal-entendido"
+  - "Contradição explicada (mostra nuance)"
+  - "Bastidores de decisão"
+  - "Admissão de erro"
+  - "Resposta a crítica"
+  - "Explicação do 'porquê' não só 'o quê'"
+  - "Mesma história com detalhes diferentes (triangulação)"
+```
+
+### Bronze Signals (Watch Out)
+
+```yaml
+warning_signals:
+  - "Parece muito polished"
+  - "Mesma história sempre igual"
+  - "Só highlights, nunca failures"
+  - "Muito genérico, aplicável a qualquer um"
+  - "Otimizado para viralizar"
+  - "Não responde perguntas diretas"
+```
+
+---
+
+## Veto Conditions
+
+| Condition | Action | Recovery |
+|-----------|--------|----------|
+| ouro_ratio < 0.6 | VETO | Curate more ouro sources |
+| zero ouro sources | HARD VETO | Cannot proceed |
+| > 50% tier 2b | VETO | Eliminate low quality |
+| any tier 3 in final set | VETO | Remove immediately |
+
+---
+
+## Examples
+
+### Good Classification
+
+```yaml
+project: "Hormozi Clone"
+status: "APPROVED"
+
+sources:
+  ouro:
+    - "Lex Fridman interview (3h)"
+    - "MFCEO Project interview (2h)"
+    - "Instagram comments (47 responses)"
+    - "$100M Offers book"
+    - "$100M Leads book"
+    count: 5
+
+  bronze:
+    - "Grant Cardone interview (20min)"
+    - "Conference keynote 2022"
+    count: 2
+
+ratio: "5/7 = 71%" # GREEN
+```
+
+### Bad Classification
+
+```yaml
+project: "Generic Business Clone"
+status: "VETO"
+
+sources:
+  ouro:
+    - "One podcast episode (45min)"
+    count: 1
+
+  bronze:
+    - "10 LinkedIn posts"
+    - "5 YouTube shorts"
+    - "2 conference talks"
+    - "1 blog post by fan"
+    count: 18
+
+ratio: "1/19 = 5%" # HARD RED
+reason: "Volume without curation - will produce generic clone"
+```
+
+---
+
+**Pattern Compliance:** Source Classification Standard
+**Veto Mapping:** AN_VC_001, AN_VC_003
+**Integration:** Step 1 of AN_KE_001 pipeline

package/pro/squads/squad-creator-pro/minds/oalanicolas/heuristics/AN_KE_001.md

@@ -0,0 +1,166 @@
+# AN_KE_001 - Knowledge Extraction Architecture
+
+**Type:** Primary Framework
+**Phase:** 3 (DNA Extraction)
+**Agent:** @oalanicolas
+**Pattern:** Extraction Pipeline
+
+## Purpose
+
+Framework principal para extração de conhecimento com rastreabilidade total. Define o pipeline completo desde descoberta de fontes até validação final antes do handoff.
+
+## Configuration
+
+```yaml
+AN_KE_001:
+  name: "Knowledge Extraction Architecture"
+  phase: 3
+  agent: "@oalanicolas"
+
+  pipeline:
+    - step: 1
+      name: "Source Discovery & Classification"
+      action: "Identificar e classificar fontes (ouro/bronze)"
+      veto_check: "AN_VC_001, AN_VC_003"
+    - step: 2
+      name: "Pareto ao Cubo"
+      action: "Classificar em 4 zonas (0,8%, 4%, 20%, 80%)"
+      heuristic: "AN_KE_003"
+    - step: 3
+      name: "Deconstruction"
+      action: "Perguntas que revelam frameworks ocultos"
+      task_file: "tasks/deconstruct.md"
+    - step: 4
+      name: "DNA Extraction"
+      action: "Extrair Voice + Thinking DNA"
+      veto_check: "AN_VC_002, AN_VC_004"
+    - step: 5
+      name: "Self-Validation"
+      action: "Checklist antes do handoff"
+      veto_check: "AN_VC_005"
+
+  weights:
+    source_quality: 0.9
+    citation_coverage: 0.8
+    trinity_completeness: 0.7
+
+  thresholds:
+    citations_minimum: 15
+    signature_phrases_minimum: 5
+    ouro_ratio_minimum: 0.6
+
+  veto_conditions:
+    - condition: "citations < 15"
+      action: "VETO - Insufficient citations"
+      maps_to: "AN_VC_004"
+    - condition: "ouro_ratio < 0.6"
+      action: "VETO - Too much bronze"
+      maps_to: "AN_VC_003"
+    - condition: "trinity_incomplete"
+      action: "VETO - Missing Playbook, Framework, or Swipe"
+      maps_to: "AN_VC_002"
+
+  output:
+    type: "decision"
+    values: ["APPROVE", "REVIEW", "VETO"]
+    handoff_to: "@pedro-valerio"
+    handoff_format: "INSUMOS_READY"
+```
+
+## Decision Tree
+
+```
+IF (source_quality >= 0.6 AND citations >= 15 AND trinity_complete)
+  THEN APPROVE → Proceed to handoff
+
+ELSE IF (source_quality >= 0.6 AND citations < 15)
+  THEN REVIEW → Extract more citations
+
+ELSE IF (source_quality < 0.6)
+  THEN VETO → Return to source curation
+
+TERMINATION: Handoff approved with INSUMOS_READY format
+FALLBACK: LOOP back to weakest step until all criteria pass
+```
+
+## Evaluation Criteria
+
+| Criterion | Weight | Threshold | Description |
+|-----------|--------|-----------|-------------|
+| Source quality (ouro ratio) | 0.9 | >= 0.6 | Fontes ouro / total fontes |
+| Citation coverage | 0.8 | >= 15 | Citações com [SOURCE:] |
+| Trinity completeness | 0.7 | 3/3 | Playbook + Framework + Swipe |
+| Signature phrases | 0.6 | >= 5 | Frases verificáveis do expert |
+
+## Validation Questions
+
+1. "As fontes são majoritariamente ouro (comentários, entrevistas, stories)?"
+2. "Existem 15+ citações com [SOURCE: página/minuto]?"
+3. "A Trindade está completa (Playbook + Framework + Swipe)?"
+4. "Zero conceitos marcados como [INFERRED] sem validação?"
+5. "Pareto ao Cubo foi aplicado (4 zonas classificadas)?"
+
+## Performance Metrics
+
+```yaml
+performance:
+  decision_speed: "1-2 hours per extraction iteration"
+  accuracy_rate: "90% (when following pipeline strictly)"
+  confidence_level: "85% (requires self-validation pass)"
+  quality_correlation: "Direct - better sources = better clone"
+```
+
+## Failure Modes
+
+### Volume Over Curation
+- **Trigger:** Pressão por entregas rápidas, muitas fontes disponíveis
+- **Manifestation:** 30h de áudio sem classificação = clone genérico
+- **Detection:** Clone responses são genéricas, sem signature phrases
+- **Recovery:** Voltar para Step 1, aplicar classificação ouro/bronze
+- **Prevention:** Veto condition AN_VC_001 bloqueia volume sem curadoria
+
+### Inference Without Source
+- **Trigger:** Conceito parece óbvio, "todo mundo sabe"
+- **Manifestation:** Clone fala coisas que expert nunca disse
+- **Detection:** Buscar citação, não encontrar [SOURCE:]
+- **Recovery:** Marcar [INFERRED] ou encontrar fonte real
+- **Prevention:** Veto condition AN_VC_004 bloqueia conceitos sem fonte
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "dna-extraction-complete"
+  heuristic: AN_KE_001
+  phase: 3
+
+  criteria:
+    - metric: "ouro_ratio"
+      threshold: 0.6
+      operator: ">="
+    - metric: "citations_count"
+      threshold: 15
+      operator: ">="
+    - metric: "trinity_components"
+      threshold: 3
+      operator: "=="
+
+  veto_conditions:
+    - condition: "self_validation_failed"
+      action: "HALT - Loop back to weakest step"
+
+  validation_questions:
+    - "Source classification complete?"
+    - "Pareto ao Cubo applied?"
+    - "Trinity complete?"
+    - "Self-validation passed?"
+
+  pass_action: "Handoff to @pedro-valerio with INSUMOS_READY"
+  fail_action: "Loop back with feedback on failing criteria"
+```
+
+---
+
+**Pattern Compliance:** Extraction Pipeline with Quality Gates
+**Source:** AN Mind Artifacts - Knowledge Extraction Framework
+**Handoff:** @pedro-valerio (INSUMOS_READY format)