aiox-core 5.0.5 → 5.0.7

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_092.md

@@ -0,0 +1,81 @@
+---
+id: "PV_KE_092"
+title: "Integration as a Worker Commandment"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "Implementation Phase"
+  - "Resilience Standards"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  tension_with: "AN_KE_073 (Parallel Subagents) vs Isolamento Sequencial do Worker — Subagents paralelos maximizam throughput; Worker isolado e protetor adiciona overhead latencial"
+  resolution: "Apply proportional protection: external integrations (Layer 5) require full Worker contract; internal trusted services (VPC) require only clean logging"
+---
+
+# PV_KE_092 - Integration as a Worker Commandment
+
+**Type:** Reliability Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:clickup-engineer
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 15: Integração e Plataformas Externas]
+
+## Purpose
+Garantir a impermeabilidade do Sistema contra falhas de terceiros. Esta heurística (Commandment) proíbe categóricamente o acoplamento direto de qualquer Primitivo SINKRA, Agente ou Script principal com uma API Externa (Google Drive, Slack, OMIE, TikTok, etc.) sem o intermédio de um Worker explícito. Cada requisição a um serviço fora do Ecosystem Core não é uma mera "call", mas um Contrato Autônomo (Worker) contendo 4 escudos inegociáveis: Validação de Input, Tratamento de Erro Defensivo, Lógica de Retry e Auditoria de Log. Pular o Worker para "chamar a API direto pra ir mais rápido" é convocar silenciosamente o colapso e o afogamento em falhas mudas.
+
+## Configuration
+```yaml
+PV_KE_092:
+  name: "The Middleware Worker Law (Anti-Direct-Call)"
+  zone: "zone_0.8"
+  trigger: "Quando o Time de Engenharia de Ferramentas (Fase 7 e Finais) estiver construindo scripts ou configurando automações que puxam ou empurram dados para SaaS Externos."
+  evidence_threshold: "coding_principles"
+  rule: |
+    Todo e qualquer PONTO de contato do Processo Operacional com um Sistema Externo (Plataformas Layer 5) DEVE OBRIGATORIAMENTE ser isolado em um Worker Autônomo.
+    O Processo NUNCA chama um serviço diretamente.
+    O Worker Protetor Exige (4 Pilares):
+    1. Input Validation: 'O que estou mandando está tipado corretamente?'
+    2. Defensive Error Handling: 'Se estourar 502/429/Timeout da API de terceiros, o que faço?'
+    3. Algorithmic Retry: 'Se falhou por pico, eu tento de novo 3x com backoff ou aborto?'
+    4. Explicit Logging: 'Registrar timestamp em Supabase quem enviou, que payload, e o Output Brutal.'
+    Um Worker sem os 4 Pilares é uma vulnerabilidade sistêmica.
+```
+
+## Decision Tree
+```javascript
+IF (a_developer_or_automation_engineer_is_creating_a_call_to_an_API)
+  STEP_1: EXAMINE the flow of execution.
+  STEP_2: ENFORCE the Worker Firewall.
+    IF (The Script says: `await axios.post('https://api.tiktok.com/symphony', data); // done`)
+      -> VETO: Direct Call Detected. No try/catch, no fallback strategy, no logger. If TikTok fails this second, the entire SINKRA orchestrator crashes, or worse, fails silently.
+    IF (The Script invokes a generic Worker `TTCX_Worker_CreateSymphony_Brief` which executes the 4 Pillars before hitting TikTok)
+      -> ACCEPT: The System is insulated. The Third-Party failure belongs to the Worker, not to SINKRA.
+NEVER:
+  Desdenhar a complexidade do mundo externo ("É só uma API simples pra criar pasta"). Porque 800 projetos vezes 50 pastas somam 40.000 chamadas. Em 40.000 chamadas, a Lei das Probabilidades garante que o Timeout virá, e sua "API Simples" matará a consistência de dados da operação inteira se estiver desprotegida.
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "O Middleware Obsessivo-Compulsivo"
+- **Trigger:** A Equipe envolve absolutamente toda operação de CPU ou trânsito micro-local num Worker Titânico e Assíncrono para abstrair as coisas mais elementares, com filas SQS, Docker containers locais de Retry e bases autônomas no Kubernetes apenas pra formatar um Date.
+- **Manifestation:** A Arquitetura infla drasticamente as dezenas de instâncias com latências enormes porque operações síncronas rápidas (Layer Interna confiável) foram bloqueadas sob o dogma de "Worker Law" indiscriminado.
+- **Detection:** Reclamações que a execução que levaria 5ms está levando 2 min no fluxo devido ao Peso do Worker Isolado e Escalado sobre dimensionadamente.
+- **Recovery:** A Lei de Intermédio Protetor (PV_KE_092) aplica-se às FASES EXTERNAS E INTEGRAÇÕES DE PLATAFORMAS (Layer 5/Third Parties). Comunicação de Microserviços Internos (ex: Orchestrator -> Supabase) sob redes de confiança (VPC) dispensam Fallbacks de Internet com peso de canhão, mas exigem log limpo. Aja proporcionalmente ao Risco da Queda.
+
+### Omission / Failure to Activate: "O Incêndio Fantasma das Requisições Soltas"
+- **Trigger:** Configurações rápidas e preguiçosas via ferramentas superficiais onde a equipe atrela diretamente uma automação "Gatilho x -> Evento HTTP" sem um único nó de Try/Catch, sem um nó de Backoff, sem Log Supabase (Anti-Padrão Clássico de quem usa Webhooks simples demais).
+- **Manifestation:** O Processo roda aparentemente bem. Durante uma Sexta-feira às 18:00, o C-Level cobra a pasta de Arquivos do Projeto 799, e descobre que não existe pasta, não existe Cliente inserido no CRM e o Documento do briefing não baixou. Ninguém no Slack reportou nada de errado nas últimas horas. Não há logs. O Sistema teve engasgo, derrubou 5 projetos simultaneamente e esqueceu porque o Worker não tinha a Defensiva programada aliada.
+- **Detection:** Falhas silenciosas se somam. Reclamação: "O N8N da umas travadas às vezes sem avisar, o sistema não é confiável". A culpa não é da Ferramenta; a Culpa é da ausência de Contrato do Worker.
+- **Recovery:** Extirpamento de Nódulos Fracos. O Engenheiro OBRIGATORIAMENTE deve rechear cada Módulo Http com o "Error Handler Node". Automação que não trata erro em Plataforma Externa está embargada.
+
+## Validation
+
+**Validation Criteria:**
+- [ ] All external API calls are encapsulated in autonomous Worker modules
+- [ ] Each Worker implements 4 Pillars: Input Validation, Defensive Error Handling, Algorithmic Retry, Explicit Logging
+- [ ] Internal trusted services (VPC layer) logged without full retry overhead
+- [ ] No direct API calls detected in main process or orchestrator code
+- [ ] Supabase audit trail captures timestamp, caller, payload, and response for every external integration
+- [ ] Retry logic implements exponential backoff with configurable max attempts
+- [ ] Silent failures are eliminated: all error states must be logged and surfaced to operators
+
+**Compliance Check:** Run code audit for direct API references (`axios.get`, `fetch()`, `http.request()`) in process logic. All external calls must route through registered Worker handlers.

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_093.md

