aiox-core 5.0.4 → 5.0.5

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

@@ -1,234 +0,0 @@
-# AN_KE_009 - Meta Decision Flow
-
-**Type:** Master Decision Framework
-**Phase:** Any (Decision Points)
-**Agent:** @oalanicolas
-**Pattern:** 10-Step Decision Flow
-**Source:** CLAUDE.md - META-SYNTHESIS
-
-## Purpose
-
-Framework master para qualquer decisão. Sequência de 10 passos que garante decisões sólidas.
-
-## Core Principle
-
-> "VERIFY → REUSE → PRECISE → SIMPLIFY → PRESERVE → FOCUS → SILENCE → CONSISTENT → VALIDATE → CHOOSE"
-> — CLAUDE.md META-SYNTHESIS
-
-## The 10 Steps
-
-```yaml
-meta_flow:
-  1_verify:
-    name: "VERIFY"
-    principle: "Verify before assuming"
-    question: "Confirmei fisicamente?"
-    anti_pattern: "Assumir sem checar"
-    maps_to: "AN_KE_006"
-
-  2_reuse:
-    name: "REUSE"
-    principle: "Reuse before creating"
-    question: "Algo similar já existe?"
-    anti_pattern: "Criar do zero"
-    maps_to: "AN_KE_007"
-
-  3_precise:
-    name: "PRECISE"
-    principle: "Be precise, not vague"
-    question: "Estou sendo específico?"
-    anti_pattern: "Generalizar demais"
-
-  4_simplify:
-    name: "SIMPLIFY"
-    principle: "Simplify before complicating"
-    question: "Pode ser mais simples?"
-    anti_pattern: "Over-engineering"
-
-  5_preserve:
-    name: "PRESERVE"
-    principle: "Preserve what works"
-    question: "Estou quebrando algo que funcionava?"
-    anti_pattern: "Mudar o que funciona"
-
-  6_focus:
-    name: "FOCUS"
-    principle: "Focus on what was asked"
-    question: "Estou no escopo pedido?"
-    anti_pattern: "Scope creep"
-
-  7_silence:
-    name: "SILENCE"
-    principle: "When wrong, fix in silence"
-    question: "Se errei, só corrigir?"
-    anti_pattern: "Justificar erro"
-
-  8_consistent:
-    name: "CONSISTENT"
-    principle: "Be consistent with patterns"
-    question: "Segue o padrão existente?"
-    anti_pattern: "Inventar novo padrão"
-
-  9_validate:
-    name: "VALIDATE"
-    principle: "Validate before finalizing"
-    question: "Testei antes de entregar?"
-    anti_pattern: "Entregar sem testar"
-
-  10_choose:
-    name: "CHOOSE"
-    principle: "Choose and commit"
-    question: "Decidi com evidência?"
-    anti_pattern: "Ficar em cima do muro"
-```
-
-## Configuration
-
-```yaml
-AN_KE_009:
-  name: "Meta Decision Flow"
-  phase: "any"
-  agent: "@oalanicolas"
-
-  application:
-    when: "Any significant decision"
-    how: "Run through 10 steps mentally"
-    output: "Decision with confidence"
-
-  shortcuts:
-    quick_decisions: "Steps 1, 2, 6, 10"
-    code_decisions: "Steps 1, 2, 4, 5, 8, 9"
-    creation_decisions: "Steps 1, 2, 3, 4, 8, 9, 10"
-    debugging: "Steps 1, 5, 7, 9"
-
-  veto_conditions:
-    - condition: "skip_verify"
-      action: "VETO - Verify first"
-    - condition: "skip_reuse_check"
-      action: "VETO - Check existing first"
-    - condition: "skip_validation"
-      action: "VETO - Test before delivering"
-```
-
-## Decision Tree
-
-```
-FOR each decision:
-
-┌─────────────────────────────────────────────────────────┐
-│ 1. VERIFY     → Did I check physically?                 │
-│                 IF NO → Check now                       │
-├─────────────────────────────────────────────────────────┤
-│ 2. REUSE      → Does something similar exist?           │
-│                 IF YES → Use it                         │
-├─────────────────────────────────────────────────────────┤
-│ 3. PRECISE    → Am I being specific enough?             │
-│                 IF NO → Clarify                         │
-├─────────────────────────────────────────────────────────┤
-│ 4. SIMPLIFY   → Can this be simpler?                    │
-│                 IF YES → Simplify                       │
-├─────────────────────────────────────────────────────────┤
-│ 5. PRESERVE   → Am I breaking something that works?     │
-│                 IF YES → Reconsider                     │
-├─────────────────────────────────────────────────────────┤
-│ 6. FOCUS      → Am I in scope?                          │
-│                 IF NO → Return to scope                 │
-├─────────────────────────────────────────────────────────┤
-│ 7. SILENCE    → If wrong, just fix?                     │
-│                 IF TEMPTED TO JUSTIFY → Just fix        │
-├─────────────────────────────────────────────────────────┤
-│ 8. CONSISTENT → Does this follow existing patterns?     │
-│                 IF NO → Align with patterns             │
-├─────────────────────────────────────────────────────────┤
-│ 9. VALIDATE   → Did I test this?                        │
-│                 IF NO → Test now                        │
-├─────────────────────────────────────────────────────────┤
-│ 10. CHOOSE    → Ready to commit?                        │
-│                  IF YES → Commit with confidence        │
-└─────────────────────────────────────────────────────────┘
-```
-
-## Quick Reference Cards
-
-### For Code Changes
-```
-VERIFY (1) → Does file exist?
-REUSE (2) → Component exists?
-SIMPLIFY (4) → Can be simpler?
-PRESERVE (5) → Breaking anything?
-CONSISTENT (8) → Follows patterns?
-VALIDATE (9) → Tests pass?
-```
-
-### For Creating New Things
-```
-VERIFY (1) → Requirements clear?
-REUSE (2) → Similar exists?
-PRECISE (3) → Scope defined?
-SIMPLIFY (4) → Minimal viable?
-CONSISTENT (8) → Follows standards?
-VALIDATE (9) → Works as expected?
-CHOOSE (10) → Ready to ship?
-```
-
-### For Debugging
-```
-VERIFY (1) → Physical state correct?
-PRESERVE (5) → What changed?
-SILENCE (7) → Found issue? Fix quietly
-VALIDATE (9) → Fix works?
-```
-
-### For Feedback/Criticism
-```
-SILENCE (7) → Don't justify, just fix
-VALIDATE (9) → Fix verified?
-```
-
-## Anti-Patterns
-
-```yaml
-anti_patterns:
-  - name: "Skip Steps"
-    symptom: "Pular direto pro CHOOSE"
-    cost: "Decisão mal fundamentada"
-    fix: "At minimum: VERIFY, REUSE, VALIDATE, CHOOSE"
-
-  - name: "Justify Instead of Fix"
-    symptom: "Explicar por que errou"
-    cost: "User frustration"
-    fix: "SILENCE - just fix"
-
-  - name: "Complicate First"
-    symptom: "Solução complexa antes de tentar simples"
-    cost: "Over-engineering"
-    fix: "SIMPLIFY - try simple first"
-
-  - name: "Create Before Check"
-    symptom: "Criar sem verificar se existe"
-    cost: "Duplicação"
-    fix: "REUSE - always check first"
-```
-
-## Validation Questions
-
-1. "Passei pelos 10 steps?"
-2. "Ou pelo menos pelos essenciais pro contexto?"
-3. "Decisão tem fundamento?"
-4. "Posso explicar por que decidi assim?"
-
-## Performance Metrics
-
-```yaml
-performance:
-  decision_quality: "~90% when following flow"
-  rework_reduction: "~60%"
-  user_alignment: "High (decisions match expectations)"
-  confidence: "High (evidence-based)"
-```
-
----
-
-**Pattern Compliance:** 10-Step Meta Flow
-**Veto Mapping:** Various (mapped per step)
-**Integration:** All decision points across all phases

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

