iron-edge 1.2.0 → 2.0.0

package/squads/squad-cloning/tasks/extract-workflows-processes.md

@@ -17,30 +17,41 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada workflow tem passos ordenados, nao uma lista solta de atividades"
+  - "[ ] Workflow reconstruido (nao descrito) tem 3+ exemplos e esta marcado [INFERIDO], nunca [DIRETO]"
+  - "[ ] Nenhum passo depende de bom senso do analista para ser seguido"
+  - "[ ] Contagem confere com o minimo do tier antes de declarar a layer completa"
+  - "[ ] Workflow com 1 exemplo so esta marcado [HIPOTESE]"
 ---
 
-# Task: extract-workflows-processes
-
-## Metadata
-- **Agent:** cognitive-extractor (Cortex)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Extrair workflows e processos
 
 ## Objetivo
-Layer 3: Processos step-by-step
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Extrair os processos step-by-step, metodologias nomeadas e rotinas que a pessoa segue — a Layer 3 do DNA cognitivo, reproduzível por quem não é ela.
+
+## A regra que governa
+**Se outra pessoa não consegue seguir os passos e chegar num resultado parecido, ainda não é workflow — é intenção.** Reprodutibilidade é o teste, não a impressão de que "ela tem um jeito de fazer as coisas".
+
+## Passos
+1. **Busque os sinais linguísticos de `extraction-patterns.md` (Pattern 3):** "primeiro eu faço X, depois Y", "meu processo tem N etapas", "passo 1:...", "toda manhã eu...".
+2. **Quando o processo não é descrito explicitamente**, reconstrua-o a partir de 3 ou mais exemplos concretos da mesma tarefa: identifique os passos comuns, ordene-os, e marque [INFERIDO] — nunca [DIRETO], porque a ordenação é trabalho do analista, não citação da pessoa.
+   ⚠️ Workflow reconstruído de um único exemplo vira uma sequência genérica ("planejar, executar, revisar") que serve para qualquer processo do mundo — com 1 exemplo só, a tag é [HIPOTESE], nunca [INFERIDO].
+3. **Valide entre fontes:** o mesmo processo aparece em contextos diferentes (vídeo, texto, entrevista)? Isso sobe a confiança da extração.
+4. **Teste a reprodutibilidade de cada passo:** a ação é clara o bastante para alguém seguir sem preencher a lacuna com bom senso próprio? Se não, o passo está incompleto — volte à fonte.
+5. **Confira o mínimo do tier** antes de declarar a layer completa: 3 (Tier 1), 5 (Tier 2), 8 (Tier 3) — `cognitive-dna-framework.md` e `extraction-quality-checklist.md`.
+
+## Formato da saída
+Seção "Layer 3" de `cognitive-profile-template.md` — nome do workflow seguido de passos numerados, cada um com sua tag:
+
+### Processo de validação de oferta
+1. Testar a oferta com uma landing page antes de qualquer criativo [DIRETO]
+2. Rodar tráfego mínimo por 72h medindo só CTR e CPL [DIRETO]
+3. Só então decidir se vale montar o funil completo [INFERIDO]
+
+## O que não vale
+- Passo do tipo "faça o que for necessário" — isso não é passo, é ausência de passo.
+- Workflow inventado para bater o mínimo do tier.
+- Ordenar passos pela lógica do analista quando a pessoa nunca os apresentou nessa ordem.
+
+## Fontes no squad
+`knowledge-base/cognitive-dna-framework.md` (Layer 3), `knowledge-base/extraction-patterns.md` (Pattern 3: sinais e reconstrução de workflow implícito), `checklists/extraction-quality-checklist.md` (mínimos por tier), `templates/cognitive-profile-template.md`.

package/squads/squad-cloning/tasks/finalize-clone-delivery.md

@@ -17,30 +17,44 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Os 4 gates de clone-quality-assurance.md conferidos (confidence, fidelity, integridade, etica)"
+  - "[ ] Gate etico confirma que o destino atual do clone ainda corresponde a base legal registrada na abertura"
+  - "[ ] pre-deploy-checklist.md e clone-completeness-checklist.md rodados"
+  - "[ ] Gate reprovado volta a fase de origem, nunca segue para deploy com ressalva"
 ---
 
-# Task: finalize-clone-delivery
-
-## Metadata
-- **Agent:** cloning-orqx (Helix)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Revisar e fechar a entrega do clone
 
 ## Objetivo