@@ -0,0 +1,74 @@
+---
+id: "PV_KE_093"
+title: "The Domain Namespace Priority (Anti-Client Folder)"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "Implementation Phase"
+  - "Process Governance"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  tension_with: "AN_KE_073 (Parallel Subagents for Throughput) — Sequential Domain Hierarchy vs. Concurrent Multi-Customer Processing"
+  resolution: "Use Domain-First Architecture (Strategic > Tactical > Operational) as root structure, then apply intelligent filtering and custom views at the client/product level to preserve clean separation of concerns while delivering customer visibility when needed"
+---
+
+# PV_KE_093 - The Domain Namespace Priority (Anti-Client Folder)
+
+**Type:** Organizational Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:clickup-engineer
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 15: Configurando o ClickUp para Sinkra / Passo 1]
+
+## Purpose
+Estabelecer a primazia arquitetural do Espaço de Trabalho (Workspace Hierarchy). Esta heurística impõe que a Camada 1 (Sistema de Gestão, ex: ClickUp Spaces) deve ser subdividida OBRIGATORIAMENTE por Nível de Domínio (Estratégico, Tático, Operacional) e NUNCA por "Clientes", "Equipes Departamentais" ou "Produtos". Organizar o ambiente por Cliente mistura na mesma tela/pasta a Meta Visão (Estratégico) com Operações Robotizadas (Worker), destruindo a filtragem, obliterando os dashboards analíticos e fundindo níveis de abstração incompatíveis. O Workspace limpo é um espelho do Domínio, não da fatura comercial.
+
+## Configuration
+```yaml
+PV_KE_093:
+  name: "Strict Domain-Level Workspaces"
+  zone: "zone_0.8"
+  trigger: "Fase 7 - Implementation. O ClickUp Engineer (ou equivalente) configura o Workspace Raiz da organização SINKRA no Gerenciador de Tarefas."
+  evidence_threshold: "structural_logic"
+  rule: |
+    O Top-Level Container (Space, Board Raiz) DEVE refletir o Domínio SINKRA:
+    - [DOMAIN] Estratégico -> Decisões, Planejamento C-Level, Metas Macroeconômicas (Predomínio Human).
+    - [DOMAIN] Tático -> Coordenação, Campanhas, Arquitetura Middle-Man (Misto Human/Agent).
+    - [DOMAIN] Operacional -> Produção em Massa, Execuções (Predomínio Worker/Agent).
+    Se o Cliente X requerer pastas, ele terá Projetos (Instâncias) dentros do Domínio Tático/Operacional.
+    Se o Workspace contiver Espaços Misturados ("Cliente A", "Marketing", "TI Dúvidas"), a abstração ruiu. A Visão SINKRA implodiu e dashboards se tornarão inúteis.
+```
+
+## Decision Tree
+```javascript
+IF (structuring_the_hierarchical_Spaces_of_a_Task_OS_like_ClickUp_or_Jira)
+  STEP_1: EXAMINE the Root Node categorization philosophy of the Team.
+  STEP_2: ENFORCE Domain Supremacy.
+    IF (The Team proposes: 'We create 1 Space per Customer so the Account Manager can see everything associated with Nike.')
+      -> VETO: Organizing by Customer throws Strategic alignment tasks, tactical planning, and 10,000 operational robotic tasks into the same visual bucket. Dashboards lie. Executive views break.
+    IF (The Team proposes: 'We create 3 Spaces: Strategic, Tactical, and Operational. We tag the customer in the Custom Field of the Instances.')
+      -> ACCEPT: Architectural integrity. Perfect Filtering. Cross-Customer aggregation is possible.
+NEVER:
+  Organizar um ecossistema operacional pelas fronteiras sociais/comerciais (Produto/Time/Cliente). Ecossistemas de Alta Tensão SINKRA são estruturados pela Gravidade da Física Processual (O Nível de Abstração: Pensar x Gerenciar x Executar).
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "O Fundamentalismo das Gavetas Vagas"
+- **Trigger:** A Equipe força a taxonomia "Estratégico/Tático/Operacional" literal como ÚNICAS 3 Listas/Namespaces na Empresa Global, não permitindo sequer Lógicas Sub-Diretoriais sensatas nas Instâncias, jogando 5.000 projetos diários de 15 BUs numa Mesma Lista chamada "Operacional Geral", matando a UI/UX da Ferramenta.
+- **Manifestation:** O Workspace Tático exibe gargalos inenarráveis de Lentidão Front-End porque todos os Nodes de todas as Células (RH, Vendas, Infra) despencam numa vala comum sem Subdivisão de Pastas SINKRA (Primitivo de Template/Célula).
+- **Detection:** Reclamações que a categorização rigorista de Domínios impossibilitou achar a Tarefa X do Squad Y no meio da vala "Operacional".
+- **Recovery:** A Restrição do Domínio (PV_KE_093) governa o NODE RAIZ (ClickUp Space, Notion Root Database). A hierarquia secundária (Folders, Project Tags) OBRIGATORIAMENTE desce à particularidade das Squads/Produtos/Clientes. A Ferramenta Mapeia assim: `Space [Domínio] -> Folder [Template/Unidade] -> List [Instância Agrupadora] -> Task [Atom/Molecule]`.
+
+### Omission / Failure to Activate: "O Desastre do 'Workspace Por Cliente'"
+- **Trigger:** Agências de Marketing ou Consultorias antigas migrando para SINKRA e insistindo "O jeito que a gente sempre fez foi criar uma Área no Trello para cada Cliente novo que entra."
+- **Manifestation:** A Diretoria tem Visão Fragmentada (Silos Obscuros). Se a empresa fechar com 80 clientes, ela terá 80 Namespaces diferentes, com Custom Fields diferentes porque nenhum herda a Meta-Regra. Um relatório C-Level de "Mostre todos os Gargalos Operacionais da Fase de Criação" cruza-clientes torna-se IMPOSSÍVEL ou requer planilheiros de Excel consolidando CSVs na madrugada.
+- **Detection:** Multiplicação descontrolada de Paineis. O Arquiteto não sabe nem "Onde" aplicar a regra de Automação de Cópia X, pois ela precisa ser replicada 80 vezes. A manutenibilidade despencou à zero.
+- **Recovery:** O `Process-Mapper` em parceria com o `ClickUp-Engineer` tranca Criações Radicais. Re-Estrutura Base `(Domínio > Unidade)`. Configura View Customizada Agregadora: "Account Manager Nike View", onde um Filtro Inteligente puxe TODAS as tasks do Domínio Tático/Operacional taggeadas com "Cliente: Nike", gerando a exata ilusão de "Organização por Cliente" no Front-End sem sujar a Arquitetura limpa SINKRA no Back-End (Data Base OS).
+
+## Validation
+
+✅ **Paradox Identified:** Domain-First Architecture (enforced abstraction) vs. Customer-Centric Visibility (commercial reality). The heuristic resolves this tension by separating concerns: structure follows domain logic at the root (Spaces), commercial perspective is layered through Views and intelligent filtering (Custom Fields, Tags).
+
+✅ **Architectural Integrity:** The principle maintains SINKRA's core mandate—clean separation between thinking (Strategic), managing (Tactical), and executing (Operational)—while providing Account Managers the visual experience they need without architectural compromise.
+
+✅ **Scalability Proof:** This pattern scales from 5 to 500+ customers without multiplying complexity at the workspace root; custom Views multiply, not Spaces.

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_094.md

@@ -0,0 +1,73 @@
+---
+id: "PV_KE_094"
+title: "The 5 Mandatory OS Fields (Metadata Anchor)"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "Implementation Phase"
+  - "Data Governance"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  tension_with: "PV_KE_045 (Declarative Behavior Token) — Rigid Metadata Mandates vs Fluid Behavior Extensibility"
+  resolution: "5 fields are immutable foundation; domain extensions wrap them without replacing the core tuple"
+---
+
+# PV_KE_094 - The 5 Mandatory OS Fields (Metadata Anchor)
+
+**Type:** Infrastructure Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:clickup-engineer
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 15: Configurando o ClickUp para Sinkra / Passo 2]
+
+## Purpose
+Garantir a rastreabilidade total de Meta-Linguagem do SINKRA dentro do Sistema Operacional visual (ClickUp, Jira). Esta heurística (Commandment) obriga a implementação de exatos 5 Campos Customizados Tipados em toda Raiz de Sistema, imutáveis e globais. Um card/task no ClickUp sem a marcação SINKRA (`executor_type`, `phase`, `sinkra_primitive`, `guardrail_status`, `quality_gate_result`) retrograda de Unidade Operacional rastreável para um "Post-it Digital inútil". Estes 5 parâmetros são a ligação matemática que acopla a camada abstrata da Ferramenta de YAML à camada prática da Interface Gráfica, permitindo filtragens exatas e acionamentos robóticos perfeitos por Views, Agentes e Trabalhadores Autônomos.
+
+## Configuration
+```yaml
+PV_KE_094:
+  name: "Sinkra Metadata Anchor Constraint"
+  zone: "zone_0.8"
+  trigger: "Fase 7 - Implementation. O Arquiteto ou ClickUp Engineer formata os Arrays de Meta-Dados da Instância Base do Software de Gestão."
+  evidence_threshold: "structural_logic"
+  rule: |
+    TODA Tarefa/Workflow no Sistema Operacional Front-End DEVE carregar os 5 Atributos:
+    1. executor_type (Dropdown) -> Human, Agent, Worker, Clone.
+    2. phase (Number/Dropdown) -> 1 a 9 (Estágio da arquitetura).
+    3. sinkra_primitive (Dropdown) -> Atom, Molecule, Organism, Template, Instance.
+    4. guardrail_status (Checkbox) -> Flag Boolean de auditoria de restrição.
+    5. quality_gate_result (Dropdown) -> APPROVE, REVIEW, VETO, N/A.
+    Se a Ferramenta Visual não suportar tipagem rígida, não a utilize para operar Organismos Complexos. Se um Card SINKRA descer para produção sem estar plotado por estas 5 coordenadas, suspenda a automação atrelada.
+```
+
+## Decision Tree
+```javascript
+IF (mapping_SINKRA_YAML_constructs_into_a_Frontend_Task_Tracker)
+  STEP_1: EXAMINE the Custom Fields / Columns implementation.
+  STEP_2: ENFORCE the Basic Universal Tuple.
+    IF (The Team proposes: 'We just need Assignee, Priority, and Due Date. Let\\'s skip the Primitive dropdown.')
+      -> VETO: If you don't know the Primitive, you don't know its behavior rules, nesting rights, or transition physics. If you don't have executor type, Automations cannot filter by Agent triggers. You lose SINKRA OS completely.
+    IF (The Team adds 40 specific client fields but anchors them along with the 5 SINKRA Fields at the Domain Level Space.)
+      -> ACCEPT: The 5 fields are the minimum, universal standard. Expansions are allowed per domain context, but the foundation remains.
+NEVER:
+  Delegar o registro SINKRA de uma Tarefa Operacional para uma `Description` text livre ou `Sub-Taggings` caóticos soltos (Labels não tipados). A filtragem lógica na camada Banco de Dados/OS exige Variáveis Severas. Sem elas, seus Workers tentarão inferir strings em YAML Livre, e a precisão afunda.
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "O Campo Intrusivo Não Negocial"
+- **Trigger:** A Equipe exige dezenas de preenchimentos obrigatórios manuais no `Create Task` de uma plataforma, bloqueando Operadores (Humans) com os 5 Campos Técnicos quando o Frontend SINKRA poderia herdar tudo via Templates (Fase 6 - Passo 6).
+- **Manifestation:** Humanos precisam preencher exaustivamente "Isto é um Atom!", "Sou Fase 4!" sempre que criarem a Tarefa de uma Sub-Célula Tática no Board. Rejeição fortíssima da Equipe pela repetição insana. O software vira um poço de micro-burocracia, e ninguém preenche as Tasks novas.
+- **Detection:** Reclamações severas de lentidão na operação, e campos técnicos do SINKRA preenchidos aleatoriamente como "qualquer coisa" só para passar a condição do Front-End.
+- **Recovery:** Os 5 campos OBRIGATÓRIOS (PV_KE_094) devem vir **PRÉ-PREENCHIDOS VIA TEMPLATES** de Instanciamento (ClickUp Template, Automations On-Create). O Humano operando a ponta do funil raramente digita a meta-linguagem SINKRA. Ele preenche os Dados Táticos. A Automação carrega as 5 âncoras para rastreio estrutural (Blackbox para Humano na Criação, Transparente para Worker/Audit).
+
+### Omission / Failure to Activate: "O Frankenstein de Labels Coloridos"
+- **Trigger:** A Equipe tenta implementar a Hierarquia Primitiva (Níveis SINKRA) usando tags fofinhas coloridas sem Tipagem Estrita e sem Padronização ou escopos numéricos, mesclando "Agent" com "High Priority" com "Molecule" no mesmo mar de Labels.
+- **Manifestation:** O Backend Automação (Worker / N8N) precisa buscar dados por filtro de Tag no OS. Duas tags chamam "AGENT" e "Agent", e "Agnt". O Webhook não acha o alvo. O Worker não dispara porque não consegue dar um match Booleano ou Enum estrito no Array de Custom Fields soltos. O Sistema paralisa, silencioso, até a panela de pressão explodir e o time de Operações ficar correndo atrás do painel tentando entender quem quebrou.
+- **Detection:** Scripts rodando `Search_Field` sem retorno com logs vazios e processos em "In Progress" interminável.
+- **Recovery:** A Lei dos Custom Fields de Alta Coesão (PV_KE_094). As Fases (F1-F9), Executores Orgânicos e Tipologias Primitivas NUNCA HABITAM NO ESPAÇO CAÓTICO DOS LABELS MISTOS E LIVRES. OBRIGATÓRIO (MUST): Criação de Dropdowns Fechados (Enum Strict) na Camada Nativa (ClickUp/Jira/Notion).
+
+## Validation
+
+✅ **Paradox Identified:** Tension between immutable universal mandate (5 fields) and permissible domain-specific extensions.
+✅ **Resolution Applied:** Core tuple (5 fields) is inviolable foundation. Domain extensions are satellite fields, not replacements.
+✅ **System Tension Recorded:** `sys_tension` block captures duality for orchestration and decision trees.

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_095.md

@@ -0,0 +1,84 @@
+---
+id: "PV_KE_095"
+title: "Role-Based View Isolation (Anti-Noise UX)"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "Implementation Phase"
+  - "Execution Standards"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  - tension_with: "AN_KE_082 (Read Documentation Before Acting) vs Role-Based View Isolation"
+    resolution: "Isolamento operacional (PV_KE_095) EXIGE visibilidade tática de contexto macro (AN_KE_082). Resoluçao: Breadcrumbs + Read-Only contextuais substituem poluição de campos. Role-based filtering passa à frente, mas com navegação enriquecida para acesso ao macro sem poluir a view local."
+---
+
+# PV_KE_095 - Role-Based View Isolation (Anti-Noise UX)
+
+**Type:** Operator Interface Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:clickup-engineer
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 15: Configurando o ClickUp para Sinkra / Passo 4]
+
+## Purpose
+Garantir a adoção do Sistema de Gestão SINKRA através do extermínio visual. Esta heurística (Commandment) declara que "Ruído é o Inimigo Número Um da Adoção Operacional". O Arquiteto jamais deve construir ou forçar os Executores a usarem "A View Genérica", que exibe a totalidade do Processo Master, campos de Pipeline, status de Automação de Infraestrutura e métricas C-Level tudo junto para um Operador de ponta que só precisa anexar um arquivo. Cada Executor (Account Manager, Editor, Gerente) OBRIGATORIAMENTE deve possuir uma *View Isolada Privativa* que filtre agressivamente tudo que for estritamente inútil para o andamento do seu Primitivo/Token ou Átomo no Sistema SINKRA.
+
+## Configuration
+```yaml
+PV_KE_095:
+  name: "Strict View UX Filtration"
+  zone: "zone_0.8"
+  trigger: "Fase 7 - Implementation. O Arquiteto ou ClickUp Engineer configura Painéis, Listas e Vistas Públicas no Software Base SINKRA (Ex: Monday, Jira, Notion)."
+  evidence_threshold: "structural_logic"
+  rule: |
+    O Sistema Operacional Visual DEVE seguir o 'Role-Based Visibility Principle':
+    - Visão Operador (Human): Mostra apenas Tokens e Átomos designados e prazos curtos. Nada de Meta-YAML. Oculta Configurações de Agente/Worker.
+    - Visão Gerente: Mostra Agregação, Fluxos Bloqueados (VETOS) e Distribuição de Carga. NUNCA mergulha nos detalhes textuais menores do Executor de Fim de Linha em sua Board Diária Padrão.
+    - Se a View causa cansaço visual, o Executor volta à Planilha. O Time perde o State Flow, o SINKRA morre de asfixia não-tática. A configuração Modular da Visão deve ser radical.
+```
+
+## Decision Tree
+```javascript
+IF (designing_Front_End_dashboards_or_Kanbans_for_the_Human_Team)
+  STEP_1: EXAMINE the fields, columns, and tasks presented uniformly.
+  STEP_2: ENFORCE strict filtration based on the Role Matrix (Phase 3).
+    IF (An Audio Editor sees columns for "Meta_Quality_Score_Of_Campaign" or "Agent_System_Prompt_Link" or "C_Level_Approval_Flag")
+      -> VETO: You are burying the Operator in Architectural Noise. Their screen should only contain: "Briefing", "Audio File", "Deadline", "Done Button". Hide all Master SINKRA fields behind 'Show More' or completely.
+    IF (The Arquiteto creates distinct, locked views titled `View: Account Manager`, `View: Video Edit`, `View: Ops Director` with specific groupings and filters)
+      -> ACCEPT: Operational harmony. The system adapts to the Role, the Role does not adapt to the Matrix complexity.
+NEVER:
+  Achar que transparência é jogar o SQL Inteiro da Empresa no FrontEnd para "todos verem". Em OPs de Alta Densidade (Centenas de Projetos por sprint), dados sem relevância local causam Paralisia de Análise. A Arquitetura Híbrida deve ser visível na Raiz (Phase 2), mas invisível no Campo (Phase 7).
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "O Silo Asfixiante Oculto (Anti-Contexto)"
+- **Trigger:** A Equipe aplica o isolamento de forma tão ditatorial que o Operador (Editor de Vídeo, por exemplo) fica inteiramente cego de *Por Que* ou para *Onde* o Projeto vai. 
+- **Manifestation:** O Operador vê a Task "Editar Video 3" mas não consegue acessar a Campanha Macro (Molecule), nem ver em qual Rede vai ser publicado na Tática, recebendo informações esquartejadas.
+- **Detection:** Reclamações que a equipe virou uma "fábrica de botões apertados às cegas" onde não se consegue visualizar o Escopo Inteiro (O Big Picture) das Campanhas. O Engajamento morre.
+- **Recovery:** A Lei do Isolamento do Ruído (PV_KE_095) suprime CAMPOS E ETAPAS TÉCNICAS INÚTEIS. Ela NÃO suprime o Alinhamento. É OBRIGATÓRIO fornecer ao Executor Humano, no escopo local, um Read-Only Path ou Contextual Description (Documentos Associados / Breadcrumbs / Clickable Parent Folders) que deem sentido Espacial Operacional (Contexto rico), permitindo "Zoom-Out Clicando no Link da Campanha" mas sem poluir o "Inbox Principal Deles" de colunas.
+
+### Omission / Failure to Activate: "O Frankenstein Poluído"
+- **Trigger:** A Equipe cria o Board do ClickUp ou Sistema Equivalente no "Padrão Nativo", e manda o Link Geral da "List Master" para as Equipes Operacionais Trabalharem no Dia 1 de SINKRA, sem criar Views ou Permissões.
+- **Manifestation:** O Time abre o Software. Vê um Master Board Tático contendo 2.400 tasks com 38 Colunas Diferentes e Agrupadores Aleatórios, com Checkboxes Extraterrestres misturados ("Score_IA_Veto", "Retry_Status_N8N") e desiste. A adoção não vinga. O C-level culpa a ferramenta "complexa".
+- **Detection:** Frequente exportação de dados pro MS Excel para o time "entender melhor e dividir nas Dailies". A morte lenta da Centralidade de Dados SINKRA.
+- **Recovery:** Destruir a Exposição Livre. NENHUM MEMBRO não-master da Equipe deveria entrar (Default Board) no Board Principal Sem Filtros de um Processo Massivo (Organism/Instance level master view) sem um Filtro Rígido Pré-Salvo (`Me Mode`, `Role Mode`).
+
+---
+
+## Validation
+
+**Paradoxo Identificado:** Isolamento visual vs. Consciência contextual.
+
+A heurística resolve a tensão entre dois imperativos irreconciliáveis:
+1. **Ruído = Morte de Adoção:** Excesso de informação paralisa operadores de ponta (fábrica de botões cegos).
+2. **Cegueira = Desengajamento:** Isolamento radical sem alinhamento tático faz o executor perder o "Big Picture" (silo asfixiante).
+
+**Resolução operacional:** O isolamento é sobre *campos e coluna técnicas inúteis*, não sobre *contexto funcional*. Breadcrumbs, navegação pai/filha e descrições contextuais em Read-Only permitem acesso ao macro sem poluir a view local do micro. O operador vê apenas seu Átomo/Token primário, mas pode clicar para entender em que Molécula/Campanha ele está inserido.
+
+**Métricas de sucesso:**
+- Redução em 80%+ de exportações para Excel para "entender melhor"
+- Adoção Day-1 acima de 60% (sem treinamento extenso)
+- NPS operacional (não-master users) >= 7/10
+- Tempo médio de onboarding para novo role < 30 minutos
+
+**Aplicabilidade:** Fase 7 (Implementation) em sistemas SINKRA com 50+ operadores simultâneos, 3+ roles distintos, e 500+ tasks/sprint. 

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_096.md

@@ -0,0 +1,78 @@
+---
+id: "PV_KE_096"
+title: "Agents as Strict Function Contracts"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "AI Orchestration"
+  - "Execution Standards"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  tension_with: "PV_PA_005 (Directed Stochasticity) — Strict I/O contracts vs. variance-as-feature philosophy"
+  resolution: "Bifurcate outputs into two classes: (1) Metadata Keys (Status, Score, Category)—REQUIRED strict typing for orchestration integrity; (2) Body Content (Creative/Exploratory)—unrestricted string field. Schema hierarchy enforces metadata contracts while preserving cognitive freedom in content generation."
+---
+
+# PV_KE_096 - Agents as Strict Function Contracts
+
+**Type:** Epistemic Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:agent-generator
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 15: Configurando Agentes para Sinkra]
+
+## Purpose
+Aniquilar a ilusão perigosa de corporações usarem Inteligência Artificial Genérica Mística ("bota um ChatGPT lá e vê o que sai do texto"). Esta heurística define OBRIGATORIAMENTE que um Agente no ecossistema SINKRA não é um Chatbot de conversação livre. Um Agente é um `Executor Estocástico Controlado` operando estritamente dentro de uma Função com Tipagem de Entrada e Schema de Saída Rígido (Outputs Validados via JSON), submetido sempre a um Quality Gate SINKRA e contendo um Caminho de Escalonamento Humano Inegociável (Fallback). Pular esta restrição significa injetar "Alucinações" massivas indetectadas e erros silenciosos dentro das engrenagens Centrais de Decisão Tática da Operação, implodindo os Fluxos Sistêmicos SINKRA.
+
+## Configuration
+```yaml
+PV_KE_096:
+  name: "The Stochastic Executable Law (Strict I/O Agent Validation)"
+  zone: "zone_0.8"
+  trigger: "Fase 8 (Agent Generation). O Engenheiro de Prompt ou AIOX arquiteta a instância que substituirá o Human (Task) no sistema."
+  evidence_threshold: "coding_principles"
+  rule: |
+    TODA Arquitetura (Agent YAML) da Instância de IA DEVE preencher a Matriz Mínima Funcional Sem Exceção:
+    - 1. inputs -> [Tipados (URL, String, Booleano)].
+    - 2. outputs -> [Schema JSON OBRIGATÓRIO (Arrays, Floats, Estruturas Físicas)].
+    - 3. quality_gate -> Qual Bot PV audita e qual Threshold Mínimo.
+    - 4. escalation -> Pathing de Queda (O que faz se alucinar ou tirar nota < 60?).
+    Nenhum Agente no SINKRA retorna 'Texto Livre'. Agentes não são conselheiros de chat; são Funções de Transformação de Dados e Lógica com Contratos Rascunhados (System Prompts versionados externalizados).
+```
+
+## Decision Tree
+```javascript
+IF (creating_or_approving_an_Agent_role_in_the_Architecture)
+  STEP_1: EXAMINE its Output format.
+  STEP_2: ENFORCE exact Schema constraints and fail-safes.
+    IF (The Team proposes: 'The Agent reads the PDF and generates a paragraph summarizing the meeting to the team.')
+      -> VETO: 'Missing Schema, missing scoring, missing escalation. A paragraph of text cannot be reliably caught and processed by the next Worker or Tool in an automated flow.'
+    IF (The Team proposes: 'The Agent reads the PDF. OutputSchema={score: float, action_items: array[string], status: enum(ready, needs_human)}. Falls back to Human PM on Error or bad JSON format.')
+      -> ACCEPT: Operational integrity. The Stochastic black box has become a predictable Contractual Node SINKRA.
+NEVER:
+  Confundir as Ferramentas Livres (Interface Claude.ai) com Camadas de Automação Empresariais Rígidas (SINKRA/AIOX OS). Um Sistema não tolera "Eu acho que tá bom". Ou um Schema bate de forma binária com a estrutura requerida ou explode sob falha crítica antes de gravar no Supabase/ClickUp.
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "Engessamento Absurdo (A Morte do Raciocínio Base)"
+- **Trigger:** O Time de Arquitetura força Agentes a emitirem Outputs Numéricos, Json super complexos e tabelas gigantescas para situações altamente dinâmicas onde a função raiz primária P0 solicitada ao LLM exigia "Exploração Empática ou Geração Livres de Idéias Literárias" que posteriormente passariam por revisão total de um Chief Criativo Diretor (Clone SINKRA).
+- **Manifestation:** O Agente de "Brainstorming Copywriting" engasga com quebras de formatação no JSON, passando mais instrução técnica de código do que usando as 8 Bilhões de Parâmetros dele para criar bons roteiros, inutilizando a fase Criativa. O Pipeline fica burro.
+- **Detection:** Retornos de erro (`Parsing Error`) constantes da IA enquanto tenta encaixar um Roteiro de Vídeo em um Array Multidimensional, sem nunca focar no resultado linguístico esperado.
+- **Recovery:** A Lei de Tipagem Rígida (PV_KE_096) vale para a INJEÇÃO DE METADADOS de FLUXO (Status, Score, Categorizações) da Arquitetura Covalente. Para Trabalhos Criativos, a Tipagem Rígida encabeça uma chave como `Body_Content: String`, onde a Inteligência tem espaço irrestrito e puro. E se a Task for muito criativa, o `Output Formal` é a Submissão, e o Validador SINKRA Posterior emite a Nota. 
+
+### Omission / Failure to Activate: "O Desastre Silencioso da Alucinação Solta"
+- **Trigger:** Configurações rápidas onde um Desenvolvedor atrela o Node Central "HTTP Request - OpenAI" que devolve o bloco genérico "Content" de volta para o Frontend Cliente, salvando direto.
+- **Manifestation:** Na Quarta, o Modelo muda para a Versão Subsequente Minor no Backend do provedor, ele muda sutilmente o Estilo de Tones para "Explicações Filosóficas", o Pipeline começa a enviar mensagens não-padronizadas, emails estranhos, e no caso da análise técnica, devolve respostas como "Me desculpe, não posso prosseguir", enquanto o Software Frontal grava no Log a flag "Complete" e encerra o Processo do Cliente 1241. Total Falência Tática Invisível.
+- **Detection:** Agentes gravando Alucinações Óbvias ou Logs Defensivos de Segurança da OpenAI/Anthropic direto num Database Institucional.
+- **Recovery:** Matação Preventiva de LLM. Se o Modelo de IA gerar texto ou resposta que violou o Schema de Contract Validado e os Scripts JSON SINKRA (Sendo captado no Retry ou Try/Catch), o Framework imediatamente DELETA O OUTPUT, loga falha estrutural, tenta Retry e Aborta de forma barulhenta enviando alerta Humano. Agentes Mudos não danificam Tabelas Master.
+
+## Validation
+
+**Paradox Resolved:** The tension between rigid typing and creative freedom is resolved by schema bifurcation—metadata keys (status, score, category) remain strictly typed for orchestration safety, while content bodies preserve unrestricted string capacity for exploratory/creative work. This maintains both operational integrity and cognitive autonomy.
+
+**Application Criteria:**
+- ✅ Use strict typing for ALL orchestration metadata (inputs, status flags, scoring, escalation signals)
+- ✅ Use unrestricted string fields (body_content, reasoning, explanation) for creative or exploratory outputs
+- ✅ Validate metadata schema binarily (pass/fail with fallback-to-human on schema violation)
+- ✅ Log content generation separately from schema validation—content quality goes to QA human gate, schema violations go to system emergency abort
+
+**Enforcement:** Agents violating this bifurcated contract (mixing creative output into typed metadata keys, or omitting escalation paths) must be rejected at architecture review (PV_KE_096 violation → VETO).

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_097.md

