sinapse-ai 9.3.0 → 9.4.0

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

@@ -0,0 +1,262 @@
+# SKILL.md Standard para Clones — Exportacao Universal
+
+> Como exportar clones cognitivos no formato Agent Skills (SKILL.md),
+> compativel com 33+ plataformas: Claude Code, Codex, Gemini CLI, Cursor,
+> VS Code, GitHub Copilot e outros.
+> Baseado em: research 07-skills-agents-swarm, spec agentskills.io.
+
+---
+
+## Por Que SKILL.md Para Clones
+
+O formato Agent Skills (SKILL.md) e o padrao de facto universal em 2026:
+- 33 plataformas suportam o formato
+- 1.060+ skills catalogadas no ecossistema
+- Compatibilidade cross-platform sem modificacao
+- Especificacao publica em agentskills.io (Anthropic)
+
+Exportar clones como SKILL.md permite que o conhecimento cognitivo seja
+acessado em qualquer ferramenta de IA que o usuario ja usa — sem precisar
+"ativar o squad" explicitamente.
+
+---
+
+## Estrutura de Pasta para Clone-Skill
+
+```
+clones/{source-mind-kebab}/
+  SKILL.md              # OBRIGATORIO: metadata + instrucoes compactas
+  scripts/              # Opcional: scripts de suporte
+  references/
+    heuristics.md       # Lista completa de heuristics (L2)
+    workflows.md        # Workflows detalhados (L3)
+    kb/                 # Knowledge bases completos
+      {topic-1}.md
+      {topic-2}.md
+  assets/
+    templates/          # Templates de output usados pelo clone
+```
+
+**Regra fundamental:** O nome da pasta DEVE coincidir com o campo `name` no frontmatter.
+
+---
+
+## Frontmatter Obrigatorio
+
+```yaml
+---
+name: clone-{source-mind-kebab}
+description: >
+  Cognitive clone of {Nome}, expert in {dominios}. Responds as {nome} would,
+  using their documented heuristics, mental models and communication style.
+  Confidence: {X}% (Tier {1|2|3}). Use when you need {nome}'s perspective on
+  {area 1}, {area 2}, {area 3}. Trigger: "como {nome} pensaria sobre",
+  "o que {nome} faria", "analise como {nome}".
+license: UNLICENSED
+compatibility: Works standalone. Full features require SINAPSE squad-cloning context.
+metadata:
+  source_mind: "{Nome Completo}"
+  clone_tier: "{1|2|3}"
+  confidence_score: "{X}%"
+  fidelity_score: "{X}%"
+  squad: "squad-cloning"
+  primary_domains: "{dominio1}, {dominio2}, {dominio3}"
+  sinapse_version: "5.x"
+  last_updated: "{YYYY-MM-DD}"
+allowed-tools: Read
+---
+```
+
+### Campo `description` — Regras Criticas
+
+1. **Ser pushy:** A Anthropic recomenda descriptions "pushy" para combater under-triggering.
+   Incluir keywords explicitas que o usuario pode mencionar.
+2. **Mencionar confidence score:** Transparencia sobre a qualidade do clone.
+3. **Listar triggers:** Frases especificas que devem ativar o clone.
+4. **Listar dominios:** Areas de expertise documentadas.
+
+**Exemplo real:**
+```yaml
+description: >
+  Cognitive clone of Alex Hormozi, expert in offer creation, business acquisition,
+  and scaling service businesses. Confidence: 88% (Tier 3). Use when you need
+  Alex's perspective on pricing, offers, lead generation, or business growth.
+  Trigger phrases: "como Hormozi pensaria", "o que o Hormozi faria aqui",
+  "analise como Alex Hormozi", "perspectiva do Hormozi".
+```
+
+---
+
+## Corpo do SKILL.md — Template
+
+O corpo deve seguir Progressive Disclosure de 3 niveis:
+
+```markdown
+# Clone: {Nome} ({Tier})
+
+> Confidence: {X}% | Tier {N} | Dominios: {lista}
+> Baseado em: {N} fontes, {N}K palavras processadas
+
+## Identity
+
+{Core axiom em 1-2 frases. A essencia mais fundamental de como esta pessoa pensa.}
+
+**Principios fundamentais:**
+1. {Principio 1 — de L1, [DIRETO|INFERIDO]}
+2. {Principio 2}
+3. {Principio 3}
+4. {Principio 4}
+5. {Principio 5}
+
+## Como Esta Pessoa Responde
+
+**Tom:** {Descricao concisa do tom — direto/analitico/empático, formal/informal, etc.}
+
+**Abertura tipica:** "{Exemplo de como começa uma resposta}"
+
+**Vocabulario recorrente:** {lista de 8-10 palavras/expressoes caracteristicas}
+
+## Heuristics Principais (Top 5)
+
+1. **{Trigger 1}** → {Acao documentada} [DIRETO|INFERIDO]
+2. **{Trigger 2}** → {Acao} [DIRETO|INFERIDO]
+3. **{Trigger 3}** → {Acao} [DIRETO|INFERIDO]
+4. **{Trigger 4}** → {Acao} [DIRETO|INFERIDO]
+5. **{Trigger 5}** → {Acao} [DIRETO|INFERIDO]
+
+Para lista completa de heuristics: `references/heuristics.md`
+
+## Limites e Boundaries
+
+**Nao opinar sobre:**
+- {Area fora do dominio documentado}
+- {Topico que o original evita}
+
+**Sempre contextualizar:** "Baseado no que {nome} documentou/ensinou..."
+
+**Recusar criar conteudo que:**
+- Contradiz os valores documentados do original
+- Exige conhecimento nao presente nas fontes ({N} fontes, ate {data})
+
+## Como Usar Este Clone
+
+**Ativar com:** "Responda como {nome}", "O que {nome} faria?", "Perspectiva do {nome}"
+
+**Funciona melhor para:**
+- {Caso de uso 1}
+- {Caso de uso 2}
+- {Caso de uso 3}
+
+**Nao usar para:**
+- {Caso fora do dominio}
+- {Area de incerteza documentada}
+
+## Referencias
+
+- [Heuristics completas](references/heuristics.md) ({N} heuristics documentadas)
+- [Workflows](references/workflows.md) ({N} workflows)
+- [Knowledge Bases](references/kb/) ({N} KBs tematicos)
+```
+
+---
+
+## Progressive Disclosure por Nivel
+
+| Nivel | O que carrega | Quando | Tamanho |
+|-------|--------------|--------|---------|
+| 1 | name + description (frontmatter) | Startup — listagem | ~100 tokens |
+| 2 | Body do SKILL.md (Identity + Top heuristics) | Clone invocado | <3.000 tokens |
+| 3 | references/ (KBs completos, heuristics all) | Tarefa especifica | Ilimitado |
+
+**Regra critica:** SKILL.md deve ficar abaixo de 300 linhas.
+Todo material de referencia detalhado vai para references/.
+
+---
+
+## Qualidade de Skill por Tier de Clone
+
+### Tier 1 — SKILL.md Minimo
+- Frontmatter completo com confidence score
+- Identity block compacto (core axiom + 3 principios)
+- Top 3 heuristics
+- Boundaries claros
+- Referencias para KBs (mesmo que simples)
+
+### Tier 2 — SKILL.md Consultant
+- Frontmatter completo
+- Identity completo (core axiom + 5-6 principios)
+- Top 5 heuristics com trigger/action/rationale
+- Communication style detalhado
+- Failure modes completos
+- references/heuristics.md com lista completa
+- references/kb/ com KBs tematicos
+
+### Tier 3 — SKILL.md Full Clone
+- Tudo do Tier 2
+- Workflows ativos em references/workflows.md
+- Templates de output em assets/templates/
+- references/kb/ com 8+ KBs tematicos
+- Decision trees para cenarios complexos
+- Exemplos concretos de input/output esperado
+
+---
+
+## Anti-patterns de Clone-Skills
+
+| Anti-pattern | Problema | Correcao |
+|-------------|---------|---------|
+| SKILL.md > 500 linhas | Polui o contexto, atrasa carga | Mover para references/ |
+| Description vaga ("AI assistant for X") | Nao e ativada pelo LLM | Ser explicito e pushy |
+| Sem confidence score no frontmatter | Usuario nao sabe qualidade | Sempre incluir |
+| Sem failure modes | Clone responde fora do dominio | Adicionar secao de limites |
+| Heuristics sem tag [DIRETO|INFERIDO|HIPOTESE] | Viola principio de honestidade | Taguear todas |
+| Clone soa como pessoa mas nao decide como ela | Fidelidade cognitiva baixa | Validar com fidelity test |
+
+---
+
+## Deploy para Marketplace
+
+### Via Claude Code Plugin
+```bash
+# No diretorio raiz do clone
+# Criar marketplace.json
+{
+  "name": "sinapse-clones",
+  "plugins": [
+    {
+      "name": "clone-{source-mind}",
+      "description": "Cognitive clone: {Nome}",
+      "source": "./",
+      "skills": ["./clones/{source-mind-kebab}"]
+    }
+  ]
+}
+
+# Instalar
+/plugin marketplace add sinapse-ai/clones
+/plugin install clone-{source-mind}@sinapse-clones
+```
+
+### Via Instalacao Manual (cross-platform)
+```bash
+# Copiar para skills do projeto
+cp -r clones/{source-mind-kebab} .claude/skills/
+
+# Ou para skills globais
+cp -r clones/{source-mind-kebab} ~/.claude/skills/
+```
+
+### Compatibilidade Cross-Platform
+
+| Plataforma | Localizacao | Comando |
+|-----------|------------|---------|
+| Claude Code | `.claude/skills/` ou `~/.claude/skills/` | `/plugin install` |
+| Gemini CLI | `.gemini/skills/` | Configuracao manual |
+| Cursor | `.cursor/skills/` | Settings > Skills |
+| VS Code Copilot | `.github/skills/` | Configuracao manual |
+
+---
+
+Ver tambem: `agent-generation-guide.md` — como gerar o agent.md base.
+Ver tambem: `clone-quality-assurance.md` — validar antes de exportar como SKILL.md.
+Ver tambem: `cross-squad-deployment.md` — deploy para squads vs skill export.

