iron-edge 1.2.0 → 2.0.1

package/squads/squad-cloning/tasks/generate-extraction-report.md

@@ -17,30 +17,37 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Numeros do resumo vem da auditoria de tag-confidence-levels, nao recalculados do zero"
+  - "[ ] Cada layer tem PASS/FAIL explicito contra o minimo do tier-alvo"
+  - "[ ] Secao de contradicoes preserva os dois lados, sem resumir a ponto de perder o contexto"
+  - "[ ] Gaps identificados estao escritos em linguagem que o dono do projeto entende"
+  - "[ ] Nota etica de uso esta presente e nao foi substituida por linguagem de aprovacao"
 ---
 
-# Task: generate-extraction-report
-
-## Metadata
-- **Agent:** cognitive-extractor (Cortex)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar relatório de extração
 
 ## Objetivo
-Gerar relatorio de extracao
-
-## 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
+Compilar o relatório final de extração — estatísticas por layer, distribuição de tags, contradições, gaps e recomendações — que segue para o cloning-orqx decidir o tier e para o mind-synthesizer sintetizar o perfil.
+
+## A regra que governa
+**O relatório existe para que quem decide o tier veja a evidência, não só o resultado.** Um relatório que esconde um gap para "fechar bonito" tira do dono a decisão que é dele — o que este squad faz é apontar a lacuna, não decidir sozinho se ela é aceitável.
+
+## Passos
+1. **Preencha o resumo** (palavras analisadas, fontes processadas, total de extrações, distribuição [DIRETO]/[INFERIDO]/[HIPOTESE]) com os números finais de `tag-confidence-levels` — não recalcule do zero, essa auditoria já é a fonte de verdade.
+2. **Para cada layer (1-4), liste a contagem encontrada contra o mínimo do tier-alvo, com PASS/FAIL explícito** — os pisos estão em `extraction-quality-checklist.md`.
+   ⚠️ PASS numa layer que só bateu o mínimo à custa de [HIPOTESE] inflado é PASS falso. O PASS vale para contagem qualificada — DIRETO e INFERIDO com evidência real — não para qualquer entrada que ocupe uma linha.
+3. **Inclua a seção de contradições** (resolvidas e não resolvidas) de `identify-contradictions` sem resumir a ponto de perder o "e se" de cada uma — o dono precisa ver o que ficou em aberto.
+4. **Escreva "Gaps Identificados":** o que era esperado e não foi encontrado, e o que falta para o tier superior — em linguagem que o dono do projeto entende, não jargão interno de layer e tag.
+5. **Escreva "Recomendações":** ação concreta para melhorar a qualidade (ex.: "buscar entrevistas de 2023-2024 para confirmar a heurística de CAC/LTV"), nunca "revisar tudo" genérico.
+6. **Feche com a nota ética obrigatória:** este relatório mede a confiança das fontes, não valida o clone para uso — publicar, distribuir ou usar comercialmente é decisão do dono do projeto, e passa por `ethical-guidelines.md` (Princípio 2, consentimento e base legal) antes de qualquer entrega além de uso interno de estudo.
+
+## Formato da saída
+Documento completo conforme `extraction-report-template.md` — resumo, quatro seções de layer com PASS/FAIL, contradições, gaps, recomendações.
+
+## O que não vale
+- Relatório sem seção de gaps ("está tudo ótimo" quando faltou cobertura).
+- Recomendação vaga ("melhorar a extração") sem ação concreta.
+- PASS/FAIL declarado sem o número ao lado que o justifica.
+
+## Fontes no squad
+`templates/extraction-report-template.md`, `checklists/extraction-quality-checklist.md` (mínimos por tier), `knowledge-base/confidence-scoring.md`, `knowledge-base/ethical-guidelines.md` (Princípio 2, consentimento e bases legais).

package/squads/squad-cloning/tasks/generate-framework-kbs.md

@@ -17,30 +17,75 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Um arquivo por framework/cluster listado na taxonomia, nome {topic}-framework.md"
+  - "[ ] Toda afirmacao tem tag [DIRETO]/[INFERIDO]/[HIPOTESE] com fonte"
+  - "[ ] Secao 'Quando usar' preenchida com gatilho concreto, nao generica"
+  - "[ ] Framework majoritariamente [HIPOTESE] esta sinalizado como emergente no Contexto"
+  - "[ ] Contexto declara que o KB e reconstrucao de fontes, nao a pessoa falando"
 ---
 