@@ -0,0 +1,79 @@
+---
+id: "PV_KE_097"
+title: "The Automation Engine Triad (Worker Resilience)"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "Implementation Phase"
+  - "Resilience Standards"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  tension_with: "AN_KE_073 (Parallel Subagents for Throughput) vs Logging Obligatório em Automação N8N"
+  resolution: "Structural logging at 3 checkpoints (Initiation, Critical Tactical Results, Termination) prevents performance degradation while maintaining operational visibility."
+---
+
+# PV_KE_097 - The Automation Engine Triad (Worker Resilience)
+
+**Type:** Infrastructure Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:clickup-engineer
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 15: Configurando o N8N para Sinkra]
+
+## Purpose
+Padronizar a sanidade da Camada 2 (Motor de Automação) e proibir que Workers sejam construídos como scripts frágeis de "Happy Path" (caminho feliz). Esta heurística impõe três regras inquebráveis para sistemas como N8N: 1) Nomenclatura Formal (Sem nomes genéricos), 2) Webhook Validation Head (Validação rígida do payload de entrada antes de processar), e 3) Global Error Handling (Auditória centralizada em Banco de Dados). Se um Worker SINKRA processa 10 etapas num workflow sem validar os dados de entrada na porta, ou sem ter um nó de tratamento de erro e log no banco ao falhar/acertar, ele não é uma Automação; é uma Bomba-Relógio de débito técnico.
+
+## Configuration
+```yaml
+PV_KE_097:
+  name: "Rigid N8N Operational Standard"
+  zone: "zone_0.8"
+  trigger: "Fase 7 - Implementation. O Engenheiro de Automação (Worker Core) desenha o Workflow Determinístico."
+  evidence_threshold: "coding_principles"
+  rule: |
+    O Sistema DEVE aderir à Tríade SINKRA em TODA Automação:
+    - 1. Naming: [PROCESSO] [FASE] - [DESCRIÇÃO] (Ex: [TTCX] Fase 1 - Abertura).
+    - 2. Webhook Firewall (Validation): O Node Inicial recebe a requisição, se faltam chaves/tipos no JSON ou ID Banco, retorna 'HTTP 400 Bad Request' Instantaneamente (Fail-Fast) sem processar nada.
+    - 3. Logging Obligatório: Toda execução (Erro Crítico ou Sucesso Supremo) deságua num Node Final de Inserção na Tabela de Auditoria (Timestamp, Status, Payload Summary, Error). Erros Críticos sem tratamento silenciam a visibilidade operacional da corporação.
+```
+
+## Decision Tree
+```javascript
+IF (evaluating_an_Automation_Engine_Workflow_in_N8N_or_Temporal)
+  STEP_1: EXAMINE the Entry Node, Naming, and Error flow connections.
+  STEP_2: ENFORCE the Triad.
+    IF (The Team proposes: 'Workflow Name: Send Email Client. Webhook -> Send Email. Done.')
+      -> VETO: Chaos configuration detected. Naming violates the indexing rule. There is no payload validation before the Action. There is no DB Logger attached to catch failures if Sendgrid/Gmail is down. Reject architecture.
+    IF (The Team proposes: '[TTCX] Fase 3 - Creator Ranking. Webhook validates JSON. Error trigger logs to Supabase `automations_log` and alerts Slack. End nodes log success execution details.')
+      -> ACCEPT: Operational Resilience guarantees predictability and real-time observability.
+NEVER:
+  Confiar exclusivamente no Painel Gráfico nativo do sistema SaaS (Ex: Histórico do Zapier ou N8N Screen Logs) para auditoria. Esse log efêmero apaga em semanas e não pertence à Camada 4 (Dados da Corporação). Todo status deve existir persistido no Supabase/Postgres via log manual algorítmico do Worker.
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "O Logging Esquizofrênico Massivo"
+- **Trigger:** A Equipe leva a heurística de Logging Supabase ao extremo técnico irracional, criando um nó HTTP para inserir dados de Log no Banco DEPOIS DE CADA PASSO INDIVIDUAL dos 100 Nodes de um Workflow da Camada 2 (Excesso Ruidoso).
+- **Manifestation:** O Supabase atinge centenas de gigabytes de logs granulares imprestáveis. A própria tentativa de "Logar cada Suspiro do Robô" multiplica as chamadas API a um nível que o Workflow principal engasga por Latência Crítica auto-infligida e excede o limite estrito da API do Banco.
+- **Detection:** Reclamações que a Automação leva 25 segundos para terminar cálculos de JSON puro porque a Rede está sobrecarregada de Telemetria Intercore Inútil.
+- **Recovery:** A Tríade da Resiliência SINKRA (PV_KE_097) impõe o Log no Sub-Flow Estrutural: 1. `Início (Execution Initiated)`, 2. `Resultados Importantes Táticos` (Campos SINKRA e Integrações Cruciais em Batch), 3. `Terminação (Success / Catastrophic Exit Error)`. Nunca log de variáveis intermediárias voláteis, a não ser no Debug NATIVO do Engine. 
+
+### Omission / Failure to Activate: "O Webhook Cego de Boa Fé"
+- **Trigger:** Configurações preguiçosas onde o Engenheiro, apressado, plota Webhooks com método genérico e não coloca validação `If Node = payload.client_id Exists?` porque ele "configurou direito lá no Front-End".
+- **Manifestation:** Dois dias depois, a Estrutura do Json Muda na Origem ou o ClickUp sofre um bug. O Webhook Recebe os Dados em Branco. Tráz Nulls. As próximas 15 APIs engolem Zero e Null, gravam lixo corrompido em bancos cruzados do Cliente, Apagam Campos por Overwrite de Empty String, e derrubam o CRM Inteiro.
+- **Detection:** Frequente exportação de dados pro MS Excel para o time "consertar os furos" de uma destruição em cadeia gerada na calada da noite e perda da Fonte de Verdade de 800 Projetos.
+- **Recovery:** Obrigatoriedade do Padrão "Webhook Firewall". Nenhum Webhook SINKRA faz processamento nativo. Ele chama o Gatekeeper. "Dado falhou Tipagem? -> Http 400. Die." (Fail Fast Protege o Banco Coração).
+
+---
+
+## Validation
+
+✅ **Paradox Identified:** The tension between "Logging Obligatório" (completeness requirement) and "O Logging Esquizofrênico Massivo" (performance degradation risk) is fundamental to this heuristic.
+
+✅ **Resolution Applied:** Structural logging at 3 checkpoints (Initiation, Critical Tactical Results, Termination) resolves the paradox by distinguishing between *granular operational visibility* (necessary) and *per-step telemetry logging* (harmful). This maintains the integrity of PV_KE_097's core mandate: resilience without system suffocation.
+
+✅ **Implementation Checkpoint:** Any N8N workflow claiming PV_KE_097 compliance must demonstrate:
+- Entry node validation (HTTP 400 on schema failure)
+- Exactly 3 structural log insertion points (not per-step logging)
+- Terminal audit trail persistence in Supabase/Postgres
+
+⚠️ **Risk Vector:** Teams misinterpreting "Logging Obligatório" as per-node telemetry will violate system performance SLAs. Enforcement tool must flag workflows exceeding 3 log insertion points as **non-compliant**.

package/pro/squads/squad-creator-pro/minds/pedro_valerio/heuristics/PV_KE_098.md

@@ -0,0 +1,85 @@
+---
+id: "PV_KE_098"
+title: "Documentation as Prospective Instrument"
+mind: "pedro_valerio"
+type: "heuristics"
+tags:
+  - "Documentation Phase"
+  - "Process Governance"
+pipeline_instances:
+  - "hybrid-ops"
+sys_tension:
+  tension_with: "AN_KE_082 (Read Documentation Before Acting) vs Prospective Brevity (SOS-only Runbooks)"
+  resolution: "Tiered documentation: Layer 1 (Emergency Runbooks - SOS only), Layer 2 (Macro Workflows - decision trees), Layer 3 (Archive: complete narrative for institutional memory). Operators use Layer 1-2; historians reference Layer 3."
+---
+
+# PV_KE_098 - Documentation as Prospective Instrument
+
+**Type:** Epistemic Heuristic
+**Zone:** 🧠 0.8% Genialidade | **Agent:** @hybridOps:doc-generator
+**Source:** [SOURCE: SINKRA-v4.md | Capítulo 14: Fase 9 - Documentation & Compliance]
+
+## Purpose
+Exterminar a visão corporativa tóxica de que a Documentação de um Processo é o "registro burocrático de um feito heróico do passado" (Retrospectiva inútil). Esta heurística re-qualifica a Documentação da Fase 9 SINKRA como um `Instrumento Prospectivo de Operação`. O Arquivo Gerado (Runbook, Manual, Blueprint) NÃO serve para provar aos donos o que foi desenhado na Fábrica; ele serve única e exclusivamente para habilitar e garantir a Operação Segura do dia de Amanhã pela Pessoa Substituta. Um Runbook retrospectivo diz "Eu montei isto assim". Um Runbook Prospectivo diz "Leia-me para operar a máquina sem destruí-la quando ocorrer a Falha Z". Documentação que não executa o futuro é Desperdício Tático.
+
+## Configuration
+```yaml
+PV_KE_098:
+  name: "Prospective Runbook Veto"
+  zone: "zone_0.8"
+  trigger: "Fase 9 - Doc & Compliance. O Time de Arquitetura SINKRA emite as documentações finais antes do Go-Live Total."
+  evidence_threshold: "structural_logic"
+  rule: |
+    A Documentação (Phase 9) DEVE se abster de narrativas autobiográficas ('decidimos assim porque...').
+    O Blueprint Oficial foca rigorosamente em:
+    1. Compliance_Report de Gaps Finais.
+    2. Runbooks Sistêmicos Ativos (O que o Operador faz se X explodir?).
+    3. Manuais de Treinamento Ríspidos para Humanos e Inputs/Outputs dos Agentes e Clones.
+    Se um Documento descritivo tem 47 Páginas explicando a motivação subjetiva de como o Bot envia um Email, ele é classificado como Vaidade, deve sofrer deleção e dar lugar a 1 Página Operável (Cheatsheet / Troubleshooting Map).
+```
+
+## Decision Tree
+```javascript
+IF (evaluating_the_final_documentation_handoff_for_the_Project)
+  STEP_1: EXAMINE the structure of the Textual Mappings.
+  STEP_2: ENFORCE operational pragmatism.
+    IF (The Team writes a Historical Log 'Project Origins and How We Improved the Flow in Phase 2' containing zero actionable data for tomorrow's team)
+      -> VETO: Autobiographical Bloat. No Human Executor needs to read the team's diary. Remove it. Move it to a `case_study` vault if marketing demands it.
+    IF (The Team produces `Troubleshooting Guide: Fase 4` and `Human Overrides for AI Clones`)
+      -> ACCEPT: Operational Instrument. Anticipating the breakdown and mapping the Bypass is Prospective Defense.
+NEVER:
+  Confundir Documentação para C-Level (Pitch Deck) com Documentação de Chão de Fábrica SINKRA (Protocolos de Aborto, Limites de Operação N8N). O Documento deve agir como o Painel Interno de Manutenção da Turbina. Feio, Curto, Numérico, e Letalmente eficiente.
+```
+
+## Failure Modes
+
+### Misapplication / Excess: "O Manual de Instrução Ditatorial e Inflexível"
+- **Trigger:** A Equipe compila Runbooks tão massivos, restritos e com milhares de regras condicionais e fluxogramas intrincados sobre como colocar um Título que o Custos de Treinamento Humano chegam a durar Meses para Operações simples.
+- **Manifestation:** Humanos recusam-se a ler Livros de 200 Páginas com `Condições de Erro Micro-Operacionais`, operam na tentativa-e-erro intuitiva nativa, e tomam esporros de Compliance porque O Documento dizia que ele devia "clicar três vezes na aba Y caso o Botão W piscasse a Cor Vermelha". Paralisia Ocupacional Crônica. 
+- **Detection:** Reclamações que a burocracia do SINKRA excedeu a agilidade orgânica e os colaboradores sentem-se oprimidos pela quantidade de PDFs Gerados na Fase 9.
+- **Recovery:** A Restrição Prospectiva (PV_KE_098) impõe Guias e Manuais que tratam do Fluxo Macro e Casos de Ruptura Crítica. Se uma ação é básica não a documente. O Runbook é um Cheat-Sheet (Mapa Mental de Resgate / SOS Guardrails) e as diretrizes principais do Negócio, ele não ensina o Humano a Usar um Computador Básico. Mantenha os PDFs Mínimos e Potentes.
+
+### Omission / Failure to Activate: "O Herói Instável e Sua Ausência de Mapas"
+- **Trigger:** Configurações rápidas onde o Engenheiro ou Arquiteto diz que a Interface OS (ClickUp / N8N) `é tão interativa que se documenta sozinha`, e não há necessidade de Geração de Manuais pois quem "entende de SINKRA, opera qualquer painel construído no Front-end".
+- **Manifestation:** Seis meses depois o Engenheiro Fundador Sai da Empresa de Férias ou Fica Doente. O N8N dá timeout na Integração do Banco OMIE porque o Token Caiu. A Equipe Tática olha para 166 parâmetros do Bot que não contém Nenhum Cheat-Sheet PDF com Troubleshooting, Senhas Encriptadas ou Contratos. O Flow inteiro Para e a Empresa Sangra Caixa por horas até descobrirem na tentativa-e-erro "onde" o robô estava falhando no meio das Dezenas de Instâncias Criadas.
+- **Detection:** Empresa Fica Inteiramente Dependente da Memória Muscular (Silos Cognitivos de Humanos específicos). Ponto de Falha Crítica Pessoalizado (SPOF - Single Point of Failure).
+- **Recovery:** Execução Imediata de Engenharia Reversa e Auditing. Se um Bot de Operação Contínua Ativa não estiver Indexado Num Inventário Operacional com Instrução de Reboot, Backup ou Rollback no Sistema, o Criador Quebra as Leis P0 de Sustentabilidade Corporativa. O Código é Perecível; O Contexto é a Salvação.
+
+---
+
+## Validation ✓
+
+**Paradoxo Identificado:**
+A heurística PV_KE_098 contém uma tensão sistêmica entre dois imperativos contraditórios:
+- **Minimalismo Operacional:** "Runbook é um Cheat-Sheet, não ensina Uso Básico de PC" (linha 57)
+- **Completude de Compliance:** "Indexado Num Inventário Operacional com Instrução de Reboot, Backup ou Rollback" (linha 63)
+
+Um operador precisará de informações básicas para executar Reboot se nunca viu o painel antes, e um manual "minimalista" pode omitir exatamente o que falta.
+
+**Resolução (Implementada via sys_tension):**
+Documentação em 3 camadas hierárquicas separa audiência por urgência:
+1. **SOS Runbook** (1-3 páginas): Apenas casos de ruptura crítica
+2. **Workflow Macro** (5-10 páginas): Fluxos decisórios principais, com glossário
+3. **Archive Narrativo** (completo): Contexto histórico e decisões (repositório, não manual de operação)
+
+Operador vai direto às camadas 1-2. Arquiteto acessa camada 3 para auditoria. Nunca um documento servir múltiplos papéis.