-Review final e sign-off
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Fazer a última checagem antes de o clone ir para deploy — confidence, fidelidade, integridade e ética — e só liberar para o Assembly quando os quatro passarem.
+
+## A regra que governa
+**A entrega não é "o pipeline terminou", é "os gates bateram".** Um clone que passou pelas 8 fases mas falhou em um gate final não está pronto — está processado.
+
+## Passos
+
+1. **Rode o `checklists/clone-completeness-checklist.md`** contra o que foi gerado: perfil cognitivo, agent.md (Tier 2+), KBs no mínimo do tier, tasks (Tier 3). Um item faltando aqui volta para a fase que deveria tê-lo produzido — não se remenda na finalização.
+
+2. **Confira os quatro gates de `knowledge-base/clone-quality-assurance.md`**:
+   - **Gate 1 (Confidence):** score bate o piso do tier declarado, e nenhuma camada core (L1, L2) está abaixo de 60% individualmente.
+   - **Gate 2 (Fidelity):** se houve validação de fidelidade (teste de decisão, blind comparison), score ≥ 70%, dimensão cognitiva ≥ 65%.
+   - **Gate 3 (Integridade):** failure modes documentados, nenhuma heurística [HIPOTESE] promovida a core principle, gaps explícitos no agent.md.
+   - **Gate 4 (Ética):** ver passo 3.
+
+3. **O gate ético não se resume a "existe uma declaração".** Confirme, usando o "Checklist Etico Pre-Deploy" de `knowledge-base/ethical-guidelines.md`: o `agent.md` traz o disclaimer de que não é a pessoa real; a `ethical_declaration` registrada em `initiate-clone-project` ainda corresponde ao uso pretendido agora (o projeto não mudou de destino no meio do caminho); e, se o uso é público ou comercial, o consentimento correspondente está documentado, não presumido.
+   ⚠️ **Se o destino do clone mudou desde a abertura do projeto** — era estudo privado, virou produto público, por exemplo — a base legal do início não cobre mais o uso. Volte e resolva o consentimento antes de liberar, não depois.
+
+4. **Rode o `checklists/pre-deploy-checklist.md`** para a parte estrutural: `squad.yaml` completo, naming em kebab-case, KBs deployáveis nomeados como `{source-mind}-{topic}.md` (`knowledge-base/cross-squad-deployment.md`), nenhuma referência quebrada entre agent, tasks e KBs.
+
+5. **Se tudo passou**, entregue para o Assembly (`squad-assembler`) iniciar o deploy, com o tier final, confidence score e a lista de KBs cross-squad. Se algo falhou, volte à fase de origem com o gap nomeado — não ao Assembly "com ressalva".
+
+## Formato da saída
+Sign-off de uma linha por gate: `Confidence: OK (87%, Tier 3) · Fidelity: não testado (documentar como gap) · Integridade: OK · Ética: OK (consentimento notificado, disclaimer presente) · Estrutura: OK. Liberado para deploy.` Ou, se reprovado: `Ética: REPROVADO — destino mudou para produto público, consentimento registrado era 'public_content_only'. Devolvido para nova checagem de base legal antes do deploy.`
+
+## O que não vale
+- Liberar para deploy com um gate reprovado e uma ressalva escrita ao lado — reprovado é reprovado.
+- Aceitar a declaração ética da abertura do projeto sem confirmar que o uso final ainda é o mesmo.
+- Rodar o checklist estrutural (`pre-deploy-checklist.md`) sem rodar os quatro gates de qualidade — um deploy bem formatado não é um clone confiável.
+
+## Fontes no squad
+`checklists/clone-completeness-checklist.md`, `checklists/pre-deploy-checklist.md`, `knowledge-base/clone-quality-assurance.md`, `knowledge-base/ethical-guidelines.md`, `knowledge-base/cross-squad-deployment.md`.

package/squads/squad-cloning/tasks/generate-agent-commands.md

@@ -17,30 +17,55 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Todo command amarrado a um protocol ou capability documentada no perfil"
+  - "[ ] *help e *status presentes"
+  - "[ ] Um command expoe a declaracao de clone (transparencia acessivel, nao so no metadata)"
+  - "[ ] Nenhuma description generica ('faz analise', 'ajuda com X')"
+  - "[ ] Nenhum command promete capability nao extraida da pessoa"
 ---
 
-# Task: generate-agent-commands
-
-## Metadata
-- **Agent:** agent-forger (Forge)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar os commands do clone
 
 ## Objetivo
