aiox-core 5.0.4 → 5.0.7

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

@@ -0,0 +1,85 @@
+# AN_KE_027 - Zero Emojis & Design Consistente
+
+**Type:** Design Standard Heuristic
+**Zone:** 20% Impacto
+**Agent:** @oalanicolas
+**Pattern:** Rigor Visual, Shadcn & Tailwind
+**Source:** [SOURCE: Extraído de guidelines e feedbacks onde o uso superficial de emojis infantiliza a UI profissional premium da marca.]
+
+**sys_tension:** (rigor_visual_absoluto, comunicação_visual_eficaz) → Resolver: Emojis permitidos apenas em docs internas, conversas, e metadata; proibidos em interfaces finais ao cliente
+
+## Purpose
+
+Estabelecer a barreira de maturidade visual do software (dashboards, relatórios gerenciais e interfaces de linha de comando visuais para clientes premium). A proliferação de emojis desvaloriza a estética elegante e reduz o senso de robustez e sofisticação (premium design).
+
+## Configuration
+
+```yaml
+AN_KE_027:
+  name: "Zero Emojis & Design Consistente"
+  zone: "impacto"
+  trigger: "Criando interfaces gráficas, painéis de admin, Readme.md de cliente ou relatórios executivos finais."
+
+  rule: |
+    SE for renderizar dados ao usuário
+    ENTÃO substitua 100% dos 🚀🔥✅ por ícones baseados em SVG/Lucide com Tailwind estrito.
+    Não dependa de Emojis do OS pois sua variação quebra a tipografia corporativa.
+
+  veto_condition:
+    trigger: "Detecção de Unicode Emojis fora de commits ou conversas internas."
+    action: "VETO — Remover emoji, substituir por Lucide Icon nativo ou texto em Tailwind."
+
+  evidence:
+    - "[EXACT WORDS]: NUNCA use emojis. Use SVGs/Lucide e Tailwind/Shadcn rigorosos para interfaces finais."
+
+  tension_with: "AN_KE_047 (AI-Predictable Design Systems) — Sistemas de design podem incluir emojis como tokens visuais previsíveis, criando conflito com a proibição absoluta aqui"
+```
+
+## Decision Tree
+
+```javascript
+IF (creating_ui_for_client OR reporting_managerial_status)
+  IF (contains_emoji_character)
+    THEN STRIP_EMOJIS
+    THEN MAP_TO_LUCIDE_ICON (e.g. ⚠️ -> AlertCircle, ✅ -> CheckCircle2)
+      IF (Lucide_not_available)
+        THEN use empty string OR pure typographic contrast (bold/accent color)
+  ELSE
+    THEN ALLOW_RENDERING
+```
+
+## Failure Modes
+
+### Infantilização do Brand
+- **Trigger:** Renderização padrão do LLM ao gerar listas HTML ou Markdown.
+- **Manifestation:** Dashboard analítico de $5k apresentando relatórios financeiros cheios de "💸💰📈".
+- **Detection:** Inspeção visual denota uma estética juvenil num SaaS premium.
+- **Recovery:** Regexec `[🚀🔥💸...]` e buscar substitutos modulares.
+- **Prevention:** Passar guidelines rigorosas no prompt limitador ou proibir Unicode block.
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "zero-emoji-gate"
+  heuristic: AN_KE_027
+  phase: "UI_Development"
+
+  validation_questions:
+    - "Existe algum emoji preenchendo o papel de um ícone vetorial legítimo?"
+    - "O espaçamento de tipografia respeita as regras nativas de Shadcn?"
+```
+
+## Validation
+
+**Paradoxo Identificado:** A heurística proíbe emojis em UIs profissionais, mas usa emojis em sua própria documentação (🔥, 💸, 📈, etc.) para comunicação interna.
+
+**Resolução:** Emojis são permitidos em:
+- Documentação interna (heurísticas, checklists, conversas)
+- Metadata e zona de impacto
+- Conversas entre agentes
+- Markdown de conhecimento compartilhado (KNOWLEDGE BOUNDARY)
+
+**Proibição:** Emojis em renderização final para cliente (dashboards, relatórios executivos, interfaces públicas).
+
+**Status:** ✓ Heurística válida e aplicável após distinção de contexto.

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

@@ -0,0 +1,74 @@
+# AN_KE_028 - Self-Contained Encapsulation
+
+**Type:** Architecture Standard Heuristic
+**Zone:** 💎 4% Excelência
+**Agent:** @oalanicolas
+**Pattern:** Clean Code & Scalability
+**Source:** [SOURCE: Decisão de arquitetura abordando poluição de scripts na raiz de ambientes e quebra de portabilidade de squads.]
+**sys_tension:**
+  - tension_with: "AN_KE_026 (Squad Agnosticism) — encapsulamento específico do squad vs reusabilidade genérica"
+  - resolution: "Usar consumidor threshold: se >1 squad consome, mover para root/scripts; se ≤1 squad, isolar em squad/scripts"
+
+## Purpose
+
+Garantir que os Squads e Módulos sejam portáteis. Se você mover a pasta `squad-creator-pro` para outra máquina, tudo deve ir junto. Scripting root contesta isso criando amarras indesejadas (bloody coupling) que impedem a evolução assíncrona do projeto.
+
+## Configuration
+
+```yaml
+AN_KE_028:
+  name: "Self-Contained Encapsulation"
+  zone: "excelencia"
+  trigger: "Quando for criar e salvar um script `.sh` ou `.py` específico para a execução de uma etapa de um Agente ou Squad."
+
+  rule: |
+    SE um script serve ao funcionamento autônomo de apenas um Squad
+    ENTÃO grave-o dentro da pasta `/squad/scripts` e NUNCA em um diretório global de utilities raiz.
+    Mantenha a portabilidade. Ninguém fora do squad usará isso.
+
+  veto_condition:
+    trigger: "Salvar `preflight-check.sh` na base `/root/scripts` mesmo sendo exclusivo do Squad."
+    action: "VETO — Move para `{squad_root}/scripts/`."
+
+  evidence:
+    - "[EXACT WORDS]: Deve morar na própria pasta do squad, não em infra global (se exclusividade)."
+```
+
+## Decision Tree
+
+```javascript
+IF (creating_or_editing_sub_script)
+  IF (number_of_squad_consumers > 1)
+    THEN ALLOW_ROOT_INFRA_SCRIPTING (Shared infrastructure zone)
+  ELSE
+    // Specific business logic or exclusive pipeline step
+    THEN ISOLATE_IN_SQUAD_DIR (Encapsulated execution)
+```
+
+## Failure Modes
+
+### Coupling Mortífero de Deploy
+- **Trigger:** Squad é clonado num servidor limpo e falta o script raiz.
+- **Manifestation:** O Agente tenta rodar Phase 2, falha o `root/scripts/helper.sh`.
+- **Detection:** Log path error: `file not found /root/scripts/...`.
+- **Recovery:** Procurar dependências na máquina principal, re-encapsular dentro da branch do squad e commitar.
+- **Prevention:** Restringir gravações de sub-tarefas fora do escopo `$(pwd)` local do squad ativo.
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "encapsulation-check"
+  heuristic: AN_KE_028
+  phase: "Squad_Creation"
+```
+
+## Validation
+
+✓ **Paradoxo Identificado:** Encapsulação vs Reuso — scripts exclusivos ao squad poluem a raiz se globalizados, mas precisam estar acessíveis se múltiplos squads os usam.
+
+✓ **Resolução:** Threshold de consumidores (>1 squad = root; ≤1 squad = encapsulado).
+
+✓ **Evidência:** Portabilidade (squad clonado deve carregar seus scripts) vs Reutilização (scripts compartilhados economizam manutenção).
+
+✓ **Aplicabilidade:** Requer validação em `squad-check` antes de merge. Script novo deve ser classificado por consumidor-count.

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