package/squads/squad-cloning/knowledge-base/sop-extraction-guide.md

@@ -0,0 +1,243 @@
+# SOP Extraction Guide — Extraindo Procedimentos Operacionais de Mentes
+
+> Como identificar, reconstruir e documentar SOPs (Standard Operating Procedures)
+> a partir do conteudo de uma pessoa — para replicar metodologias sistematicas,
+> nao apenas principios abstratos.
+> SOPs sao Layer 3 (Workflows) em seu nivel mais operacional.
+
+---
+
+## O Que e um SOP Para Fins de Clonagem
+
+Um SOP cognitivo nao e apenas "como fazer X" — e o **procedimento EXATO**
+que a pessoa segue, com os criterios de decisao que determinam quando seguir
+cada variante e quando desviar.
+
+| Nivel | O que captura | Exemplo |
+|-------|--------------|---------|
+| **Principio** (L1) | O "por que" abstrato | "Sistemas vencem talentos" |
+| **Heuristic** (L2) | O "quando" da decisao | "Se a pessoa nao tem processo, nao contrato" |
+| **SOP** (L3+) | O "como" operacional step-by-step | "Processo de contratacao em 7 etapas" |
+| **Variante** | Quando adaptar o SOP | "Para candidatos remotos, adicionar step X" |
+| **Exit Condition** | Quando parar o processo | "Se não passar no step 3, encerrar" |
+
+---
+
+## Anatomia de um SOP Cognitivo Bem Extraido
+
+```yaml
+sop:
+  name: "{Nome descritivo do processo}"
+  domain: "{Area de aplicacao}"
+  trigger: "{O que ativa este SOP — situacao ou decisao}"
+  
+  preconditions:
+    - "{O que precisa estar verdadeiro antes de comecar}"
+    - "{Prerequisito 2}"
+  
+  steps:
+    - step: 1
+      action: "{O que fazer}"
+      decision_point: "{Se X, entao Y; se Z, entao W}"  # Opcional
+      output: "{O que deve resultar deste step}"
+      source: "[DIRETO] {Fonte}"
+    
+    - step: 2
+      action: "{O que fazer}"
+      duration: "{Quanto tempo tipicamente}"
+      output: "{O que deve resultar}"
+      source: "[INFERIDO] {Fontes}"
+  
+  exit_conditions:
+    success: "{Quando considerar o processo concluido com sucesso}"
+    abort: "{Quando encerrar sem completar — e por que}"
+  
+  variants:
+    - condition: "{Quando usar esta variante}"
+      modification: "{Como o SOP muda}"
+  
+  anti_patterns:
+    - "{O que a pessoa explicitamente diz para NAO fazer neste processo}"
+  
+  confidence: "{Confidence score para este SOP especifico}"
+  sources: ["{lista de fontes}"]
+```
+
+---
+
+## Tecnicas de Extracao de SOPs
+
+### Tecnica 1: Extracao de Exemplo Concreto
+
+A maioria dos SOPs nao e descrita de forma abstrata — emerge de exemplos.
+
+**Processo:**
+1. Encontrar 3+ exemplos onde a pessoa descreve como fez algo
+2. Para cada exemplo, listar os steps que aparecem
+3. Identificar steps comuns (aparecem em 2+ exemplos)
+4. Ordenar cronologicamente
+5. Marcar como [INFERIDO] (derivado de exemplos, nao declarado como processo)
+
+**Exemplo:**
+```
+Fonte 1: "Quando lanco um produto, primeiro testo a oferta com 10 pessoas..."
+Fonte 2: "No lancamento do curso, comecei validando com um grupo pequeno..."
+Fonte 3: "Sempre valido antes de escalar..."
+
+→ SOP extraido: "Validacao com grupo pequeno antes de lancamento completo"
+→ Confianca: [INFERIDO] (aparece em 3 exemplos)
+```
+
+### Tecnica 2: Elicitacao de Decisoes
+
+Quando a pessoa descreve uma decisao complexa, o SOP esta implicito
+na sequencia de perguntas/criterios que ela menciona.
+
+**Sinal linguistico:** "A primeira coisa que olho e... depois verifico... e so então..."
+
+**Processo:**
+1. Identificar qualquer descricao de "sequencia de analise" ou "processo de decisao"
+2. Extrair os criterios em ordem de mencao
+3. Estruturar como SOP de decisao (decision flowchart)
+
+### Tecnica 3: Reconstructing from Teaching
+
+Quando a pessoa ensina outras pessoas a fazer algo:
+- Conteudo de curso = SOP detalhado com alta fidelidade
+- Tutorial = SOP com rationale explicada
+- Conselho a subordinado = SOP adaptado para o contexto do outro
+
+**Prioridade:** Conteudo de ensino tem score de [DIRETO] mesmo que seja
+descricao do SOP para outra pessoa, desde que a pessoa declare "eu faco assim".
+
+### Tecnica 4: Reverse Engineering de Outputs
+
+Para casos onde o SOP nunca foi descrito explicitamente:
+1. Coletar 5+ outputs que a pessoa produziu do mesmo tipo
+2. Identificar estrutura comum nos outputs
+3. Inferir o SOP que produziu essa estrutura
+4. Marcar sempre como [HIPOTESE] — e reconstrucao, nao extracao direta
+
+---
+
+## Tipos de SOPs por Dominio
+
+### SOPs de Produto/Negocio
+
+| SOP | Sinal de Presenca | Tier Minimo |
+|-----|-----------------|------------|
+| Processo de lancamento | "Quando lancei..." / "Meu processo de lancamento" | Tier 1 |
+| Criacao de oferta | "Quando crio uma oferta..." | Tier 2 |
+| Onboarding de cliente | "Como recebo um novo cliente..." | Tier 2 |
+| Criacao de produto | "Como desenvolvo um produto..." | Tier 2 |
+| Processo de contratacao | "Quando contratar..." | Tier 3 |
+
+### SOPs de Marketing/Vendas
+
+| SOP | Sinal de Presenca | Tier Minimo |
+|-----|-----------------|------------|
+| Processo de copywriting | "Quando escrevo copy..." | Tier 1 |
+| Estrutura de funil | "Meu funil tem X etapas..." | Tier 1 |
+| Qualificacao de leads | "Antes de falar com alguem..." | Tier 2 |
+| Script de vendas | "Na ligacao, primeiro..." | Tier 2 |
+| Processo de upsell | "Como oferecer mais..." | Tier 3 |
+
+### SOPs de Estrategia/Decisao
+
+| SOP | Sinal de Presenca | Tier Minimo |
+|-----|-----------------|------------|
+| Framework de priorizacao | "Quando tenho multiplas opcoes..." | Tier 2 |
+| Processo de resolucao de problema | "Quando enfrento X problema..." | Tier 2 |
+| Processo de analise de oportunidade | "Antes de entrar em..." | Tier 3 |
+| Tomada de decisao em crise | "Quando algo da errado..." | Tier 3 |
+
+---
+
+## Decision Tree Mapping
+
+SOPs complexos contem pontos de decisao — o clone precisa saber nao apenas
+os steps, mas QUANDO escolher cada ramificacao.
+
+### Formato de Arvore de Decisao
+
+```
+[TRIGGER: {situacao que ativa o SOP}]
+    |
+    v
+[STEP 1: {acao}]
+    |
+    +-- Se {condicao A} --> [STEP 2A: {acao alternativa A}]
+    |                           |
+    |                           v
+    |                       [EXIT: {resultado esperado}]
+    |
+    +-- Se {condicao B} --> [STEP 2B: {acao alternativa B}]
+    |                           |
+    |                           +-- Se {sub-condicao} --> [STEP 3]
+    |                           |
+    |                           +-- Senao --> [EXIT: abort - {razao}]
+    |
+    +-- Default --> [STEP 2C: {acao padrao}]
+```
+
+### Exemplo Real: Decision Tree de Oferta (hipotetico)
+
+```
+[TRIGGER: Precisa criar ou revisar uma oferta]
+    |
+    v
+[STEP 1: Calcular valor percebido pelo cliente]
+    |
+    +-- Se valor > 10x preco --> [STEP 2A: Lancamento direto]
+    |
+    +-- Se valor 3-10x preco --> [STEP 2B: Adicionar bonus ate chegar em 10x]
+    |
+    +-- Se valor < 3x preco ---> [ABORT: Redesenhar a oferta do zero]
+```
+
+---
+
+## SOPs vs Heuristics — Como Distinguir
+
+| Caracteristica | Heuristic (L2) | SOP (L3) |
+|---------------|---------------|---------|
+| Comprimento | 1-3 linhas | 5-20+ steps |
+| Frequencia | Aplicada muitas vezes | Aplicada em contextos especificos |
+| Granularidade | Alta abstracao | Operacional e especifico |
+| Variantes | Poucas | Multiplas (por contexto) |
+| Exit conditions | Implicitas | Explicitas |
+
+**Regra pratica:** Se voce pode descrever em < 3 linhas, e uma heuristic.
+Se precisa de mais, e um SOP.
+
+---
+
+## Qualidade de SOPs por Tier
+
+| Criterio | Tier 1 | Tier 2 | Tier 3 |
+|---------|--------|--------|--------|
+| SOPs documentados | 3 | 5 | 8+ |
+| Steps por SOP | 3-5 | 5-8 | 8+ |
+| Decision points incluidos | 0-1 | 1-3 | 3+ |
+| Variants documentadas | 0 | 1-2 | 2+ |
+| Exit conditions | Opcional | Recomendado | Obrigatorio |
+| Anti-patterns | Opcional | Recomendado | Obrigatorio |
+
+---
+
+## Red Flags de SOPs Fracos
+
+| Red Flag | Problema | Correcao |
+|---------|---------|---------|
+| Steps genéricos ("analisar X") | Nao e actionable | Especificar o que analisar e como |
+| SOP com 1-2 steps | Provavelmente e heuristic | Re-classificar ou aprofundar |
+| Sem trigger claro | Clone nao sabe quando usar | Definir situacao de ativacao |
+| Sem exit conditions | Clone nao sabe quando parar | Adicionar success e abort conditions |
+| Confianca [HIPOTESE] em SOP critico | Risco de fabricacao | Buscar mais fontes ou downgrade |
+| SOP contradiz heuristic da pessoa | Inconsistencia no perfil | Investigar e resolver |
+
+---
+
+Ver tambem: `extraction-patterns.md` — patterns gerais para identificar SOPs.
+Ver tambem: `cognitive-dna-framework.md` — SOPs sao Layer 3 (Workflows & Processes).
+Ver tambem: `kb-generation-guide.md` — como empacotar SOPs como Methodology KBs.