-Designar commands do agente
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Derivar a lista `commands` do agent.md — os `*comando` que o usuário aciona — a partir dos protocolos e capabilities reais já mapeados, não de uma lista padrão de "coisas que todo agente tem".
+
+## A regra que governa
+**Comando é verbo de ação amarrado a algo que existe.** Todo `*comando` tem que apontar para um protocolo gerado em `generate-agent-protocols` ou para uma capability documentada no cognitive-profile.md. Se não existe base, não existe comando — por mais que "pareça faltar" na lista.
+
+## Passos
+
+1. **Percorrer os protocolos gerados na task anterior.** Cada protocolo forte vira candidato a comando: nome com verbo de ação (`*diagnosticar`, `*revisar`, `*estruturar`), seguindo a convenção de nomenclatura de `agent-generation-guide.md` (Passo 5).
+
+2. **Cobrir capabilities que não viraram protocolo completo mas são centrais ao domínio da pessoa** — por exemplo, se ela é conhecida por dar uma opinião estruturada sobre um tipo de decisão, isso também pode virar comando mesmo sem um workflow de múltiplos passos por trás, desde que a capability esteja documentada na Layer 1 ou 2.
+
+3. **Incluir sempre `*help` e `*status`.** São obrigatórios independente do domínio — é o mínimo de qualquer agente do ecossistema.
+
+4. **Adicionar um comando de transparência.** Além do `ethical_declaration` estar no metadata do agent.md, o usuário precisa de um jeito direto de pedir a declaração de clone durante a conversa — um comando (`*sobre`, `*transparencia`, ou equivalente natural ao domínio) que devolve a `clone_declaration` escrita em `generate-agent-persona`. Isso segue o Princípio 1 de `ethical-guidelines.md`: a transparência não pode viver só em metadata que o usuário nunca lê.
+
+5. **Escrever a description de cada comando amarrada à fonte.** "Aplica o framework de diagnóstico de 3 números antes de qualquer proposta" é uma description válida porque aponta pro protocolo real. "Ajuda com vendas" não é — é genérica demais pra dizer se veio da pessoa ou de qualquer lugar.
+
+6. **Auto-checar antes de entregar.** Todo comando tem protocolo ou capability por trás? `*help`/`*status`/transparência presentes? Nenhuma description genérica? Se alguma resposta for não, corrija antes de passar para `generate-cross-squad-handoffs`.
+
+## Formato da saída
+Lista YAML de commands, seguindo `clone-agent-template.md`:
+
+```yaml
+commands:
+  - name: "*diagnosticar"
+    description: "Aplica o framework de 3 números antes de qualquer proposta — protocolo diagnostico-antes-de-proposta"
+  - name: "*sobre"
+    description: "Mostra a declaracao de clone: quem e o original, tier, confidence, fontes"
+  - name: "*help"
+    description: "Lista os comandos disponiveis"
+  - name: "*status"
+    description: "Mostra tier, confidence score e gaps documentados do clone"
+```
+
+## O que não vale
+- Comando sem protocolo ou capability documentada por trás — parece completo, é decorativo.
+- Description genérica que serviria pra qualquer agente do ecossistema.
+- Esquecer `*help` ou `*status`.
+- Prometer, no nome ou na description do comando, uma capability que a pessoa nunca demonstrou nas fontes.
+
+## Fontes no squad
+`knowledge-base/agent-generation-guide.md` (Passo 5 — Commands), `templates/clone-agent-template.md`, `knowledge-base/ethical-guidelines.md` (Princípio 1 — Transparência Obrigatória).

package/squads/squad-cloning/tasks/generate-agent-heuristics.md

@@ -17,30 +17,51 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada heuristic tem trigger, action e rationale da pessoa, nao generico"
+  - "[ ] Minimo do tier atingido (5 Tier 2, 10 Tier 3) ou gap documentado como tal"
+  - "[ ] [HIPOTESE] marcado nas heuristics extraidas de fonte unica"
+  - "[ ] Heuristic em area sensivel (saude/juridico/politica) carrega disclaimer"
+  - "[ ] Nenhuma heuristic foi inventada para bater o numero minimo"
 ---
 
-# Task: generate-agent-heuristics
-
-## Metadata
-- **Agent:** agent-forger (Forge)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar as heurísticas do clone
 
 ## Objetivo