-# Task: generate-framework-kbs
-
-## Metadata
-- **Agent:** kb-architect (Archive)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar Framework KBs
 
 ## Objetivo
-Criar KBs de frameworks
-
-## 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 um Framework KB por mental model (ou cluster de mental models correlatos) já reservado na
+taxonomia, seguindo `templates/clone-kb-template.md` — o princípio de raciocínio da pessoa, pronto
+para ser consultado no momento em que um squad precisa dele.
+
+## A regra que governa
+**Um framework sem "quando usar" não é achável no momento em que importa.** Não basta o KB existir
+e estar bem escrito — ele precisa dizer, em uma frase, a situação que deveria fazer alguém abri-lo.
+Sem isso, mesmo um framework tecnicamente correto vira o mesmo tipo de KB morto que a taxonomia foi
+desenhada para evitar.
+
+## Passos
+
+1. **Pegue cada mental model marcado como Framework na taxonomia** (task `design-kb-taxonomy`) —
+   não reabra a decisão de tipo ou squad destino aqui, só execute o que já foi definido.
+
+2. **Preencha o template inteiro.** `templates/clone-kb-template.md` na seção de Framework KBs:
+   título, Contexto (de que fontes veio, quantas palavras, que layer), princípios numerados, "Quando
+   usar" e Steps quando o framework for aplicável passo a passo.
+   ⚠️ **"Quando usar" genérico ("em decisões de negócio") não orienta ninguém** — escreva a situação
+   específica que dispara a consulta, do jeito que `memory-architecture-for-clones.md` descreve o
+   gatilho de promoção semântica: o que na conversa deveria puxar este KB para o contexto ativo.
+
+3. **Tag toda afirmação.** [DIRETO] com citação e fonte específica, [INFERIDO] com 3+ fontes de
+   suporte, [HIPOTESE] com aviso de que precisa validação — pesos e critérios em
+   `confidence-scoring.md`. Nenhuma linha de princípio ou step sem tag.
+   ⚠️ **Se a maioria dos princípios do framework é [HIPOTESE], o framework não está pronto para
+   ser apresentado como estabelecido.** Sinalize no Contexto como "framework emergente, baixa
+   confiança" em vez de deixar o leitor assumir que é regra confirmada.
+
+4. **Separe anti-patterns quando a pessoa disse explicitamente o que não fazer** — seção própria do
+   template, não misturado com os princípios.
+
+5. **Preencha Aplicação com o squad e a tarefa concretos** definidos na taxonomia: que agente,
+   fazendo o quê, consulta este framework. Isso fecha o ciclo de achabilidade aberto na taxonomia.
+
+6. **Respeite o tamanho de 80 a 200 linhas** (`kb-generation-guide.md`). Framework curto demais é
+   sinal de que devia ter virado um Pattern; framework longo demais geralmente mistura mais de um
+   mental model — separe.
+
+7. **Declare no Contexto que o KB é reconstrução, não a pessoa falando.** Uma linha curta bastando:
+   "reconstruído a partir de fontes públicas/autorizadas, não é declaração oficial de {pessoa}" —
+   Princípio 1 de `ethical-guidelines.md`. Se a taxonomia marcou este mental model como sensível,
+   inclua também a base legal usada, citando `ethical-guidelines.md`.
+
+## Formato da saída
+Um arquivo `{topic}-framework.md` por item da taxonomia, seguindo `templates/clone-kb-template.md`.
+Exemplo de linha de princípio: `**Ofertas simples vencem ofertas complexas:** se a oferta exige mais
+de 30 segundos de explicação, simplifique. [INFERIDO] (Livro cap. 4, Podcast EP 156, Entrevista X)`.
+
+## O que não vale
+- Framework sem "Quando usar" ou com essa seção repetindo o Objetivo.
+- Afirmação sem tag de confiança.
+- Framework "importado" de outra pessoa e atribuído ao target por semelhança.
+- KB que não diz, em nenhuma linha, que é uma representação — não a pessoa real.
+
+## Fontes no squad
+`templates/clone-kb-template.md` (estrutura do Framework KB),
+`knowledge-base/kb-generation-guide.md` (tamanho, formato obrigatório, regras de citação),
+`knowledge-base/confidence-scoring.md` (peso e critério de cada tag),
+`knowledge-base/cognitive-dna-framework.md` (Layer 1 — o que conta como mental model),
+`knowledge-base/memory-architecture-for-clones.md` (gatilho de recuperação do "Quando usar"),
+`knowledge-base/ethical-guidelines.md` (declaração de transparência obrigatória).