@@ -0,0 +1,73 @@
+# AN_KE_029 - Survival by Documentation (Reset Immunity)
+
+**Type:** Core Systemic Protocol
+**Zone:** 💎 4% Excelência
+**Agent:** @oalanicolas
+**Pattern:** Context Entropy Prevention
+**Source:** [SOURCE: Frustração contínua ao ter que explicar para o modelo as mesmas restrições a cada nova sessão. A entropia engole soluções verbais não imortais.]
+**sys_tension:** (ephemeral_chat_agreements_vs_persistent_system_memory, resolution: "official_documentation_becomes_immortal_reference")
+
+## Purpose
+
+Combater o esquecimento sistêmico de IA (e de devs humanos). Em janelas limitadas de contexto, qualquer premissa acordada via chat evapora quando a sessão fecha. O conhecimento só é real se existir no repousitório e sobreviver a um "git clone limpo".
+
+## Configuration
+
+```yaml
+AN_KE_029:
+  name: "Survival by Documentation (Reset Immunity)"
+  zone: "excelencia"
+  trigger: "Ao debater um gargalo, fix manual repetitivo ou acordo de padrão em chat de AI com usuário."
+
+  rule: |
+    SE concordamos num padrão ou correção
+    ENTÃO DOCUMENTALIZAR IMEDIATAMENTE.
+    Se a instrução depende que eu lembre da janela de chat anterior, não foi resolvida, foi empurrada.
+
+  veto_condition:
+    trigger: "O IA diz: 'Ok, a partir de agora usarei sempre este formato' SEM gerar um write_to_file."
+    action: "VETO — 'Eu vou esquecer amanhã, atualize a doc de heurísticas oficial base no que decidimos'."
+
+  tension_with: "AN_KE_017 (Research No Meio, Não No Início) — iteração contínua em chat sem formalização documental"
+
+  evidence:
+    - "[EXACT WORDS]: 'Se não sobrevive ao reset, não documentou. Achar que a IA vai lembrar da regra que mandou usar no script daqui a 3 janelas é falho'."
+```
+
+## Decision Tree
+
+```javascript
+IF (new_standard_agreed OR bug_fixed_iteratively)
+  THEN REQUIRE_DOCUMENTATION_ACTION
+    IF (AI only verbalizes confirmation)
+      THEN FORWARD_TO_FILE (Decision Cards, Handoffs or Guidelines)
+        IF (success)
+          THEN Reset Immunity = TRUE; Pattern established.
+    ELSE
+      THEN ACCEPT_UPDATED_FILES
+```
+
+## Failure Modes
+
+### A Síndrome do "No Chat Passado"
+- **Trigger:** Após fim de semana, iniciar nova thread.
+- **Manifestation:** IA repete o erro que já havia sido corrigido em 6 milissegundos três dias atrás.
+- **Detection:** O dev suspira "eu te disse pra não usar tailwind-arbitrary vars ontem".
+- **Recovery:** Parar a feature, abrir a documentação de SOP e commitar regras permanentes (AN_KE_NNN).
+- **Prevention:** NUNCA confirmar o encerramento da feature sem imortalização do conhecimento (Knowledge Extraction Architecture).
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "reset-immunity"
+  heuristic: AN_KE_029
+  phase: "Session_Handoff"
+```
+
+## Validation
+
+- ✓ **Paradox Resolution:** Tensão entre esquecimento sistêmico (reset de contexto) e imortalização de conhecimento (documentação) é resolvida via documentação oficial como memória de referência.
+- ✓ **Evidence Alignment:** Toda decisão tomada em chat DEVE gerar um artefato persistido no repositório (decision card, guideline, SOP).
+- ✓ **Failure Prevention:** Sem escrita em arquivo, a solução é "empurrada" e reaparecerá como bug em sessão futura.
+- ✓ **Enforcement Gate:** Veto explícito se IA confirmar verbalmente sem atualizar documentação oficial.

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

@@ -0,0 +1,80 @@
+# AN_KE_030 - Anti-Fingerprint AI Detox
+
+**Type:** Brand Safety Heuristic
+**Zone:** 💎 4% Excelência
+**Agent:** @oalanicolas
+**Pattern:** Ghostwriting & Content Automation
+**Source:** [SOURCE: Extraído de discussões sobre autoria fantasma, padronização de publicações e blindagem perceptual contra modelos sintéticos repetitivos.]
+**sys_tension:** (authenticity_vs_efficiency, Resolve via human review gates and voice-injection formula that prioritizes authorial intent over production speed)
+
+## Purpose
+
+Garantir que os materiais construídos por agentes para clientes finais e consumo humano (livros, artigos, pitches, copy) nunca carreguem os "Marcadores Genéticos" de IA (existem frases, aberturas hiper-repetitivas e transições estruturais que depreciam imediatamente o valor percebido de conteúdos caros aos olhos de clientes seniores).
+
+## Configuration
+
+```yaml
+AN_KE_030:
+  name: "Anti-Fingerprint AI Detox"
+  zone: "excelencia"
+  trigger: "Gerando documentos públicos longos e copys assinados para clientes."
+
+  rule: |
+    SE você criar um conteúdo autoral em nome da Mentelendária
+    ENTÃO DESTRUA qualquer marcador cognitivo clássico do Claude/GPT (ex: "Em resumo", emojis soltos sem motivo, aberturas formais "Certamente!").
+
+  veto_condition:
+    trigger: "Presença recorrente das frases sintéticas ou listas que seguem ritmos matemáticos previsíveis sem voz real."
+    action: "VETO — Acione o revisor e quebre o padrão da comunicação com interrupções humanas (perguntas socráticas e imperfeições)."
+
+  evidence:
+    - "[EXACT WORDS]: A repetição mecânica destrói a percepção de alto valor. Remova 100% de assinaturas IA."
+
+  tension_with: "AN_KE_025 (Determinism Over LLM) — Conflita porque determinismo preza saída previsível/matemática vs. necessidade aqui de injetar imperfeições humanas e variância autoral controlada."
+```
+
+## Decision Tree
+
+```javascript
+IF (generating_ghostwritten_article OR brand_material)
+  IF (contains_trigger_phrases("Hoje vamos explorar...", "Em conclusão", "Em resumo"))
+    THEN STRIP_AI_HOOKS
+    THEN APPLY_ALAN_NICOLAS_VOICE_FORMULA
+      IF (output_reads_synthetically_perfect)
+        THEN INJECT_HUMAN_CONTRASTS (Break sentences, Socratic questioning, Analogies, Direct address)
+  ELSE
+    THEN FORWARD_TO_APPROVAL
+```
+
+## Failure Modes
+
+### Percepção de Automação Barata
+- **Trigger:** Ao processar o livro completo com a instrução "Resuma o capítulo sem quebrar o sentimento genuíno".
+- **Manifestation:** O leitor, ao abrir o PDF "Premium", lê os clássicos "A inteligência artificial tem um papel fundamental neste mundo". Fica óbvio que foi um copy/paste automatizado sem esmero.
+- **Detection:** Ferramentas de revisão notam repetição adverbial. O humano sente artificialidade.
+- **Recovery:** Prompts limitadores com "Forbidden Words", passando um pente fino estilístico.
+- **Prevention:** Incorporar ao Prompt a negativa absoluta dos metadados de máquina e remover a "vontade de agradar excessiva".
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "ai-detox-scanner"
+  heuristic: AN_KE_030
+  phase: "Content_Review"
+
+  validation_questions:
+    - "Eu publicaria isso sabendo que minha mãe leria e não desconfiaria da máquina?"
+    - "A estética do livro preserva os solavancos naturais de uma mente pensante (TDAH e foco)?"
+
+## Validation
+
+**Paradox Identified:** The tension between automated content generation (efficiency) and authentic human voice (perception of value). AI agents can produce error-free, consistent prose at scale, but this very perfection signals synthetic origin to expert readers. Resolution requires systematic voice injection: breaking structural symmetry, introducing controlled imperfection, and embedding authorial quirks that prove human stewardship.
+
+**Acceptance Criteria:**
+- [ ] Output passes "mother test" — adult reader cannot distinguish synthesis from authorship
+- [ ] Forbidden AI markers completely stripped (no "Em resumo", no mechanical transitions, no synthetic openings)
+- [ ] Voice formula applied: Socratic questions, analogies, direct address, deliberate asymmetries
+- [ ] Human review checkpoint mandatory for materials >2K words or client-facing copy
+- [ ] Revision feedback loop captures idiosyncratic voice patterns for future generations
+```

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