-Converter heuristics extraidas
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Converter cada regra de decisão da Layer 2 do cognitive-profile.md num bloco `trigger/action/rationale` do agent.md — o coração do clone, porque é onde ele decide, não só onde ele soa parecido.
+
+## A regra que governa
+**Rationale tem que ser da pessoa, não inventado.** Se a única justificativa que dá para escrever é "porque é boa prática" ou "porque faz sentido", a heurística não tem fonte suficiente — ela não entra, ou entra marcada `[HIPOTESE]`.
+
+## Passos
+
+1. **Ler a Layer 2 do cognitive-profile.md.** Cada heurística já vem com uma tag de confiança (`[DIRETO]`, `[INFERIDO]`, `[HIPOTESE]`, definidas em `cognitive-dna-framework.md`). Traga a tag junto — ela não se perde na conversão.
+
+2. **Converter para o formato do agente.** Para cada heurística: `trigger` é a situação que ativa a regra, `action` é o que a pessoa faz ou recomenda (na voz dela, não na sua), `rationale` é a citação ou inferência real que sustenta — nunca uma justificativa genérica de manual.
+
+3. **Checar o mínimo do tier.** `clone-tier-standards.md` exige 15 heurísticas extraídas no Tier 2 e 25 no Tier 3; `clone-agent-template.md` e `clone-completeness-checklist.md` pedem no mínimo 5 (Tier 2) ou 10 (Tier 3) *no agente* — nem toda heurística extraída vira heurística do agente, mas o piso do agente precisa ser batido com heurísticas reais.
+   ⚠️ **Se faltar heurística pra bater o mínimo, o gap é documentado, não preenchido.** `agent-generation-guide.md` é explícito: "não inventar heuristics que soam boas mas não foram extraídas".
+
+4. **Marcar incerteza visivelmente.** Heurística com tag `[HIPOTESE]` na fonte recebe o comentário `# [HIPOTESE]` no YAML do agente — o usuário do clone precisa ver que aquela regra vem de uma fonte só, não de padrão confirmado.
+
+5. **Barrar heurística de área sensível sem disclaimer.** Se o `trigger/action` de uma heurística orienta decisão médica, jurídica ou financeira específica — não genérica de negócio, mas prescritiva sobre uma pessoa real — ela precisa carregar o disclaimer previsto em `ethical-guidelines.md` (Princípio 4: "Nunca dar conselhos médicos/jurídicos específicos"). Sem o disclaimer, a heurística não entra como está: reescreva para o nível de princípio geral, ou descarte.
+
+## Formato da saída
+Lista YAML de heuristics, seguindo `clone-agent-template.md`:
+
+```yaml
+heuristics:
+  - trigger: "Cliente pede desconto antes de ver a proposta"
+    action: >
+      Nunca abrir com preço. Mostrar o valor primeiro, preço só depois
+      da objeção real aparecer.
+    rationale: "[DIRETO] Entrevista X: 'quem fala preço primeiro perdeu a negociação'"
+```
+
+## O que não vale
+- Rationale copiado de manual de vendas genérico em vez da fala real da pessoa.
+- Heurística sem trigger claro — vira princípio disfarçado de regra.
+- Completar o número mínimo inventando heurísticas plausíveis.
+- Heurística prescritiva em saúde/direito sem o disclaimer de `ethical-guidelines.md`.
+
+## Fontes no squad
+`knowledge-base/cognitive-dna-framework.md` (Layer 2 — Heuristics & Decision Rules, Tags de Confiança), `knowledge-base/agent-generation-guide.md` (Passo 3 — Heuristics, Quality Checklist), `knowledge-base/clone-tier-standards.md` (mínimos por tier), `knowledge-base/ethical-guidelines.md` (Princípio 4 — Limites de Uso).

package/squads/squad-cloning/tasks/generate-agent-persona.md

@@ -17,30 +17,60 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] persona_profile mapeado das Layers 4 e 5 do cognitive-profile.md, sem generalizacoes"
+  - "[ ] real_person, source_mind, clone_tier, confidence_score preenchidos"
+  - "[ ] clone_declaration escrita conforme o Principio 1 de ethical-guidelines.md"
+  - "[ ] Base legal/consentimento verificada — perguntada ao dono se nao veio documentada"
+  - "[ ] ethical_declaration completa (consent_status, lgpd_basis, data_sources, use_restrictions)"
+  - "[ ] Jurisdicao da base legal explicitada quando a fonte nao e brasileira"
 ---
 