package/squads/squad-cloning/tasks/generate-methodology-kbs.md

@@ -17,30 +17,75 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada methodology tem trigger, steps com output e exit conditions preenchidos"
+  - "[ ] Nenhum step usa verbo generico ('analisar X') sem dizer o que e como"
+  - "[ ] SOP com menos de 3 steps foi devolvido para virar Pattern"
+  - "[ ] Decision points criticos viraram arvore de decisao quando existentes"
+  - "[ ] Workflow que cita dado de terceiro foi anonimizado antes de publicar"
 ---
 
-# Task: generate-methodology-kbs
-
-## Metadata
-- **Agent:** kb-architect (Archive)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar Methodology KBs
 
 ## Objetivo
-Criar KBs de metodologias
-
-## 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
+Transformar os SOPs e workflows (Layer 3) já reservados na taxonomia em Methodology KBs replicáveis
+— processos step-by-step com gatilho, pontos de decisão e condição de saída, não apenas uma lista de
+fases genéricas.
+
+## A regra que governa
+**SOP sem trigger claro e sem exit condition não é um SOP publicável — é um gap.** `sop-extraction-guide.md`
+lista os dois como red flags que tornam o processo inútil para quem for aplicá-lo: sem trigger, o
+clone não sabe quando usar; sem exit condition, não sabe quando parar. Nenhum dos dois se resolve
+inventando — se a fonte não deu isso, documente como lacuna, não complete por conta própria.
+
+## Passos
+
+1. **Pegue os workflows/SOPs marcados como Methodology na taxonomia.** Reconstrua a anatomia
+   completa descrita em `sop-extraction-guide.md`: trigger, preconditions, steps com output
+   esperado, exit conditions (success e abort), variants e anti-patterns — preencha só o que as
+   fontes sustentam.
+
+2. **Escreva cada step como ação, não como tópico.** Preencha a seção Methodology do template
+   (`templates/clone-kb-template.md`): fase numerada, descrição detalhada, tag de confiança.
+   ⚠️ **"Analisar o mercado" não é um step — é um red flag** (`sop-extraction-guide.md`). Reescreva
+   até dizer o que exatamente é analisado e com que critério, do jeito que o guia pede: específico e
+   acionável.
+
+3. **Inclua pontos de decisão quando existirem.** Quando o SOP se ramifica ("se X, faça Y; se Z,
+   faça W"), monte a árvore de decisão no formato de `sop-extraction-guide.md` ("Decision Tree
+   Mapping") em vez de esconder a ramificação dentro de um único step em prosa.
+
+4. **Feche com exit conditions explícitas.** Success (quando o processo terminou bem) e abort
+   (quando encerrar sem completar, e por quê) — sem isso o Methodology KB descreve um processo que
+   nunca sabe se chegou ao fim.
+
+5. **Aplique a régua heuristic vs. SOP.** Se o processo tem menos de 3 steps e nenhum ponto de
+   decisão, devolva para `generate-pattern-kbs` — é heurística, não metodologia, e forçar aqui infla
+   o KB sem adicionar conteúdo real.
+
+6. **Tag cada step e cite a técnica de extração usada** (Técnica 1 a 4 de `sop-extraction-guide.md`
+   — exemplo concreto, elicitação de decisão, reconstrução de ensino, ou engenharia reversa de
+   output) na fonte do step, para quem for auditar depois saber como aquele step foi reconstruído.
+
+7. **Respeite 100 a 250 linhas** (`kb-generation-guide.md`) e revise privacidade de terceiros. Se o
+   workflow cita nome, empresa ou dado de outra pessoa que não o target (ex: "processo de
+   contratação" com nome de candidato), anonimize antes de publicar — princípio de anti-fabricação e
+   proteção de terceiros em `ethical-guidelines.md`.
+
+## Formato da saída
+Um arquivo `{topic}-methodology.md` por SOP da taxonomia, seguindo `templates/clone-kb-template.md`.
+Exemplo de step: `**Fase 2 — Validação com grupo pequeno:** testar a oferta com 10 pessoas antes de
+abrir para a lista completa; output esperado: taxa de conversão de referência. [INFERIDO] (3 exemplos
+distintos, Técnica 1 de sop-extraction-guide.md)`.
+
+## O que não vale
+- Step com verbo genérico sem dizer o quê e como.
+- Metodologia sem exit condition, ou com exit condition inventada para "fechar bonito".
+- SOP de 1-2 steps mantido aqui em vez de virar Pattern KB.
+- Ponto de decisão real escondido em prosa contínua em vez de estruturado como árvore.
+
+## Fontes no squad
+`templates/clone-kb-template.md` (estrutura do Methodology KB),
+`knowledge-base/sop-extraction-guide.md` (anatomia do SOP, técnicas de extração, red flags),
+`knowledge-base/kb-generation-guide.md` (tamanho e formato obrigatório),
+`knowledge-base/confidence-scoring.md` (tags por step),
+`knowledge-base/ethical-guidelines.md` (anonimização de terceiros e anti-fabricação).

package/squads/squad-cloning/tasks/generate-mind-map.md

@@ -17,30 +17,43 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Todo no do grafo tem pelo menos 1 aresta (nenhum item isolado sem conexao)"
+  - "[ ] Nenhum loop em DERIVES_FROM (um principio nao deriva dele mesmo)"
+  - "[ ] Toda aresta de confianca alta tem um no Source associado"
+  - "[ ] Arestas REFINES usam a evolucao ja datada por resolve-contradictions, nao uma nova leitura da contradicao"
+  - "[ ] O arquivo declara, em uma linha, que o grafo e uma representacao extraida, nao a pessoa"
 ---
 
-# Task: generate-mind-map
-
-## Metadata
-- **Agent:** mind-synthesizer (Synth)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar o mind map cognitivo
 
 ## Objetivo
-Criar mind map de conexoes
-
-## 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
+Transformar o `cognitive-profile.md` consolidado num grafo — nós e relações entre mental models, heurísticas, workflows e meta-patterns — que mostra como as peças da mente extraída se conectam, e que serve de base de retrieval estruturado para o clone final.
+
+## A regra que governa
+**O grafo é a representação das conexões que os dados sustentam, não uma teia inventada para parecer completa.** Toda aresta precisa de evidência rastreável até uma fonte; um nó sem nenhuma conexão não é um problema de estilo, é um sinal de que aquele item ficou solto na extração — e isso deve aparecer no relatório, não ser escondido atrás de um layout bonito.
+
+## Passos
+
+1. **Crie um nó para cada item do perfil.** Um nó `Principle` por mental model (L1), `Heuristic` por regra de decisão (L2), `Workflow` por processo (L3), `MetaPattern` por padrão de L5, e `Source` para cada fonte citada — seguindo a ontologia de `knowledge-graph-for-clones.md`. Cada nó carrega a tag de confiança herdada do item original, sem retaguear.
+
+2. **Identifique as relações entre os nós.** Use os tipos de aresta do knowledge-base: `DERIVES_FROM` (heurística deriva de princípio), `IMPLEMENTS` (workflow implementa princípio), `APPLIES_TO` (heurística se aplica a um domínio), `UNIFIES` (meta-pattern unifica múltiplos princípios), `EXTRACTED_FROM` (qualquer nó até sua fonte). Toda aresta leva uma justificativa curta e sua própria tag de confiança — a aresta pode ser [HIPÓTESE] mesmo que os dois nós que ela liga sejam [DIRETO].
+
+3. **Trate a evolução temporal como aresta `REFINES`, usando o que `resolve-contradictions` já datou.** Uma posição superada e a posição atual não viram dois nós desconectados — viram dois nós ligados por `REFINES`, com `valid_from`/`valid_to`, exatamente como resolvido antes. Não reabra a contradição aqui; esta task usa a resolução, não a reinterpreta.
+
+4. **Rode os checks de qualidade do grafo antes de fechar.** Direto de `knowledge-graph-for-clones.md`: (a) conectividade — todo nó tem ao menos 1 aresta; (b) consistência — nenhum loop de `DERIVES_FROM` (um princípio não deriva dele mesmo); (c) proporção — a razão DIRETO/INFERIDO/HIPÓTESE das arestas deve refletir o confidence score já calculado, não destoar dele; (d) proveniência — toda aresta de confiança alta tem um nó `Source` associado.
+
+5. **Nó isolado é achado, não defeito a esconder.** Se um mental model não se conecta a nenhuma heurística ou workflow, isso não se resolve forçando uma relação fraca — vira uma nota no relatório: "Princípio X extraído mas sem heurística ou workflow correspondente encontrado — possível gap de cobertura".
+
+6. **Declare, na abertura do arquivo, que o grafo representa o que foi extraído — não a pessoa em si.** É a mesma trava de transparência que vale para todo artefato gerado neste squad: o mapa é do material coletado, com os limites de confiança que ele carrega, não um retrato completo de como a pessoa pensa.
+
+## Formato da saída
+Um arquivo `cognitive_graph_{target_id}.yaml` no schema de `knowledge-graph-for-clones.md`: metadata (tier, confidence score, contagem de nós e arestas), lista de `nodes` por tipo, lista de `edges` com `from`, `to`, `type`, `confidence` e `justification`. Nós sem conexão e gaps de cobertura vão numa seção `coverage_notes` à parte.
+
+## O que não vale
+- Inventar uma aresta fraca só para eliminar um nó isolado do grafo.
+- Aresta `CONTRADICTS` para uma contradição que `resolve-contradictions` já resolveu como evolução temporal — nesse caso a aresta é `REFINES`, não `CONTRADICTS`.
+- Grafo bonito e denso que não bate com a proporção real de [DIRETO]/[INFERIDO]/[HIPÓTESE] do confidence score.
+- Entregar o grafo sem a linha de abertura que declara que é uma representação extraída, não a pessoa.
+
+## Fontes no squad
+`knowledge-base/knowledge-graph-for-clones.md` (ontologia de nós e arestas, exemplo de grafo, checks de qualidade, schema de persistência, grafo bi-temporal para evolução), `templates/cognitive-profile-template.md` (fonte dos dados consolidados que viram nós), `knowledge-base/ethical-guidelines.md` (Princípio 1 — transparência obrigatória sobre o que é representação extraída, não a pessoa real).

package/squads/squad-cloning/tasks/generate-pattern-kbs.md

@@ -17,30 +17,73 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada pattern lista 'quando ocorre' como gatilho reconhecivel, nao descricao vaga"
+  - "[ ] Pattern com 1 ocorrencia esta marcado [HIPOTESE] e separado dos confirmados"
+  - "[ ] Heuristic com mais de 3 linhas foi devolvida para virar Methodology, nao forcada aqui"
+  - "[ ] Anti-patterns em tabela separada dos patterns"
+  - "[ ] Conteudo de comunicacao/tom sensivel foi checado contra ethical-guidelines.md"
 ---
 
-# Task: generate-pattern-kbs
-
-## Metadata
-- **Agent:** kb-architect (Archive)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar Pattern KBs
 
 ## Objetivo
-Criar KBs de padroes
-
-## 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 um Pattern KB por cluster de heurísticas (Layer 2) e padrões de comunicação (Layer 4) já
+reservado na taxonomia — regras recorrentes com o gatilho que diz quando cada uma se aplica.
+
+## A regra que governa
+**Um pattern só existe se aparece em 2 ou mais fontes.** O que aparece uma única vez é hipótese, não
+padrão — e vai para uma seção separada, marcado como tal. Misturar os dois na mesma tabela sem
+distinção é a forma mais comum de um Pattern KB inflar confiança que não tem.
+
+## Passos
+
+1. **Pegue as heurísticas e os padrões de comunicação marcados como Pattern na taxonomia** — a
+   decisão de tipo e squad destino já foi tomada em `design-kb-taxonomy`, esta task só escreve.
+
+2. **Preencha a tabela do template** (`templates/clone-kb-template.md`, seção Pattern KB): Pattern |
+   Descrição | Quando ocorre | Confiança.
+   ⚠️ **"Quando ocorre" é o gatilho de reconhecimento** — sem ele, quem está numa situação real não
+   sabe que aquele pattern se aplica ali. "Quando o cliente pede desconto" reconhece; "em situações
+   de negociação" não reconhece nada.
+
+3. **Separe pattern confirmado de pattern de ocorrência única.** Se o padrão apareceu em 2+ fontes
+   independentes, é [INFERIDO]; em uma só, é [HIPOTESE] e vai para uma seção à parte, nunca
+   misturado na tabela principal como se tivesse o mesmo peso — critério em `confidence-scoring.md`.
+
+4. **Distinga heuristic de SOP disfarçado.** `sop-extraction-guide.md` dá a régua prática: se o
+   padrão precisa de mais de 3 linhas para ser descrito, ou tem múltiplos steps com pontos de
+   decisão, não é um Pattern — é um Methodology KB. Devolva para `generate-methodology-kbs`, não
+   force a informação num formato que não cabe.
+
+5. **Liste anti-patterns numa seção própria**, sempre que a pessoa disse explicitamente "eu nunca
+   faço X" — não misturado com os patterns positivos, para que a leitura não confunda "isto é o que
+   ela faz" com "isto é o que ela evita".
+
+6. **Respeite 60 a 150 linhas** (`kb-generation-guide.md`). Pattern KB é tabela e exemplos, não
+   ensaio — se está passando disso, provavelmente virou uma Methodology.
+
+7. **Revise conteúdo de tom/comunicação sensível.** Padrões de vocabulário que revelam posição
+   política, religiosa ou de saúde exigem a checagem de `ethical-guidelines.md` (Princípio 4 — o
+   que o clone não pode fazer) antes de irem para um KB de squad público.
+
+## Formato da saída
+Um arquivo `{topic}-patterns.md` por cluster da taxonomia, seguindo `templates/clone-kb-template.md`.
+Exemplo:
+
+| Pattern | Descrição | Quando ocorre | Confiança |
+|---|---|---|---|
+| Reformulação em pergunta | Devolve objeção como pergunta ao invés de responder direto | Cliente questiona preço | [INFERIDO] |
+
+## O que não vale
+- Pattern com "quando ocorre" igual à descrição, sem gatilho de fato.
+- Pattern de 1 fonte apresentado junto dos confirmados sem distinção visual.
+- Heurística de várias etapas forçada na tabela de patterns em vez de virar Methodology.
+- Pattern KB sem seção de anti-patterns quando a pessoa deixou anti-patterns explícitos nas fontes.
+
+## Fontes no squad
+`templates/clone-kb-template.md` (formato da tabela Pattern KB),
+`knowledge-base/kb-generation-guide.md` (tamanho e formato obrigatório),
+`knowledge-base/sop-extraction-guide.md` (regra prática heuristic vs. SOP),
+`knowledge-base/confidence-scoring.md` (critério [INFERIDO] vs. [HIPOTESE]),
+`knowledge-base/cognitive-dna-framework.md` (Layer 2 e Layer 4),
+`knowledge-base/ethical-guidelines.md` (limites de conteúdo sensível).

package/squads/squad-cloning/tasks/generate-reference-kbs.md

@@ -17,30 +17,74 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada linha aponta para o KB de origem via 'Ver tambem', nao e copia solta"
+  - "[ ] Categorias organizadas por assunto real, nao por nomenclatura de layer interna"
+  - "[ ] Toda linha tem tag de confianca"
+  - "[ ] Base legal (LGPD) declarada no Contexto do KB"
+  - "[ ] Item sensivel revisado contra a tabela de classificacao de ethical-guidelines.md"
 ---
 
-# Task: generate-reference-kbs
-
-## Metadata
-- **Agent:** kb-architect (Archive)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar Reference KBs
 
 ## Objetivo
-Criar KBs de referencia
-
-## 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
+Compilar, num Reference KB por categoria da taxonomia, os princípios e regras cross-layer que servem
+de índice geral do pensamento do target — sem duplicar o conteúdo dos Framework/Pattern/Methodology
+KBs, apontando para eles.
+
+## A regra que governa
+**Reference KB é compilação com endereço, não resumo solto.** Cada linha precisa dizer de onde veio
+— qual Framework, Pattern ou Methodology KB detalha aquele princípio. Sem esse link, o Reference vira
+uma segunda versão do mesmo conteúdo que ninguém sabe qual é a fonte da verdade quando as duas
+divergirem.
+
+## Passos
+
+1. **Reúna o que é cross-layer ou serve de índice geral** — itens que a taxonomia não colocou
+   sozinhos em nenhum Framework/Pattern/Methodology específico, ou que precisam aparecer resumidos
+   num único lugar de consulta rápida (`kb-generation-guide.md`: Reference KB é "compilação de todas
+   as layers").
+
+2. **Organize por categoria de assunto, não por layer do pipeline.** Quem consulta um Reference KB
+   não pensa em "Layer 1, Layer 2" — pensa em "Precificação", "Contratação", "Comunicação com
+   cliente". Nomear a categoria pelo assunto real é o mesmo princípio de achabilidade que rege o
+   nome dos arquivos na taxonomia.
+
+3. **Preencha a tabela do template** (`templates/clone-kb-template.md`, seção Reference KB): # |
+   Princípio/Regra | Descrição | Confiança — e acrescente uma coluna ou linha "Ver também" apontando
+   para o Framework/Pattern/Methodology KB onde aquele princípio foi detalhado originalmente.
+   ⚠️ **Linha sem link de origem é a armadilha deste KB.** Ele existe para orientar, não para
+   substituir o KB completo — sem o link, quem lê não sabe se está vendo a versão inteira ou um
+   recorte.
+
+4. **Tag toda linha** conforme `confidence-scoring.md` — o Reference não herda a tag do KB de
+   origem automaticamente; reconfira, porque a compilação às vezes junta partes de confiança
+   diferente sob o mesmo princípio.
+
+5. **Respeite 80 a 200 linhas** (`kb-generation-guide.md`).
+
+6. **Revise a base legal antes de fechar.** O Reference KB é o lugar onde é mais fácil compilar dado
+   sensível sem perceber, porque junta tudo num só arquivo. Antes de publicar, confira cada linha
+   contra a tabela "Dado tratado × Classificação LGPD" de `ethical-guidelines.md` e declare no
+   Contexto do KB a base legal usada (`public_content_only`, `notified` ou `explicit_consent`). Onde
+   a base legal não estiver clara na taxonomia, pergunte ao dono do clone antes de incluir o item —
+   não decida sozinho.
+
+## Formato da saída
+Um arquivo `{topic}-reference.md` por categoria da taxonomia, seguindo `templates/clone-kb-template.md`.
+Exemplo:
+
+| # | Princípio/Regra | Descrição | Confiança | Ver também |
+|---|---|---|---|---|
+| 1 | Preço nunca fixo no primeiro contato | Sempre qualifica antes de cotar | [DIRETO] | `sales-methodology.md` |
+
+## O que não vale
+- Reference KB que copia o texto inteiro de outro KB em vez de resumir com link.
+- Categoria nomeada "Layer 1" ou "Diversos" em vez de assunto real.
+- Item sem base legal revisada quando toca dado sensível.
+- Linha sem tag de confiança porque "já está tagueada no KB de origem".
+
+## Fontes no squad
+`templates/clone-kb-template.md` (estrutura do Reference KB),
+`knowledge-base/kb-generation-guide.md` (definição de Reference KB, tamanho, formato obrigatório),
+`knowledge-base/ethical-guidelines.md` (tabela de classificação LGPD e base legal por tipo de clone),
+`knowledge-base/confidence-scoring.md` (tags por linha).

package/squads/squad-cloning/tasks/generate-squad-yaml.md

@@ -6,41 +6,53 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
+  - campo: assembled_artifacts
     tipo: object
-    origem: "pipeline"
+    origem: "agent.md (Phase 5), knowledge-base/*.md (Phase 6), tasks/ e workflows/ (Phase 7) — ja em disco"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: squad_yaml
     tipo: document
-    destino: "next phase"
+    destino: "squad.yaml na raiz do squad do clone — consumido por run-pre-publish-checklist"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] name em kebab-case, version em semver"
+  - "[ ] Toda entrada de agents/knowledge_bases/workflows aponta pra arquivo que existe em disco"
+  - "[ ] Contagens (agents_count, tasks_count, kb_count) batem com o que foi contado, nao estimado"
+  - "[ ] agent listado ja tem ethical_declaration preenchida no seu agent.md"
 ---
 
-# Task: generate-squad-yaml
-
-## Metadata
-- **Agent:** squad-assembler (Assembly)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar o squad.yaml do clone
 
 ## Objetivo
-Criar squad.yaml manifest
-
-## 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 manifesto `squad.yaml` do squad do clone — o arquivo que declara ao resto do ecossistema Iron Edge o que esse squad tem e onde está, e que o instalador e o resto da casa vão tomar como verdade.
+
+## A regra que governa
+**A casa mede, não estima.** O `squad.yaml` declara o que existe em disco neste exato momento, nunca o que "deveria" existir quando o pipeline terminar. Esta mesma regra derrubou pacotes desta casa antes: manifesto que promete arquivo que não existe é o defeito que o lint (`R16`) existe para pegar — e pegar depois é mais caro que escrever certo agora.
+
+## Passos
+
+1. **Liste o que está fisicamente na pasta antes de escrever qualquer linha.** `agents/`, `knowledge-base/`, `tasks/`, `workflows/`, `checklists/`, `templates/` — cada arquivo real vira uma entrada; nenhuma entrada nasce sem arquivo correspondente.
+
+2. **Preencha os campos obrigatórios do manifesto**: `name` (kebab-case, 2-50 chars), `version` (semver, "1.0.0" na primeira publicação), `description`, `slashPrefix`, `iron-edge.minVersion` e `type: squad`, seguindo a seção "squad.yaml" do `pre-deploy-checklist.md`.
+
+3. **Liste `agents` com id, name, file, role** — um agente por clone Tier 3 (o próprio clone), apontando para o `agents/agent.md` gerado na Fase 5.
+
+4. **Liste `knowledge_bases` e `workflows`** com os nomes reais de arquivo — nunca o nome que o KB "teria" antes de `kb-architect` terminar. Se a Fase 6 ainda não fechou, esta task não roda.
+
+5. **Confira que o agente listado já carrega `ethical_declaration`.** Não é papel desta task preencher a declaração ética — isso é do `agent-forger` na Fase 5 — mas é papel desta task barrar: se o campo estiver vazio no agent.md, pare e devolva à Fase 5 em vez de gerar um manifesto que aponta para um agente incompleto.
+
+6. **Calcule as contagens contando, não copiando de outro squad como modelo.** `agents_count`, `tasks_count`, `kb_count`, `workflows_count` são o resultado de `ls`, não um número redondo que "parece certo" para um Tier 3.
+
+## Formato da saída
+`squad.yaml` na raiz do squad do clone, seguindo a estrutura de seções já usada pelos squads desta casa (cabeçalho, `agents`, `knowledge_bases`, `workflows`, metadata de contagens) — ver `squad.yaml` deste próprio squad-cloning como referência de forma.
+
+## O que não vale
+- Entrada de `agents`/`knowledge_bases`/`workflows` que aponta para arquivo ainda não gerado.
+- Contagem estimada em vez de contada.
+- Squad.yaml gerado antes das Fases 5-7 fecharem de fato.
+- Manifesto que lista um agente sem `ethical_declaration`.
+
+## Fontes no squad
+`checklists/pre-deploy-checklist.md` (seção squad.yaml e Naming Conventions), `squad.yaml` (formato de referência deste próprio squad), `knowledge-base/ethical-guidelines.md` (campo `ethical_declaration` obrigatório no agent referenciado).