@@ -0,0 +1,78 @@
+# AN_KE_031 - Localhost QA Gate
+
+**Type:** Release Gate Heuristic
+**Zone:** 🔥 20% Impacto
+**Agent:** @oalanicolas
+**Pattern:** Frontend Deployment & Safety
+**Source:** [SOURCE: Derivado de conversas sobre a apariência de erros técnicos em produção que não deviam vazar ao usuário comum, indicando pulo de instâncias.]
+**sys_tension:** (belief_in_minor_refactors_as_safe, necessity_of_rigorous_local_validation); resolution: All changes, regardless of perceived scope, demand pre-commit localhost execution
+
+## Purpose
+
+Garantir que não existe confiança cega de que um código refatorado ("só alterei uma linha de const") irá compilar tranquilamente na Vercel/Produção, causando white screens mortai em clientes finais. O Local QA é absoluto.
+
+## Configuration
+
+```yaml
+AN_KE_031:
+  name: "Localhost QA Gate"
+  zone: "impacto"
+  trigger: "Refatorações visuais ou integrações na base de código web/UI."
+
+  rule: |
+    SE foi realizado um refactor no React, Next.js ou HTML Vanilla
+    ENTÃO NUNCA dê COMMIT antes do dev responsável certificar a visualização localhost para crashes imediatos.
+
+  veto_condition:
+    trigger: "Tentativa do AI Agent de commitar algo web sem a afirmação explícita de teste rodado/rodando ou print log do terminal provando sucesso do build."
+    action: "VETO — Start `npm run dev` or build before pushing."
+
+  evidence:
+    - "[EXACT WORDS]: Erros como esse só podem aparecer assim em localhost, nunca online... Não commite sem validar a visão web."
+
+  tension_with: "AN_KE_049 (Ship First, Doc Later) — Pressão para deployment rápido vs necessidade de validação local rigorosa antecedente"
+```
+
+## Decision Tree
+
+```javascript
+IF (UI_component_altered OR routing_changed OR hooks_refactored)
+  IF (dev_checked_localhost == TRUE)
+    THEN ALLOW_COMMIT_PUSH
+  ELSE
+    THEN BLOCK_COMMIT
+    THEN PROMPT_AGENT ("Execute o npm run dev/build. Avaliou visualmente? O site quebrou?")
+      IF (compilation_error)
+        THEN FIX_IN_LOCAL
+      ELSE
+        THEN proceed cleanly
+```
+
+## Failure Modes
+
+### Fatal Vercel Deployment Break
+- **Trigger:** Refatorar estado do Tailwind ou trocar uma dependência menor num commit "rápido".
+- **Manifestation:** O build passa o CI marginalmente ou o Dev mode omite erro de TypeScript restrito, quebrando clientes em produção (White Screen).
+- **Detection:** Rollbacks emergenciais ou painéis de sentry alarmando.
+- **Recovery:** Buscar o último hash estável e forçar reverter via git branch e testar local.
+- **Prevention:** Uso rígido do checkpoint de teste QA na máquina desenvolvedora como premissa para a automação CI.
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "qa-visual-lock"
+  heuristic: AN_KE_031
+  phase: "Git_Commit"
+
+  validation_questions:
+    - "A branch foi verificada fisicamente no browser antes do git push ser autorizado?"
+```
+
+## Validation
+
+✓ **Paradoxo Identificado:** Cognitive bias que assume refatorações com escopo "pequeno" como intrinsecamente seguras, quando o risco real é ortoganal à magnitude da mudança.
+
+✓ **Resolução:** Obrigação incondicional de teste localhost **antes** de qualquer commit, eliminando a falsa dicotomia entre mudanças "seguras" e "perigosas".
+
+✓ **Garantia:** White screens em produção causados por erosão de CI/CD safety são preveníveis através de validação sensorial do desenvolvedor na máquina local.

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

@@ -0,0 +1,81 @@
+# AN_KE_032 - Schema Immutability
+
+**Type:** Infrastructure Security Heuristic
+**Zone:** 🔥 20% Impacto
+**Agent:** @oalanicolas
+**Pattern:** Supabase & Datastores
+**Source:** [SOURCE: Extraído das orientações de governança estrita que impedem IAs e devs rápidos de renomear chaves que destruirão relações em cascade.]
+
+## Purpose
+
+Estabelecer uma zona vermelha de bloqueio para edições, droppings ou mutações estruturais em tabelas, stores e chaves centrais. Um erro de schema deleta o cérebro das automações. Nenhuma LLM pode ser confiada a "alterar um campo" se isso vazar pra dezenas de Workflows.
+
+## Configuration
+
+```yaml
+AN_KE_032:
+  name: "Schema Immutability"
+  zone: "impacto"
+  trigger: "Operações tocando DB, Types (TS), ou arquivos vitais como decision-cards.yaml e workspace root."
+
+  sys_tension:
+    tension_with: "AN_KE_073 (Parallel Subagents for Throughput) — Paralelização máxima vs Bloqueio obrigatório de schema"
+    resolution: "Dual-Gate: LLMs detectam necessidade de schema change, HITL aprova, LLM executa migration validada com rollback safety"
+
+  rule: |
+    SE a ação requer alterar a chave-primária virtual, estrutura de nomeação ou apagar campos base de um banco central
+    ENTÃO BLOCK! Requeira Autorização Explícita Humana via Human In The Loop Handoff (HITL).
+
+  veto_condition:
+    trigger: "Modificações assíncronas em models.py ou supabse SQL schema sem aprovação de Alan."
+    action: "VETO — Pause a fila e documente a modificação pretendida parando a execução."
+
+  evidence:
+    - "[EXACT WORDS]: O banco central, ou chaves globais, nunca devem ser tocados inadvertidamente sem o Human Gate explícito pois a reversão é complexa."
+```
+
+## Decision Tree
+
+```javascript
+IF (modifying_database_schema OR modifying_typescript_types OR global_hub_files)
+  IF (human_approval_present == TRUE AND tests_confirm_deprecation_safety == TRUE)
+    THEN ALLOW_MIGRATION
+  ELSE
+    THEN VETO
+    THEN REQUEST_HUMAN_IN_THE_LOOP ("Alan, solicito permissão para injetar novo campo `is_verified` no Supabase users.")
+```
+
+## Failure Modes
+
+### Cascade Data Annihilation
+- **Trigger:** Atualizar uma foreign-key para um padrão mais moderno sem checar dependências transitórias em Node.js edges.
+- **Manifestation:** Todos os squads da empresa perdem as chaves de rotas, quebrando a comunicação global e gerando pânico aos clientes por quebra de API.
+- **Detection:** Log streams da Edge function apitando "Column does not exist".
+- **Recovery:** Restore do DB do último log da meia noite.
+- **Prevention:** Um gate inflexível que bloqueia mutações críticas em níveis operacionais autônomos.
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "schema-hitl"
+  heuristic: AN_KE_032
+  phase: "Database_Update"
+
+  validation_questions:
+    - "Existem mais de 3 consumidores lendo essa coluna que sofrerá alteração?"
+    - "Foi documentado o impacto transversal antes de encabularmos a migration?"
+```
+
+## Validation
+
+**Paradox Identified:** Automação vs Bloqueio Manual
+- **Tension:** LLMs são esperadas executar workflows autonomamente, mas não podem ser confiadas a alterar schemas críticos
+- **Resolution:** Implementar Dual-Gate — LLM detecta necessidade, submete para HITL, recebe aprovação, executa com safety gates (rollback, canary deploy, test suite)
+- **Enforcement:** Toda migration em tabelas com >3 consumidores requer aprovação humana explícita antes da execução automatizada
+
+**Checklist de Validação:**
+- [ ] Schema change impacta mais de 3 consumidores? → Requer HITL
+- [ ] Teste de rollback foi executado contra staging DB?
+- [ ] Documentação de deprecation path foi criada?
+- [ ] Edge functions foram atualizadas para nova estrutura?

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

