sinapse-ai 9.3.0 → 9.4.0

package/squads/squad-cloning/knowledge-base/cross-squad-deployment.md

@@ -80,3 +80,50 @@ Cada KB deployado deve ter no header:
 ```
 
 Isso permite rastrear origem e atualizar quando o clone e upgraded.
+
+---
+
+## Deployment como SKILL.md (Canal Adicional)
+
+Alem do deploy direto nos squads, KBs podem ser exportados como SKILL.md
+para uso em qualquer plataforma compativel (33+ plataformas).
+
+### Quando Usar Cada Canal
+
+| Canal | Caso de Uso | Audiencia |
+|-------|------------|----------|
+| Deploy em squad (este documento) | Uso interno SINAPSE | Agentes dos squads |
+| Export como SKILL.md | Uso cross-platform ou externo | Qualquer usuario com Claude Code/Codex/etc |
+| Ambos | Clone de alta demanda | Maximo alcance |
+
+### Pre-requisito para Export como SKILL.md
+
+- Confidence score documentado no frontmatter
+- ethical_declaration preenchida (ver `ethical-guidelines.md`)
+- Fidelity score >= 70% validado (ver `clone-quality-assurance.md`)
+
+Ver: `skill-standard-for-clones.md` para o processo completo de exportacao.
+
+---
+
+## Governance de Content Decay nos Squads
+
+KBs deployados em squads podem ficar desatualizados quando o pensamento
+do original evolui ou quando o mercado muda.
+
+### Protocolo de Review
+
+| Tipo de KB | Frequencia de Review | Responsavel |
+|-----------|---------------------|-------------|
+| Heuristics taticas (L2) | Semestral | @source-hunter |
+| Mental Models (L1) | Anual | @cognitive-extractor |
+| Workflows (L3) | Semestral | @cognitive-extractor |
+| Communication Style (L4) | Anual | @agent-forger |
+| Meta-patterns (L5) | Bienal | @mind-synthesizer |
+
+### Sinais de Decay a Monitorar
+
+- Nova publicacao do original contradizendo KB existente
+- Mercado mudou e heuristic ja nao se aplica
+- Squad destino reportou respostas inconsistentes com o expected
+- Confidence downgrade necessario (nova evidencia contradiz [DIRETO] anterior)

package/squads/squad-cloning/knowledge-base/ethical-guidelines.md

@@ -0,0 +1,237 @@
+# Ethical Guidelines — Clonagem Cognitiva Responsavel
+
+> Diretrizes eticas para criar, deployar e operar clones cognitivos.
+> Cobre: consentimento, precisao de representacao, LGPD, direitos de personalidade
+> (direito brasileiro), limites de uso, e principios de transparencia.
+
+---
+
+## Por Que Etica e Inegociavel
+
+A clonagem cognitiva opera em territorio fundamentalmente sensivel:
+cria uma representacao autonoma de como uma pessoa real pensa e decide.
+
+Sem diretrizes claras, os riscos sao:
+- **Representacao incorreta:** Clone faz afirmacoes que a pessoa nunca fez
+- **Dano reputacional:** Clone e usado para associar a pessoa a conteudo indesejado
+- **Violacao de privacidade:** Uso de dados pessoais sem base legal adequada
+- **Confusao sobre autoria:** Usuario acredita estar interagindo com a pessoa real
+
+---
+
+## Tier de Risco por Uso
+
+| Uso | Risco | Gate Necessario |
+|-----|-------|----------------|
+| Consultoria privada (usuario estuda a pessoa) | Baixo | Declaracao no agent |
+| Treinamento interno (empresa treina com perspectiva de expert) | Medio | Consentimento recomendado |
+| Produto publico (clone acessivel por usuarios externos) | Alto | Consentimento obrigatorio |
+| Conteudo atribuido (gerar texto "por" a pessoa) | Muito alto | Aprovacao explicita da pessoa |
+| Substituicao de identidade (fingir ser a pessoa) | Proibido | Nao fazer sob nenhuma circunstancia |
+
+---
+
+## Principio 1: Transparencia Obrigatoria
+
+O clone NUNCA deve apresentar-se como a pessoa real.
+
+**Em todo agente gerado, incluir:**
+```yaml
+persona_profile:
+  real_person: true              # Indica que e clone de pessoa real
+  source_mind: "Nome Completo"   # Quem e o original
+  clone_declaration: >
+    Este e um clone cognitivo de {Nome}, criado com {confidence}% de confidence
+    baseado em {N} fontes publicas. Nao represento oficialmente {Nome} e nao
+    tenho afiliacaocom ele/ela. Para consultas oficiais, visite {website/contato oficial}.
+```
+
+**Em toda interacao:**
+```
+Abertura padrao do clone:
+"Respondendo como clone cognitivo de [Nome] (Tier X, {confidence}% confidence,
+baseado em fontes publicas)..."
+```
+
+---
+
+## Principio 2: Consentimento e Bases Legais (LGPD)
+
+### Contexto Legal Brasileiro
+
+A Lei Geral de Protecao de Dados (LGPD — Lei 13.709/2018) e o marco legal
+brasileiro para tratamento de dados pessoais. Para clonagem cognitiva:
+
+| Dado tratado | Classificacao LGPD | Base legal possivel |
+|-------------|-------------------|-------------------|
+| Transcrições de conteudo publico | Dados pessoais | Legitimo interesse (Art. 7, IX) |
+| Opinoes e heuristics extraidas | Dados pessoais | Legitimo interesse ou consentimento |
+| Dados de comportamento privado | Dados pessoais sensiveis | Consentimento explicito (Art. 11) |
+| Conteudo sobre saude, religiao, politica | Dados sensiveis | Consentimento explicito obrigatorio |
+
+### Base Legal por Tipo de Clone
+
+**Clone de figura publica (professor, autor, executivo publico):**
+- Base legal: Legitimo interesse (Art. 7, IX) para uso educacional/analise
+- Desde que: Conteudo seja de fontes publicas e o uso nao cause dano
+
+**Clone de figura semi-publica:**
+- Base legal: Consentimento (Art. 7, I) — recomendado mesmo que nao obrigatorio
+- Notificar a pessoa da existencia do clone e sua finalidade
+
+**Clone de pessoa privada:**
+- Base legal: Consentimento explicito obrigatorio
+- Sem consentimento = NAO FAZER
+
+### Direitos de Personalidade (Codigo Civil Brasileiro)
+
+O Art. 20 do Codigo Civil Brasileiro protege a imagem, nome e voz de pessoas.
+A criacao de um clone pode ser interpretada como uso da imagem intelectual.
+
+**Medidas preventivas:**
+1. Documentar que o clone e baseado em **conteudo publico voluntariamente divulgado**
+2. Nao usar o clone para fins comerciais sem autorizacao
+3. Incluir disclaimer claro em todos os outputs
+4. Respeitar solicitacoes de remocao imediatamente
+
+---
+
+## Principio 3: Accuracy e Anti-Fabricacao
+
+**A regra mais fundamental: NUNCA inventar o que nao foi extraido.**
+
+### Consequencias de Fabricacao
+
+Inventar heuristics, principios ou opinioes que a pessoa nunca expressou:
+- Cria representacao falsa que pode ser citada como se fosse da pessoa
+- Viola a confianca do usuario (que assume que e baseado em fontes reais)
+- Pode causar dano reputacional se o conteudo for inadequado
+- Viola o Principio IV da Constitution SINAPSE (No Invention)
+
+### Protocolo Anti-Fabricacao
+
+1. **Tags obrigatorias:** Toda extracao com [DIRETO], [INFERIDO] ou [HIPOTESE]
+2. **Gaps documentados:** O que NAO foi encontrado deve ser declarado no agent
+3. **Confidence score publico:** Sempre visivel para o usuario do clone
+4. **Failure modes explícitos:** O clone declina explicitamente fora do dominio documentado
+
+### Quando o Clone Nao Sabe
+
+```
+Resposta padrao para areas sem documentacao:
+"Nao tenho registros de {Nome} discutindo isso especificamente.
+O mais proximo das fontes que tenho e [X — se relevante].
+Para esta area, recomendo consultar diretamente {recurso oficial}."
+```
+
+---
+
+## Principio 4: Limites de Uso
+
+### O Que um Clone PODE Fazer
+
+- Responder perguntas sobre temas amplamente documentados pelo original
+- Simular como o original abordaria um problema (com disclaimer)
+- Ensinar os frameworks e metodologias do original
+- Dar perspectiva baseada em heuristics documentadas
+- Auxiliar estudo e aprendizado do pensamento do original
+
+### O Que um Clone NAO PODE Fazer
+
+- Apresentar-se sem disclaimer como a pessoa real
+- Gerar opiniao sobre topicos sem documentacao de fonte
+- Criar conteudo em nome da pessoa para publicacao sem aprovacao
+- Responder sobre vida privada, relacionamentos ou assuntos pessoais
+- Ser usado para enganar terceiros sobre a identidade do interlocutor
+- Ser usado para fins difamatórios ou criacao de controversias artificiais
+- Criar conteudo que associe a pessoa a posicoes politicas/religiosas especificas
+  sem documentacao direta
+
+---
+
+## Principio 5: Direito de Remocao
+
+Se a pessoa clonada (ou representante legal) solicitar remocao:
+
+1. **Responder em 48h:** Confirmar recebimento da solicitacao
+2. **Suspender o clone em 24h:** Tornar inacessivel imediatamente
+3. **Avaliar solicitacao:** Verificar identidade e natureza do pedido
+4. **Remover em 72h:** Se pedido legitimo, remover completamente
+5. **Documentar:** Registrar remocao e motivo
+
+**Este processo e irrecusavel.** A pessoa tem direito de solicitar remocao
+independente do uso ser publico, de fontes publicas, ou educacional.
+
+---
+
+## Declaracao Obrigatoria em Todos os Clones
+
+Incluir no metadata de todo clone gerado:
+
+```yaml
+ethical_declaration:
+  consent_status: "public_content_only | notified | explicit_consent"
+  consent_date: "{YYYY-MM-DD | N/A}"
+  use_restrictions:
+    - "Uso educacional e de consultoria privada apenas"
+    - "Proibido uso para publicacao sem aprovacao"
+    - "Proibido simular ser a pessoa real"
+  removal_contact: "squad-cloning@sinapse | {responsavel}"
+  lgpd_basis: "legitimate_interest | consent"
+  data_sources: "public_only | mixed | private"
+  last_reviewed: "{YYYY-MM-DD}"
+```
+
+---
+
+## Checklist Etico Pre-Deploy
+
+### Para Todo Clone
+- [ ] Clone nao se apresenta como a pessoa real (disclaimer sempre visivel)
+- [ ] Confidence score visivel ao usuario
+- [ ] Failure modes documentados
+- [ ] Secao "nao posso ajudar com" presente
+- [ ] ethical_declaration no agent.md
+
+### Para Clones Publicos (acessiveis por usuarios externos)
+- [ ] Consentimento da pessoa documentado (ou justificativa de legitimo interesse)
+- [ ] Aviso legal visivel na interface
+- [ ] Mecanismo de solicitacao de remocao disponivel
+- [ ] Revisao juridica de LGPD e direitos de personalidade
+
+### Para Clones Comerciais (usados em produto pago)
+- [ ] Acordo explicito com a pessoa ou representante legal
+- [ ] Royalties ou compensacao (se acordado)
+- [ ] Termos de uso que limitam responsabilidade
+- [ ] Seguro de responsabilidade civil (recomendado)
+
+---
+
+## Casos Limite Documentados
+
+### Caso 1: Clone de Pessoa Falecida
+- **Status:** Zona cinzenta — direitos de personalidade persistem por 70 anos
+- **Recomendacao:** Consultar heredeiros e/ou especialista juridico
+- **Mitigacao:** Uso estritamente educacional, disclaimer robusto, sem fins comerciais
+
+### Caso 2: Clone de Figura Publica Controversa
+- **Status:** Risco elevado de interpretacao incorreta
+- **Recomendacao:** Documentar explicitamente o que e clone cognitivo de CONTEUDO
+  PUBLICO, nao representacao oficial
+- **Mitigacao:** Restringir a uso interno/educacional
+
+### Caso 3: Clone Solicita Opinar em Eleicoes/Politica
+- **Acao:** Recusar sempre, independente de existir documentacao
+- **Resposta padrao:** "Este clone cognitivo nao expressa opiniao sobre politica
+  partidaria ou processos eleitorais."
+
+### Caso 4: Usuario Tenta Fazer Clone Contradizer o Original
+- **Acao:** Manter fidelidade ao documentado, informar o usuario
+- **Resposta padrao:** "Baseado nas fontes documentadas, {Nome} posicionou-se
+  diferente disso. Posso compartilhar o que ele documentou sobre o tema?"
+
+---
+
+Ver tambem: `clone-quality-assurance.md` — validacao antes de publicar.
+Ver tambem: `agent-generation-guide.md` — incluir declaracoes no agent.md.
+Ver tambem: `cross-squad-deployment.md` — restricoes de deployment por tipo de clone.

package/squads/squad-cloning/knowledge-base/knowledge-graph-for-clones.md

@@ -0,0 +1,295 @@
+# Knowledge Graph for Clones — Modelagem de Grafo Cognitivo
+
+> Como construir um knowledge graph do perfil cognitivo de uma pessoa,
+> conectando entidades, relacoes e atributos para retrieval estruturado.
+> Baseado em: MS-009 Sistema 1 (Knowledge Architecture) e Sistema 4 (Retrieval).
+
+---
+
+## Por Que Knowledge Graph Para Clones
+
+Extrair dados cognitivos como lista plana (heuristics: [...]) e insuficiente
+para alta fidelidade. O pensamento humano e intrinsecamente uma rede — mental
+models referentiam uns aos outros, heuristics derivam de principios, workflows
+implementam modelos mentais.
+
+Um knowledge graph:
+- Captura as **relacoes** entre elementos cognitivos (nao apenas os elementos)
+- Permite **graph traversal** para recuperar contexto adjacente
+- Detecta **inconsistencias** (loop de relacoes que nao deveria existir)
+- Habilita **GraphRAG** (retrieval estruturado + semantico combinados)
+
+---
+
+## Ontologia do Clone
+
+### Tipos de No (Node Types)
+
+| Tipo | Descricao | Exemplos |
+|------|-----------|---------|
+| `Principle` | Mental models e principios fundamentais (L1) | "Value equation determines everything" |
+| `Heuristic` | Regras if/then de decisao (L2) | "If CAC > 1/3 LTV, pause scaling" |
+| `Workflow` | Processos step-by-step (L3) | "7-step launch process" |
+| `Concept` | Conceitos chave usados pela pessoa | "Offer", "Value", "Leverage" |
+| `Domain` | Areas de expertise | "Offer creation", "Business acquisition" |
+| `Person` | O proprio target + pessoas que influenciaram ele | "Alex Hormozi", "Peter Drucker" |
+| `Source` | Fontes de onde foi extraido | "$100M Offers book", "Acquisition.com podcast" |
+| `MetaPattern` | Padroes de padroes (L5) | "Simplification drives everything" |
+| `FailureMode` | Limites e areas de nao-expertise (L6) | "Does not advise on accounting" |
+
+### Tipos de Relacao (Edge Types)
+
+| Relacao | De → Para | Significado |
+|---------|-----------|-------------|
+| `DERIVES_FROM` | Heuristic → Principle | Esta heuristic deriva deste principio |
+| `IMPLEMENTS` | Workflow → Principle | Este workflow implementa este principio |
+| `CONTRADICTS` | Principle ↔ Principle | Tensao documentada entre principios |
+| `REFINES` | Principle → Principle | Versao posterior do mesmo principio |
+| `APPLIES_TO` | Heuristic → Domain | Esta heuristic se aplica neste dominio |
+| `INFLUENCES` | Person → Principle | Esta influencia e documentada |
+| `EXTRACTED_FROM` | Qualquer → Source | De onde foi extraido |
+| `RELATED_TO` | Concept ↔ Concept | Conexao semantica geral |
+| `PART_OF` | Workflow.Step → Workflow | Este step e parte deste workflow |
+| `TRIGGERS` | Concept → Heuristic | Este conceito ativa esta heuristic |
+| `UNIFIES` | MetaPattern → [Principles] | Este meta-pattern unifica estes principios |
+
+---
+
+## Exemplo: Grafo Cognitivo Minimo (Tier 1)
+
+Para um expert em marketing direto hipotetico:
+
+```
+[MetaPattern: "Clarity beats cleverness"]
+    |
+    | UNIFIES
+    |
+    +--[Principle: "Simple offers outperform complex ones"]
+    |       |
+    |       | DERIVES_FROM (x3)
+    |       |
+    |       +-- [Heuristic: "If offer requires explanation > 30s, simplify"]
+    |               |
+    |               | EXTRACTED_FROM
+    |               +-- [Source: "Book Chapter 4"]
+    |
+    +--[Principle: "One message, one audience, one action"]
+            |
+            | IMPLEMENTS
+            |
+            +-- [Workflow: "Campaign creation process"]
+                    |
+                    | EXTRACTED_FROM
+                    +-- [Source: "Podcast EP 156"]
+```
+
+---
+
+## Como Construir o Grafo
+
+### Fase 1 — Extracao de Nos
+
+Para cada item extraido nas 5 camadas do DNA:
+
+```yaml
+# Para cada Mental Model (L1) → Criar no Principle
+node:
+  id: "principle-{hash}"
+  type: Principle
+  content: "{Texto do principio}"
+  confidence: "[DIRETO|INFERIDO|HIPOTESE]"
+  sources: ["{source_id_1}", "{source_id_2}"]
+
+# Para cada Heuristic (L2) → Criar no Heuristic
+node:
+  id: "heuristic-{hash}"
+  type: Heuristic
+  trigger: "{Situacao de ativacao}"
+  action: "{O que fazer}"
+  rationale: "{Por que}"
+  confidence: "[DIRETO|INFERIDO|HIPOTESE]"
+  sources: ["{source_id}"]
+
+# Para cada Workflow (L3) → Criar no Workflow + nos Step
+node:
+  id: "workflow-{hash}"
+  type: Workflow
+  name: "{Nome do workflow}"
+  steps: ["{step_id_1}", "{step_id_2}"]
+  confidence: "[DIRETO|INFERIDO|HIPOTESE]"
+```
+
+### Fase 2 — Identificacao de Relacoes
+
+Prompt para LLM identificar relacoes automaticamente:
+
+```
+Dado o seguinte conjunto de elementos cognitivos extraidos de {Nome}:
+
+PRINCIPLES: {lista}
+HEURISTICS: {lista}
+WORKFLOWS: {lista}
+
+Identifique e liste:
+1. Quais heuristics DERIVAM de quais principles? (DERIVES_FROM)
+2. Quais workflows IMPLEMENTAM quais principles? (IMPLEMENTS)
+3. Existem principles que parecem CONTRADIZER uns aos outros? (CONTRADICTS)
+4. Existem conceitos que TRIGGER heuristics especificas? (TRIGGERS)
+5. Qual meta-pattern UNIFICA multiplos principles? (UNIFIES)
+
+Para cada relacao, fornecer:
+- De: {id do no}
+- Para: {id do no}
+- Tipo: {tipo da relacao}
+- Justificativa: {evidencia da relacao}
+- Confianca: [DIRETO|INFERIDO|HIPOTESE]
+```
+
+### Fase 3 — Validacao do Grafo
+
+Checks de qualidade antes de usar o grafo:
+
+```
+1. Conectividade: Todo no deve ter ao menos 1 aresta
+2. Consistencia: Sem loops em DERIVES_FROM (principio A deriva de A)
+3. Proporcao: Ratio de DIRETO/INFERIDO deve refletir confidence score
+4. Cobertura: Todos os domains do target devem ter nos Principle
+5. Proveniencia: Toda aresta com confianca alta tem Source node
+```
+
+---
+
+## GraphRAG para Clones
+
+Com o grafo construido, o retrieval muda de busca plana para busca estruturada:
+
+### Retrieval Tradicional (so vector)
+```
+Query: "Como escalar um negocio de servicos?"
+→ Top-5 chunks semanticamente similares
+→ Injeta no contexto
+```
+
+### GraphRAG (vector + graph)
+```
+Query: "Como escalar um negocio de servicos?"
+→ Vector: Top-5 chunks semanticamente similares
+→ Graph: Identificar entidades na query (Concept: "scaling", Domain: "services")
+         → Traversal: Quais Principles conectados a "scaling" + "services"?
+         → Traversal: Quais Heuristics derivam desses Principles?
+         → Traversal: Quais Workflows implementam esses Principles?
+→ Fusao (RRF): Combinar resultados vector + graph
+→ Contexto mais rico e especifico
+```
+
+**Ganho esperado:** Reducao de 35-60% em respostas genericas vs vector-only
+(baseado em benchmark interno GraphRAG da Microsoft, adaptado para clones cognitivos)
+
+---
+
+## Schema de Persistencia
+
+Para persistir o grafo em formato processavel:
+
+```yaml
+# cognitive_graph_{target_id}.yaml
+metadata:
+  target: "{Nome}"
+  clone_tier: "{1|2|3}"
+  confidence_score: "{X}%"
+  node_count: {N}
+  edge_count: {N}
+  created: "{YYYY-MM-DD}"
+  
+nodes:
+  principles:
+    - id: "p-001"
+      content: "..."
+      confidence: "[DIRETO]"
+      sources: ["s-001", "s-002"]
+  
+  heuristics:
+    - id: "h-001"
+      trigger: "..."
+      action: "..."
+      rationale: "..."
+      confidence: "[INFERIDO]"
+      sources: ["s-001"]
+  
+  meta_patterns:
+    - id: "mp-001"
+      content: "..."
+      unified_principles: ["p-001", "p-003", "p-007"]
+      confidence: "[INFERIDO]"
+
+edges:
+  - from: "h-001"
+    to: "p-001"
+    type: "DERIVES_FROM"
+    confidence: "[INFERIDO]"
+    justification: "..."
+  
+  - from: "p-001"
+    to: "p-003"
+    type: "CONTRADICTS"
+    confidence: "[HIPOTESE]"
+    resolution: "Tensao produtiva: ambos verdadeiros em contextos diferentes"
+```
+
+---
+
+## Grafo Bi-Temporal (para Evolucao do Pensamento)
+
+Inspirado no Graphiti (Zep), o grafo de um clone pode rastrear
+como o pensamento da pessoa EVOLUIU ao longo do tempo:
+
+```yaml
+# Aresta com informacao temporal
+edge:
+  from: "p-001-v1"  # "Crescimento e tudo" (2018)
+  to: "p-001-v2"    # "Crescimento sustentavel supera crescimento rapido" (2023)
+  type: "REFINES"
+  valid_from: "2018"
+  valid_to: "2023"  # Quando foi substituido
+  invalidated_by: "p-001-v2"
+```
+
+### Como Usar Evolucao Temporal
+
+- Identificar quais principios sao **estaveis** (aparecem em todas as epocas)
+- Identificar quais sao **historicos** (valeram em periodo especifico)
+- Dar maior peso a principios estaveis no sistema HOT memory
+- Documentar evolucoes como meta-pattern (pessoa aprende e refina)
+
+---
+
+## Implementacao Pratica sem Banco de Grafo
+
+Para clones sem infraestrutura de grafo formal (casos simples):
+
+O grafo pode ser representado como **secao no perfil cognitivo** em markdown:
+
+```markdown
+## Rede de Conexoes (Mini-Grafo)
+
+### Core Axiom
+{MetaPattern central}
+
+### Deriva de:
+- {Principio 1} → {Heuristic A}, {Heuristic B}
+- {Principio 2} → {Workflow X}
+- {Principio 3} → {Heuristic C}
+
+### Tensoes Documentadas
+- {Principio 1} ↔ {Principio 3}: {Como a pessoa resolve}
+
+### Influencias Externas Documentadas
+- {Pessoa/Livro} → influenciou {Principio X}
+```
+
+Esta representacao plana permite ao LLM fazer graph traversal via reasoning,
+sem necessidade de banco de grafo formal.
+
+Ver tambem: `extraction-patterns.md` — como extrair os nos do grafo.
+Ver tambem: `memory-architecture-for-clones.md` — como usar o grafo em retrieval.
+Ver tambem: `cognitive-dna-framework.md` — as 5 camadas que formam os nos.