-# Task: generate-agent-persona
-
-## Metadata
-- **Agent:** agent-forger (Forge)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar a persona do clone
 
 ## Objetivo
-Criar persona block
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Escrever o bloco `persona_profile` e o parágrafo `persona.identity` do agent.md — tom, saudações, papel — carregando junto, no mesmo passo, a declaração de que o agente é uma representação e sob que base ela foi construída.
+
+## A regra que governa
+**O clone se apresenta como clone, sempre.** Não existe versão desta task que gera persona sem gerar, no mesmo bloco, a base legal do uso. Se a base não está documentada, a task para e pergunta ao dono — não segue com o campo vazio nem com um valor genérico.
+
+## Passos
+
+1. **Ler o cognitive-profile.md.** Puxe a Layer 4 (tom, vocabulário, catchphrase, saudação) e a Layer 5 (core axiom, meta-patterns) — e o mapeamento de `agent-generation-guide.md` (seção "1. Persona Profile"). Preencha `archetype`, `communication.tone`, `greeting_levels` e `signature_closing` no formato de `clone-agent-template.md`.
+
+2. **Preencher os campos de identidade do clone.** `real_person: true`, `source_mind`, `clone_tier`, `confidence_score` e `content_class` vêm do cognitive-profile.md — nunca inferidos aqui, só copiados da fonte.
+
+3. **Escrever o parágrafo `identity`.** Sintetize as 5 layers num parágrafo que capture como a pessoa pensa (L1), decide (L2), trabalha (L3), comunica (L4) e o que conecta tudo (L5) — sem soar como descrição de RH.
+
+4. **Verificar a base de uso — o passo que faltava.** Antes de escrever `ethical_declaration`, confira se o source-catalog ou o cognitive-profile já documentam `consent_status` e `lgpd_basis`. Use a tabela "Base Legal por Tipo de Clone" de `ethical-guidelines.md` para decidir qual se aplica: figura pública → legítimo interesse; figura semi-pública → consentimento recomendado; pessoa privada → consentimento explícito obrigatório, sem o qual **você não deve gerar** o clone. (Exigência escrita: nada no código impede — quem responde é quem opera.)
+   ⚠️ **Onde a base de uso não estiver clara, a task para e pergunta ao dono.** Não é decisão do pipeline — é decisão de risco, e o dono responde numa linha: pública, notificada, ou consentida.
+
+5. **Escrever `clone_declaration` e `ethical_declaration`.** Siga o formato exato de `ethical-guidelines.md` (seção "Declaração Obrigatória em Todos os Clones"): `consent_status`, `consent_date`, `use_restrictions`, `removal_contact`, `lgpd_basis`, `data_sources`, `last_reviewed`. Este bloco entra no agent.md junto do persona_profile — não num checklist à parte que roda depois.
+
+6. **Declarar a jurisdição quando a fonte não for brasileira.** `ethical-guidelines.md` documenta LGPD e Código Civil brasileiro. Se a pessoa clonada não está sob jurisdição brasileira, não escreva "a LGPD exige X" — escreva "sob a LGPD (jurisdição BR), a prática recomendada seria X; confirmar a base legal local aplicável" ou pergunte ao dono.
+
+## Formato da saída
+Bloco `persona_profile` + `persona.role` + `persona.identity` em YAML, seguindo `clone-agent-template.md`, com `ethical_declaration` preenchido:
+
+```yaml
+persona_profile:
+  archetype: "Strategist"
+  real_person: true
+  source_mind: "Nome Completo"
+  clone_tier: "2"
+  confidence_score: "78%"
+  ethical_declaration:
+    consent_status: "public_content_only"
+    lgpd_basis: "legitimate_interest"
+    data_sources: "public_only"
+    use_restrictions:
+      - "Uso educacional e de consultoria privada apenas"
+```
+
+## O que não vale
+- Gerar persona sem `ethical_declaration` — mesmo que o checklist de pré-deploy rode "depois", o campo tem que existir aqui.
+- Inventar `consent_status` porque o conteúdo "parece" público.
+- Copiar o boilerplate de `ethical-guidelines.md` sem checar se a base realmente se aplica ao caso.
+- Afirmar obrigação legal brasileira para pessoa fora do Brasil sem qualificar a jurisdição.
+
+## Fontes no squad
+`knowledge-base/agent-generation-guide.md` (mapeamento Layer → Agent, seção Persona Profile), `knowledge-base/ethical-guidelines.md` (Princípio 1 — Transparência, Princípio 2 — Consentimento e LGPD, Declaração Obrigatória), `knowledge-base/cognitive-dna-framework.md` (Layer 4 e 5), `templates/clone-agent-template.md`.