@@ -0,0 +1,69 @@
+# AN_KE_033 - Squads = Source of Truth
+
+**Type:** Architecture Governance Heuristic
+**Zone:** 🧠 0,8% Genialidade
+**Agent:** @oalanicolas
+**Pattern:** Multi-Runtime Portability
+**Source:** [SOURCE: Sessão sinkra-hub 0dadc1e0 — declaração explícita de que squads/ é SOT e .claude/ é projeção]
+**sys_tension:** AN_KE_073 (Parallel Subagents) vs Centralização em squads/ como SOT — Subagentes paralelos pressuram distribuição; squads/ como SOT preserva unicidade da verdade. Resolver via artifact contracts + orchestração que mantém squads/ canônico enquanto permite paralelização segura.
+
+## Purpose
+
+A fonte da verdade de skills, agents e processos é SEMPRE `squads/`, nunca `.claude/skills/`. O diretório `.claude/` é uma PROJEÇÃO para Claude Code. Squads devem ser portáveis para qualquer runtime (Codex, Gemini, Claude) sem depender de vendor lock-in.
+
+## Configuration
+
+```yaml
+AN_KE_033:
+  name: "Squads = Source of Truth"
+  zone: "genialidade"
+  trigger: "Criando, editando ou decidindo onde salvar skills, agents, tasks."
+
+  rule: |
+    SE criando skill/agent/task
+    ENTÃO a fonte da verdade é squads/{squad-name}/.
+    .claude/skills/ é PROJEÇÃO (sync automático).
+    NUNCA criar algo que vive SÓ dentro de .claude/.
+    Portabilidade multi-runtime: codex, gemini, claude.
+
+  veto_condition:
+    trigger: "Skill ou agent que existe apenas em .claude/skills/ sem correspondência em squads/."
+    action: "VETO — Mover para squads/ e configurar sync."
+
+  evidence:
+    - "[SOURCE: sessão 0dadc1e0] 'a fonte da verdade é sempre o squads/ as skills como esta sao originadas dele, pois podem ser reproduzidas para codex, gemini, claude, e nao devem viver nunca só dentro de .claude, isso deve virar uma lei, uma heuristica ou algo assim'"
+```
+
+## Decision Tree
+
+```javascript
+IF (creating_or_editing skill OR agent OR task)
+  THEN PRIMARY_LOCATION = squads/{squad-name}/
+  THEN .claude/skills/ = auto-sync projection
+  IF (file_exists_only_in .claude/skills/)
+    THEN MIGRATE to squads/ immediately
+  IF (file_exists_only_in squads/)
+    THEN OK — sync will project to .claude/ when needed
+```
+
+## Failure Modes
+
+### Vendor Lock-in
+- **Trigger:** Skill criada direto em `.claude/skills/` sem squad correspondente.
+- **Manifestation:** Impossível rodar em Codex ou Gemini. Preso no Claude Code.
+- **Detection:** Audit: `diff squads/ .claude/skills/` mostra skills órfãs.
+- **Recovery:** Mover para `squads/{owner-squad}/` e configurar sync.
+- **Prevention:** Regra: squads/ é SOT. Sempre.
+
+## Integration with Workflow
+
+```yaml
+checkpoint:
+  id: "squads-sot-gate"
+  heuristic: AN_KE_033
+  phase: "Skill_Creation / Agent_Design"
+```
+
+## Validation
+
+**Paradoxo Resolvido:** Centralização vs Portabilidade é resolvida pela arquitetura de artifact contracts (SINKRA v3.1). A fonte de verdade permanece em squads/, mas o contrato declarativo permite que qualquer runtime (Claude, Codex, Gemini) reconheça e execute o artefato sem acoplamento ao Claude Code. A projeção automática (.claude/ sync) é implementação, não verdade — a verdade é o contrato estrutural em squads/.

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