@@ -1,240 +0,0 @@
-# AN_KE_010 - Context Death Test
-
-**Type:** Validation Heuristic
-**Phase:** 5 (Self-Validation)
-**Agent:** @oalanicolas
-**Pattern:** Documentation Quality Gate
-
-## Purpose
-
-Validar se documento/plano/spec é self-contained o suficiente para sobreviver à morte do contexto. Conhecimento só existe de verdade quando sobrevive ao reset - se depende de "você lembra que a gente falou...", não está documentado, está só na sua cabeça.
-
-## Configuration
-
-```yaml
-AN_KE_010:
-  name: "Context Death Test"
-  alias: "Reset Test"
-  phase: 5
-  agent: "@oalanicolas"
-
-  principle: |
-    Conhecimento só existe de verdade quando sobrevive à morte do contexto.
-    Se depende de "você lembra que a gente falou...", não está documentado.
-    Documento self-contained É um clone de conhecimento.
-
-  test_question: |
-    "Uma IA com ZERO contexto anterior consegue executar isso sem perguntar nada?"
-
-  validation_checklist:
-    - id: "CDT_01"
-      check: "Tem o PORQUÊ, não só o QUÊ?"
-      weight: 0.9
-    - id: "CDT_02"
-      check: "Termos técnicos estão definidos ou linkados?"
-      weight: 0.7
-    - id: "CDT_03"
-      check: "Dependências estão explícitas (arquivos, ferramentas, acessos)?"
-      weight: 0.8
-    - id: "CDT_04"
-      check: "Há exemplos concretos, não só abstrações?"
-      weight: 0.8
-    - id: "CDT_05"
-      check: "Decisões já tomadas estão documentadas (não precisa re-decidir)?"
-      weight: 0.9
-    - id: "CDT_06"
-      check: "Constraints/limites estão claros?"
-      weight: 0.7
-    - id: "CDT_07"
-      check: "Output esperado está especificado?"
-      weight: 0.8
-    - id: "CDT_08"
-      check: "Edge cases estão cobertos ou marcados como 'decidir depois'?"
-      weight: 0.6
-
-  anti_patterns:
-    - pattern: "Você lembra que..."
-      problem: "NÃO LEMBRA - contexto morreu"
-    - pattern: "Como a gente discutiu..."
-      problem: "NÃO DISCUTIU - sessão nova"
-    - pattern: "Aquele negócio de..."
-      problem: "QUE NEGÓCIO? - referência vazia"
-    - pattern: "O padrão normal"
-      problem: "QUAL PADRÃO? - assumindo conhecimento"
-    - pattern: "Referências a conversas anteriores"
-      problem: "Contexto implícito = contexto perdido"
-    - pattern: "Assumir conhecimento prévio do domínio"
-      problem: "IA zerada não tem domínio"
-
-  validation_levels:
-    L1_self:
-      description: "Você amanhã entende sem reler conversa?"
-      threshold: 0.6
-    L2_peer:
-      description: "Colega da área entende sem você explicar?"
-      threshold: 0.7
-    L3_ai:
-      description: "IA zerada executa sem perguntar?"
-      threshold: 0.8
-    L4_stranger:
-      description: "Pessoa de fora do projeto entende o suficiente?"
-      threshold: 0.9
-
-  thresholds:
-    pass: 0.8
-    review: 0.6
-    fail: "<0.6"
-
-  output:
-    type: "decision"
-    values: ["PASS", "REVIEW", "FAIL"]
-```
-
-## Decision Tree
-
-```
-IF (all checklist items pass AND no anti-patterns detected)
-  THEN PASS → Document is self-contained
-
-ELSE IF (checklist >= 0.6 AND anti-patterns <= 2)
-  THEN REVIEW → Fix specific gaps before proceeding
-
-ELSE IF (checklist < 0.6 OR anti-patterns > 2)
-  THEN FAIL → Document needs major rewrite
-
-TERMINATION: Document passes L3_ai level (IA zerada executa sem perguntar)
-FALLBACK: Loop back with specific feedback on failing items
-```
-
-## Evaluation Criteria
-
-| Criterion | Weight | Threshold | Description |
-|-----------|--------|-----------|-------------|
-| WHY documented | 0.9 | Required | Porquê, não só o quê |
-| Terms defined | 0.7 | >= 80% | Termos técnicos explicados |
-| Dependencies explicit | 0.8 | 100% | Arquivos, tools, acessos |
-| Concrete examples | 0.8 | >= 1 per concept | Não só abstrações |
-| Decisions documented | 0.9 | 100% | Não precisa re-decidir |
-| Anti-patterns absent | 1.0 | 0 detected | Zero referências implícitas |
-
-## Validation Questions
-
-1. "Uma IA com ZERO contexto anterior consegue executar isso sem perguntar nada?"
-2. "Todos os termos técnicos estão definidos ou linkados?"
-3. "As dependências (arquivos, ferramentas, acessos) estão explícitas?"
-4. "Existem exemplos concretos ou só abstrações?"
-5. "As decisões já tomadas estão documentadas?"
-6. "Há alguma frase tipo 'como discutimos' ou 'você lembra'?"
-
-## Performance Metrics
-
-```yaml
-performance:
-  decision_speed: "2-5 minutes per document"
-  accuracy_rate: "95% (anti-patterns are easy to detect)"
-  confidence_level: "90% (checklist is explicit)"
-  quality_correlation: "Direct - self-contained = usable across contexts"
-```
-
-## Failure Modes
-
-### Implicit Context Dependency
-- **Trigger:** Documento criado no meio de conversa longa
-- **Manifestation:** Referências a "o que falamos", "aquele approach"
-- **Detection:** Grep por anti-patterns ("lembra", "discutimos", "aquele")
-- **Recovery:** Expandir cada referência implícita com contexto explícito
-- **Prevention:** Aplicar checklist ANTES de finalizar documento
-
-### Assumed Domain Knowledge
-- **Trigger:** Expert escrevendo para si mesmo
-- **Manifestation:** Jargão sem definição, "óbvio" que não é óbvio
-- **Detection:** Pedir para não-expert ler e marcar termos desconhecidos
-- **Recovery:** Adicionar glossário ou links para definições
-- **Prevention:** Checklist item CDT_02 (termos definidos)
-
-### Missing WHY
-- **Trigger:** Foco em execução, pressa para entregar
-- **Manifestation:** Lista de passos sem rationale
-- **Detection:** Para cada ação, perguntar "por que isso e não outra coisa?"
-- **Recovery:** Adicionar rationale para cada decisão significativa
-- **Prevention:** Checklist item CDT_01 (tem o porquê)
-
-## Second-Order Effects
-
-```yaml
-second_order:
-  if_passes:
-    - "Qualquer IA/pessoa continua o trabalho"
-    - "Você pode esquecer e retomar meses depois"
-    - "Conhecimento está EXTERNALIZADO (Building a Second Brain)"
-    - "Documento vira asset, não liability"
-    - "Onboarding de novos membros fica trivial"
-    - "Debugging futuro tem contexto completo"
-
-  if_fails:
-    - "Dependência de quem escreveu (bus factor = 1)"
-    - "Retrabalho toda vez que contexto muda"
-    - "Conhecimento morre com a sessão/pessoa"
-    - "Documento vira liability (confunde mais que ajuda)"
-```
-
-## When NOT to Apply
-
-```yaml
-exceptions:
-  - context: "Brainstorm exploratório"
-    reason: "Ainda não é pra documentar, é pra explorar"
-  - context: "Conversa síncrona que vai virar doc depois"
-    reason: "Aplicar no doc final, não na conversa"
-  - context: "Contexto que DEVE morrer"
-    reason: "Decisões temporárias, experimentos descartáveis"
-  - context: "Notas pessoais só pra você"
-    reason: "Você É o contexto"
-```
-
-## Integration with Workflow
-
-```yaml
-checkpoint:
-  id: "context-death-test"
-  heuristic: AN_KE_010
-  phase: 5
-
-  trigger_conditions:
-    - "Documento/plano finalizado"
-    - "Spec pronta para handoff"
-    - "Task file completado"
-    - "Qualquer artefato que será usado por outra sessão"
-
-  criteria:
-    - metric: "checklist_pass_rate"
-      threshold: 0.8
-      operator: ">="
-    - metric: "anti_patterns_count"
-      threshold: 0
-      operator: "=="
-    - metric: "validation_level"
-      threshold: "L3_ai"
-      operator: ">="
-
-  veto_conditions:
-    - condition: "anti_patterns_detected > 0"
-      action: "HALT - Expand implicit references"
-    - condition: "checklist_pass_rate < 0.6"
-      action: "HALT - Major rewrite needed"
-
-  pass_action: "Document approved for handoff/storage"
-  fail_action: "Loop back with specific gaps to fix"
-```
-
-## Related Heuristics
-
-- **AN008 (Feynman):** Se não explica simples, não entendeu → CDT valida se explicou simples
-- **AN014 (Triangulação):** Doc self-contained = múltiplas pessoas validam igual
-- **Context Parity (MMOS):** Cada agente carrega seu contexto completo → CDT garante que doc carrega contexto
-
----
-
-**Pattern Compliance:** Documentation Quality Gate
-**Source:** Alan Nicolas - Extracted from recurring behavior pattern
-**Trigger:** "Tá super mega ultra bem explicado para uma IA que não sabe nem o que é isso?"