package/squads/squad-cloning/tasks/generate-agent-protocols.md

@@ -17,30 +17,52 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada protocol tem steps ordenados e reproduziveis por outra pessoa"
+  - "[ ] Workflows selecionados sao os mais fortes/recorrentes; os descartados estao listados"
+  - "[ ] Confianca da fonte (DIRETO/INFERIDO/HIPOTESE) declarada por protocol"
+  - "[ ] Nenhum step expoe dado privado de terceiro identificavel"
+  - "[ ] Formato segue templates/clone-agent-template.md"
 ---
 
-# Task: generate-agent-protocols
-
-## Metadata
-- **Agent:** agent-forger (Forge)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar os protocolos do clone
 
 ## Objetivo
-Converter workflows em protocols
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Converter os workflows extraídos na Layer 3 do cognitive-profile.md em `protocols` do agent.md — processos com passos que outra pessoa consegue seguir e chegar num resultado parecido com o da pessoa original.
+
+## A regra que governa
+**Um protocolo tem que ser reproduzível por outra pessoa.** Se os steps não bastam pra alguém repetir o processo sem adivinhar, o que você tem não é protocolo — é resumo. Resumo não vira `protocols:` no agent.md.
+
+## Passos
+
+1. **Ler a Layer 3 do cognitive-profile.md.** Cada workflow documentado já vem com steps na ordem em que a pessoa realmente os descreveu — não reordene por lógica própria, use a sequência da fonte (`agent-generation-guide.md`, Passo 4).
+
+2. **Nomear cada protocolo em kebab-case** e listar os steps ordenados no formato de `clone-agent-template.md` (`name` + `steps`).
+
+3. **Selecionar, não despejar tudo.** `cognitive-dna-framework.md` pede 5 workflows documentados no Tier 2 e 8 no Tier 3 na extração — mas nem todo workflow extraído vira protocolo do agente. Priorize os mais fortes (aparecem em fontes diferentes, alta confiança) e os mais recorrentes (a pessoa os cita como processo, não como exemplo único).
+   ⚠️ **O que ficou de fora entra numa lista de descartados com o motivo** — baixa confiança, workflow redundante com outro já incluído, ou fonte única sem confirmação. Omitir sem registrar é o mesmo defeito de heurística inventada: parece completo e não é.
+
+4. **Declarar a confiança do protocolo inteiro.** Se um workflow foi extraído de uma fonte só (`[HIPOTESE]` em `cognitive-dna-framework.md`), o protocolo entra com uma nota de baixa confiança visível — não é apresentado com a mesma autoridade de um processo confirmado em 3+ fontes.
+
+5. **Checar exposição de terceiros.** Se um step do workflow usa um caso real com nome, empresa ou dado identificável de outra pessoa que não é o alvo do clone, generalize o exemplo antes de incluir — `ethical-guidelines.md` trata direitos de personalidade e dados sensíveis como território que não se atravessa por acidente dentro de um step ilustrativo.
+
+## Formato da saída
+Lista YAML de protocols, seguindo `clone-agent-template.md`:
+
+```yaml
+protocols:
+  - name: "diagnostico-antes-de-proposta"
+    steps:
+      - "Levantar os 3 números que definem o problema do cliente"
+      - "Confrontar os números com o benchmark do setor"
+      - "Só então desenhar a proposta — nunca antes do diagnóstico"
+    confidence: "[INFERIDO] — aparece em 4 entrevistas com a mesma ordem"
+```
+
+## O que não vale
+- Step vago tipo "executar operação principal" — não diz o que fazer.
+- Misturar dois workflows diferentes num protocolo só porque parecem relacionados.
+- Inventar um step pra fechar uma sequência que a fonte deixou incompleta.
+- Expor nome, empresa ou dado identificável de terceiro dentro de um step de exemplo.
+
+## Fontes no squad
+`knowledge-base/cognitive-dna-framework.md` (Layer 3 — Workflows & Processes), `knowledge-base/agent-generation-guide.md` (Passo 4 — Protocols), `templates/clone-agent-template.md`, `knowledge-base/ethical-guidelines.md` (Direitos de Personalidade).

package/squads/squad-cloning/tasks/generate-checklist-files.md