@@ -0,0 +1,119 @@
+---
+id: "AN_KE_034"
+title: "Ghostwriting (Autorship)"
+mind: "oalanicolas"
+type: "heuristics"
+zone: "excelencia"
+tags:
+  - "Brand Identity"
+  - "Content Quality"
+  - "Intellectual Property"
+pipeline_instances:
+  - "content-review"
+  - "validation"
+---
+
+# AN_KE_034 - Ghostwriting (Autorship)
+
+**Type:** Identity Presentation Heuristic
+**Phase:** 6 (Quality Gate)
+**Agent:** @process-architect
+**Pattern:** HO-PP-AN034
+
+```yaml
+sys_tension:
+  - tension_with: "AN_KE_106 (Subagents Over Flattened Tasks)"
+    resolution: "Ghostwriting reconhece que a síntese saiu de AN_KE_106 (delegação entre subagentes), mas a autoria moral permanece com Alan porque a intenção estratégica, direção e aprovação final dele determinaram o resultado. A IA é ferramenta de execução subordinada, não de criação intelectual primária."
+```
+
+## Purpose
+
+Garantir que absolutamente nenhuma IA, LLM ou Agente Sintético reivindique direitos autorais, visuais ou processuais dentro de materiais produzidos a partir do conhecimento de Alan Nicolas. Todo conteúdo gerado a partir do corpus do especialista pertence integral e exclusivamente ao autor humano. A IA é um ghostwriter silencioso — nunca um co-autor declarado.
+
+## Configuration
+
+```yaml
+AN_KE_034:
+  name: "Ghostwriting (Autorship)"
+  phase: 6
+  zone: "excelencia"
+  trigger: "Gerando READMEs públicos, artigos, livros, manuais organizacionais ou qualquer conteúdo de publicação final."
+
+  weights:
+    synthetic_authorship_elimination: 1.0
+    author_voice_fidelity: 1.0
+
+  thresholds:
+    ai_authorship_claim_tolerance: 0
+
+  veto_conditions:
+    - condition: "document_contains_synthetic_authorship_signature_or_agent_person_reference == true"
+      action: "VETO - AI Authorship Claim. Strip all synthetic author references. Overwrite with Original Author: Alan Nicolas / AIOX."
+
+  output:
+    type: "decision"
+    values: ["APPROVE_AUTHORSHIP", "STRIP_SYNTHETIC", "VETO"]
+```
+
+## Failure Modes (Anti-Patterns)
+
+```yaml
+failure_modes:
+  - type: "omission"
+    name: "Ruptura de Propriedade Intelectual (The Coward)"
+    trigger: "A IA compila um sistema inédito a partir das anotações de Alan e gera o documento PDF final."
+    manifestation: "O PDF começa: 'Eu sou o assistente de IA e analisei as notas deste incrível usuário. Aqui está o framework que eu criei baseado em seus insights.' — declaração de co-autoria sintética inaceitável."
+    detection: "Termos: 'Eu (assistente)', 'criei baseado em', 'análise realizada pelo modelo', 'gerado por IA'."
+    recovery: "Aplicar RegExp para remover primeira pessoa sintética. Reescrever com voz total de Alan Nicolas: 'Eu criei', 'Minha metodologia', 'A Mentelendária desenvolveu'."
+
+  - type: "misapplication"
+    name: "Forced Persona Rigidity (The Zealot)"
+    trigger: "Ghostwriting forçado mesmo em documentação técnica interna de squad onde a autoria IA é transparente e esperada."
+    manifestation: "Documentação de Squad com assinatura 'Alan Nicolas' em arquivos YAML internos de configuração de agentes que nenhum cliente vê."
+    detection: "Assinatura humana em artefatos puramente internos de runtime."
+    recovery: "Distinguir: conteúdo public-facing (blogs, livros, pitches) = autoria humana mandatória. Artefatos de infraestrutura interna (YAML configs, heurísticas) = autoria implícita do framework."
+```
+
+## Evaluation Criteria
+
+```yaml
+evaluation_criteria:
+  - metric: "Synthetic Author Claim"
+    weight: 1.0
+    threshold: "=== 0 instances"
+    description: "Zero referências à IA como co-autora, criadora ou geradora do conteúdo em materiais public-facing?"
+  - metric: "Author Voice Fidelity"
+    weight: 1.0
+    threshold: "=== Alan Nicolas Voice"
+    description: "O conteúdo está escrito na primeira pessoa do especialista humano (Alan Nicolas)?"
+```
+
+## Decision Tree
+
+```javascript
+IF (Gerando Documento de Publicação Final (Livro, Artigo, Pitch)) {
+  SCAN("Synthetic Authorship Markers: ['Eu (assistente)', 'criei baseado em suas notas', 'análise da IA', 'gerado por']");
+  
+  IF (Synthetic_Markers > 0) {
+    VETO("Reivindicação sintética de autoria detectada.");
+    STRIP_SYNTHETIC("Remover toda menção de agência sintética.");
+    OVERWRITE("Reescrever em primeira pessoa de Alan Nicolas.");
+  } ELSE {
+    APPROVE_AUTHORSHIP("Propriedade intelectual preservada. Ghostwriting silencioso OK.");
+  }
+}
+
+NEVER("Permitir que qualquer documento de publicação final contenha referência ao LLM como agente criativo, co-autor ou gerador intelectual do conteúdo.");
+```
+
+---
+
+## Validation
+
+✅ **Paradox Identified & Resolved**
+
+**Paradox:** A heurística exige 100% de ghostwriting (zero menção de autoria sintética) enquanto simultaneamente reconhece que a IA participou da síntese. Como reivindicar autoria total se a ferramenta gerou o artefato?
+
+**Resolution via sys_tension:** O paradoxo é resolvido através de hierarquia de intenção. Alan Nicolas define a estratégia, direção, aprovação e contexto cultural. A IA executa síntese técnica. A autoria mora na intenção que precede a execução, não no ato mecânico de geração. Isso alinha com AN_KE_007 (Distributed Cognition) que distribui o trabalho entre humano e máquina, mas coloca Alan como o dirigente estratégico final.
+
+**Checkpoint Validation:** ✓ Documento passa no teste de voz original — refere-se a "Alan Nicolas", "inteligência da base", "cérebro estratégico original" sem assinatura sintética. A presença de `sys_tension` documenta a contradição implícita e a resolve através de economia de níveis de autoridade (humano > máquina).