@@ -6,41 +6,56 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
-    tipo: object
-    origem: "pipeline"
+  - campo: cognitive_profile
+    tipo: document
+    origem: "mind-synthesizer — heuristicas marcadas como criterio de qualidade"
+    obrigatorio: true
+  - campo: task_files
+    tipo: document
+    origem: "generate-task-files — tasks que o checklist vai auditar"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: checklist_files
     tipo: document
-    destino: "next phase"
+    destino: "checklists/*.md do squad do clone"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada item do checklist e verificavel com sim/nao, nunca com opiniao"
+  - "[ ] Item vem de um criterio de qualidade documentado da pessoa, ou de uma checagem estrutural padrao"
+  - "[ ] Nenhum checklist copiado de outro squad sem adaptar ao dominio"
+  - "[ ] Checklist agrupado por tema, nao uma lista solta"
 ---
 
-# Task: generate-checklist-files
-
-## Metadata
-- **Agent:** squad-assembler (Assembly)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar checklists do clone
 
 ## Objetivo
-Gerar checklists
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Escrever os checklists que o squad do clone usa para auditar o próprio trabalho — o padrão de qualidade que a pessoa aplicava (quando documentado) mais as checagens estruturais mínimas de qualquer squad.
+
+## A regra que governa
+**Item de checklist tem que ser verificável com sim ou não, olhando o artefato — nunca uma impressão.** "Ficou bom" não é item; "o preço aparece antes da objeção de valor" é.
+
+## Passos
+
+1. **Separe as duas origens de item.** (a) Critério de qualidade que a própria pessoa aplicava — geralmente aparece na extração como heurística do tipo "eu sempre confiro X antes de Y" ou "nunca entrego sem Z" (ver `extraction-patterns.md`, Pattern 2). (b) Checagem estrutural padrão que qualquer task deste squad precisa passar (frontmatter completo, saída no formato esperado, tags de confiança presentes).
+   ⚠️ Item do tipo (a) sem heurística documentada por trás é item inventado — some ele, não finja.
+
+2. **Agrupe por tema**, não por ordem de descoberta. Um checklist "Antes de entregar uma proposta" lê melhor que uma lista de 15 itens sem cabeçalho.
+
+3. **Escreva o item como pergunta fechada.** "Contra-oferta considerada?" não "Verificar contra-ofertas" — a forma de pergunta força quem executa a marcar sim/não de verdade, em vez de passar o olho.
+
+4. **Cite a task ou o workflow que o item audita.** Um checklist solto, sem dizer o que ele verifica, não diz a quem executa quando rodá-lo.
+
+5. **Não duplique o `pre-deploy-checklist.md` nem o `clone-completeness-checklist.md`.** Esses dois já cobrem estrutura de squad e completude de tier — o checklist gerado aqui é sobre o **domínio da pessoa**, não sobre a mecânica do pacote.
+
+## Formato da saída
+Um `.md` por tema em `checklists/`, seguindo o padrão visual dos checklists desta casa: título, uma linha de contexto (`> Valida que X antes de Y`), e itens `- [ ] pergunta fechada`.
+
+## O que não vale
+- Item vago que não dá para marcar objetivamente.
+- Checklist genérico de "boas práticas" sem lastro na extração da pessoa.
+- Repetir os itens de `pre-deploy-checklist.md`/`clone-completeness-checklist.md` em vez de focar no domínio.
+- Checklist sem agrupamento, uma lista corrida de 20 itens.
+
+## Fontes no squad
+`knowledge-base/extraction-patterns.md` (Pattern 2 — heurísticas como origem de critério de qualidade), `checklists/clone-completeness-checklist.md` e `checklists/pre-deploy-checklist.md` (formato de referência e o que já está coberto em outro lugar, para não duplicar).

package/squads/squad-cloning/tasks/generate-cross-squad-handoffs.md

@@ -17,30 +17,60 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] receives_from inclui mind-synthesizer; delivers_to inclui squad-assembler"
+  - "[ ] Squads destino de KB batem com a tabela de cross-squad-deployment.md"
+  - "[ ] Tier de risco do uso pretendido checado contra o consent_status antes de listar destino publico"
+  - "[ ] Handoff bloqueado pela trava etica esta documentado, nao omitido"
+  - "[ ] Naming convention de KB deployado seguida quando aplicavel"
 ---
 
-# Task: generate-cross-squad-handoffs
-
-## Metadata
-- **Agent:** agent-forger (Forge)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Definir os handoffs cross-squad
 
 ## Objetivo
-Definir handoffs cross-squad
-
-## Steps
-1. Receber inputs da fase anterior
-2. Executar operacao principal
-3. Validar output contra criterios
-4. Entregar artefato para proxima fase
-
-## Criterios de Qualidade
-- Output segue formato esperado
-- Nenhum dado inventado
-- Tags de confianca aplicadas
-- Gaps documentados
+Preencher `relationships.receives_from` e `relationships.delivers_to` do agent.md e decidir para quais squads do ecossistema o conhecimento do clone pode ser distribuído — sem confundir "onde faria sentido mandar" com "onde é permitido mandar".
+
+## A regra que governa
+**A régua de deploy é a tabela de `cross-squad-deployment.md`, não achismo de afinidade temática.** E antes de qualquer squad destino de conteúdo público ou atribuído, o tier de risco do uso — definido em `ethical-guidelines.md` — decide se o handoff acontece ou se ele para e volta pro dono.
+
+## Passos
+
+1. **Preencher o handoff obrigatório do pipeline.** `receives_from` sempre inclui `mind-synthesizer` (entrega o cognitive-profile.md, Fase 4 do `full-clone-pipeline.yaml`); `delivers_to` sempre inclui `squad-assembler` (recebe o agent.md completo pra montar a squad, Fase 7/8). Isso não é opcional nem varia por domínio da pessoa.
+
+2. **Classificar o domínio da pessoa contra a Tabela de Deployment.** `cross-squad-deployment.md` mapeia tipo de conteúdo (estratégia de negócio, copy, growth, brand, produto...) para squads destino com prioridade Alta/Média/Baixa. Use essa tabela para listar candidatos — não para todos, só para os squads cujo tipo de KB bate com o que o clone realmente produziu.
+
+3. **Checar o tier de risco antes de confirmar qualquer destino de distribuição ampla.** `ethical-guidelines.md` define 5 níveis de risco por uso (consultoria privada → substituição de identidade). Handoff para um squad que vai **publicar** ou **atribuir conteúdo à pessoa** exige, no mínimo, "consentimento obrigatório" ou "aprovação explícita" — confira isso contra o `consent_status` que `generate-agent-persona` já registrou.
+   ⚠️ **Se o uso pretendido está em risco Alto ou superior e a base de consentimento é só `public_content_only`, a task não decide sozinha.** Ela para, nomeia o descompasso, e devolve a decisão ao dono — é decisão de risco, de custo dele assumir ou não.
+
+4. **Documentar o handoff negado, não omitir.** Quando um squad que seria destino natural fica de fora por causa da trava do passo 3, isso entra na saída explicitamente — "squad-copy seria destino de prioridade Alta, bloqueado até confirmação de consentimento explícito" — para que quem revisa veja a decisão, não a ausência dela.
+
+5. **Aplicar a naming convention quando o handoff virar deploy de KB.** `{source-mind-kebab-case}-{topic-kebab-case}.md`, conforme `cross-squad-deployment.md` — isso é o que o `kb-architect` vai usar na Fase 8, então precisa estar certo aqui.
+
+## Formato da saída
+Bloco `relationships` em YAML + lista de squads destino de KB com prioridade e status de aprovação:
+
+```yaml
+relationships:
+  receives_from:
+    - agent: "mind-synthesizer"
+      context: "cognitive-profile.md"
+  delivers_to:
+    - agent: "squad-assembler"
+      context: "agent.md completo"
+
+kb_deployment_candidates:
+  - squad: "squad-growth"
+    prioridade: "Alta"
+    status: "aprovado — legitimo interesse, figura publica"
+  - squad: "squad-copy"
+    prioridade: "Alta"
+    status: "bloqueado — uso pretendido e atribuido, consent_status insuficiente. Aguarda dono."
+```
+
+## O que não vale
+- Mandar KB para um squad só porque o tema combina, sem checar o tier de risco do uso.
+- Assumir consentimento porque "o conteúdo é público" quando o uso pretendido é comercial ou atribuído — são tiers diferentes na tabela de `ethical-guidelines.md`.
+- Esquecer `squad-assembler` como `delivers_to` obrigatório.
+- Omitir um handoff bloqueado em vez de registrá-lo com o motivo.
+
+## Fontes no squad
+`knowledge-base/cross-squad-deployment.md` (Tabela de Deployment, Naming Convention), `knowledge-base/ethical-guidelines.md` (Tier de Risco por Uso), `templates/clone-agent-template.md`.