iron-edge 1.1.0 → 2.0.0

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).

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

@@ -6,41 +6,58 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
-    tipo: object
-    origem: "pipeline"
+  - campo: cognitive_profile
+    tipo: document
+    origem: "mind-synthesizer (Phase 4) — Layer 3: Workflows & Processes"
+    obrigatorio: true
+  - campo: agent_md
+    tipo: document
+    origem: "agent-forger (Phase 5) — protocols e agent id"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: task_files
     tipo: document
-    destino: "next phase"
+    destino: "tasks/*.md do squad do clone — consumido por generate-workflow-files"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada task nasce de um workflow com tag [DIRETO] ou [INFERIDO], nunca [HIPOTESE]"
+  - "[ ] Minimo de 6 tasks geradas (gate Tier 3)"
+  - "[ ] `responsavel` de cada task usa o agent id (ex. clone-{nome}), nunca o nome da pessoa"
+  - "[ ] Nenhuma task descreve passo generico tipo 'executar operacao principal'"
+  - "[ ] Toda task cita a fonte (workflow #, layer, confianca) que a originou"
 ---
 
-# Task: generate-task-files
-
-## Metadata
-- **Agent:** squad-assembler (Assembly)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar arquivos de task do clone
 
 ## Objetivo
-Gerar task files Tier 3
-
-## 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 workflow documentado da Layer 3 do `cognitive-profile.md` em um arquivo de task executável — a diferença entre um clone que só opina e um clone que sabe operar como a pessoa operava.
+
+## A regra que governa
+**Task nasce do workflow documentado, não do que parece faltar para o squad ficar completo.** Se não existe um workflow com tag [DIRETO] ou [INFERIDO] por trás, não existe task — o gap fica registrado, não preenchido por imaginação.
+
+## Passos
+
+1. **Levante os workflows elegíveis.** Percorra a seção "Layer 3: Workflows & Processes" do `cognitive-profile-template.md` (já preenchido pelo mind-synthesizer) e os `protocols` do agent.md gerado por `agent-generation-guide.md`. Descarte qualquer workflow cujos steps sejam majoritariamente [HIPOTESE] — vira gap documentado, não task.
+   ⚠️ Um workflow reconstruído por analogia ("a pessoa faz algo parecido com isso em 3 exemplos") ainda pode virar task, mas *toda* task derivada dele carrega [INFERIDO] visível, não some no meio do texto.
+
+2. **Mapeie 1 workflow → 1 ou mais tasks.** Workflow curto e coeso vira uma task; workflow longo com fases distintas vira uma task por fase, encadeadas por `Entrada`/`Saida`.
+
+3. **Escreva cada task no formato desta casa**: frontmatter (`task`, `responsavel`, `responsavel_type`, `atomic_layer`, `elicit`, `Entrada`, `Saida`, `Checklist` específico) e corpo com Objetivo, a regra que governa aquele passo específico da pessoa, Passos concretos (nas palavras/estilo dela, não genéricos), Formato da saída e O que não vale.
+   ⚠️ `responsavel` é o agent id do clone (o mesmo `id` do agent.md), nunca o nome da pessoa — o clone-completeness-checklist.md exige isso.
+
+4. **Garanta o mínimo do tier.** Tier 3 exige 6 tasks no mínimo (`clone-tier-standards.md`). Menos que isso e o squad não fecha Fase 7 — reporte o gap a `cloning-orqx` em vez de inflar com tasks sem lastro.
+
+5. **Registre a proveniência.** No frontmatter ou no corpo, cite o workflow de origem e sua tag de confiança — quem for auditar depois precisa achar o rastro sem reabrir o `cognitive-profile.md`.
+
+## Formato da saída
+Um arquivo `.md` por task em `tasks/`, kebab-case, verbo-ação no nome (`negociar-preco.md`, não `negociacao.md`). Exemplo de linha de proveniência no corpo: `Fonte: Layer 3, workflow "Fechamento de proposta" [DIRETO], cognitive-profile.md.`
+
+## O que não vale
+- Task que replica o molde vazio ("Receber inputs / Executar operação principal / Validar / Entregar") — é exatamente o defeito que esta reescrita corrige.
+- Task inventada para "completar" o squad quando não há workflow correspondente.
+- `responsavel` com o nome real da pessoa em vez do agent id.
+- Task sem nenhuma tag de confiança rastreável até a fonte.
+
+## Fontes no squad
+`templates/cognitive-profile-template.md` (estrutura da Layer 3), `knowledge-base/agent-generation-guide.md` (mapeamento workflow → protocol), `knowledge-base/extraction-patterns.md` (Pattern 3, reconstrução de workflow implícito), `checklists/clone-completeness-checklist.md` (mínimo de tasks e regra do `responsavel`), `knowledge-base/ethical-guidelines.md` (Princípio 3 — nunca inventar o que não foi extraído).

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

@@ -6,41 +6,52 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
-    tipo: object
-    origem: "pipeline"
+  - campo: cognitive_profile
+    tipo: document
+    origem: "mind-synthesizer — Layer 4 (comunicacao) e content patterns extraidos"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: template_files
     tipo: document
-    destino: "next phase"
+    destino: "templates/*.md e assets/templates/ do squad do clone"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Cada template vem de 2+ exemplos reais com a mesma estrutura, nunca de 1 exemplo isolado"
+  - "[ ] Placeholders substituem o conteudo variavel, nao o vocabulario fixo da pessoa"
+  - "[ ] Nenhum jargao ou expressao que a pessoa nao usa foi introduzido"
+  - "[ ] Template indica 'quando usar' de forma concreta"
 ---
 
-# Task: generate-template-files
-
-## Metadata
-- **Agent:** squad-assembler (Assembly)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar templates de output do clone
 
 ## Objetivo
-Gerar templates
-
-## 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 a estrutura repetida que a pessoa usa para produzir um tipo de artefato (proposta, roteiro, resposta padrão) e transformar em template reutilizável pelo squad do clone.
+
+## A regra que governa
+**Template captura estrutura observada 2+ vezes, não a estrutura que pareceria mais eficiente.** Um exemplo isolado é estilo pessoal daquele dia, não padrão — vira template só quando se repete.
+
+## Passos
+
+1. **Junte os exemplos.** Volte às fontes brutas (via `cognitive-profile.md` e as citações de Layer 4) e separe pelo menos 2 casos do mesmo tipo de output — dois emails de recusa, três aberturas de proposta, etc.
+
+2. **Marque o que se repete e o que muda.** O que se repete (ordem das seções, tom de abertura, forma de fechar) vira a estrutura fixa do template. O que muda (nome, número, contexto específico) vira `{placeholder}`.
+   ⚠️ Não transforme em placeholder uma expressão que a pessoa sempre usa da mesma forma — isso é vocabulário fixo dela (Layer 4), não variável do template. Trocar "a minha regra é simples" por `{abertura}` apaga a voz que o clone existe para preservar.
+
+3. **Escreva o template com uma nota de uso.** Cada template carrega uma linha curta dizendo quando ele se aplica — sem isso, quem for usar o clone não sabe se aquele template serve para a situação.
+
+4. **Guarde os templates na estrutura certa.** Templates de raciocínio/estrutura interna vão em `templates/`; se o clone for exportado como SKILL.md (ver `skill-standard-for-clones.md`), os mesmos templates de output também povoam `assets/templates/` dentro da pasta `clones/{source-mind-kebab}/`.
+
+5. **Teste contra um terceiro exemplo, se existir.** Se há um terceiro caso disponível que não foi usado para montar o template, verifique se ele encaixa na estrutura proposta. Se não encaixa, a estrutura estava específica demais — revise antes de fechar.
+
+## Formato da saída
+Um `.md` por template em `templates/`, com a estrutura + placeholders + a linha "Quando usar". Exemplo de placeholder: `{objecao_do_cliente}` no lugar do conteúdo variável, mantendo intacta a frase de abertura fixa da pessoa.
+
+## O que não vale
+- Template criado a partir de um único exemplo.
+- Placeholder que apaga expressão característica da pessoa.
+- Template genérico "de mercado" colado por cima do que foi extraído.
+- Template sem indicação de quando aplicar.
+
+## Fontes no squad
+`knowledge-base/extraction-patterns.md` (Pattern 4 — vocabulário, tom, catchphrases), `knowledge-base/skill-standard-for-clones.md` (pasta `assets/templates/` na estrutura de exportação SKILL.md), `templates/clone-kb-template.md` (referência de como este squad já estrutura um template com seções fixas e variáveis).

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

@@ -6,41 +6,57 @@ atomic_layer: Task
 elicit: false
 
 Entrada:
-  - campo: context
-    tipo: object
-    origem: "pipeline"
+  - campo: task_files
+    tipo: document
+    origem: "generate-task-files (mesma fase) — tasks/*.md ja gerados"
+    obrigatorio: true
+  - campo: cognitive_profile
+    tipo: document
+    origem: "mind-synthesizer — ordem real dos processos documentados"
     obrigatorio: true
 
 Saida:
-  - campo: resultado
+  - campo: workflow_files
     tipo: document
-    destino: "next phase"
+    destino: "workflows/*.yaml do squad do clone — consumido por run-pre-publish-checklist"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Toda task citada num workflow existe de fato em tasks/"
+  - "[ ] A ordem das fases reflete a sequencia que a pessoa segue, nao uma ordem logica generica"
+  - "[ ] Cada fase tem agent, tasks, output e quality_gate preenchidos"
+  - "[ ] Nenhum workflow orfao: toda task gerada aparece em pelo menos um workflow"
+  - "[ ] Nome do arquivo em kebab-case e reflete o processo, nao 'workflow-1'"
 ---
 
-# Task: generate-workflow-files
-
-## Metadata
-- **Agent:** squad-assembler (Assembly)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Gerar arquivos de workflow do clone
 
 ## Objetivo
-Gerar workflow files
-
-## 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
+Encadear as tasks geradas em `generate-task-files` na ordem em que a pessoa de fato executa o processo — o workflow é o que transforma uma pilha de tasks soltas num squad que opera como ela opera.
+
+## A regra que governa
+**O workflow copia a sequência documentada, não a sequência que pareceria mais organizada.** Se a pessoa pula uma etapa que um squad "ideal" teria, o workflow pula também — inventar ordem lógica por cima do que foi extraído é o mesmo erro de inventar heurística.
+
+## Passos
+
+1. **Puxe a sequência real da Layer 3.** No `cognitive-profile.md`, cada workflow já vem numerado (`1. Step 1 [TAG]`, `2. Step 2 [TAG]`...). Essa é a ordem — não a ordem que faria mais sentido para quem nunca viu a pessoa trabalhar.
+
+2. **Monte o arquivo no formato usado pelos workflows deste squad** (ver `tier3-full-clone.yaml` e `full-clone-pipeline.yaml` como referência de estrutura): `name`, `version`, `description`, `trigger`, `agents_involved`, e uma lista de `phases` com `agent`, `tasks` (nomes que existem em `tasks/`), `depends_on` quando houver dependência, `output` e `quality_gate`.
+   ⚠️ `quality_gate` não é decoração — é o critério que decide se a fase seguinte pode começar. Escreva um critério verificável ("proposta tem preço e prazo"), não um adjetivo ("proposta boa").
+
+3. **Não invente fase para preencher lacuna.** Se a extração não documentou o que acontece entre duas etapas, o workflow salta direto — com uma nota `# gap: nao documentado entre X e Y` — em vez de uma fase de transição inventada.
+
+4. **Verifique referência cruzada antes de fechar.** Toda task citada num `phases[].tasks` precisa existir em `tasks/`; todo agente citado em `agent` ou `agents_involved` precisa existir em `agents/`. É exatamente o que o `pre-deploy-checklist.md` cobra na seção Integridade, e falhar nisso aqui custa uma rodada inteira de correção depois.
+
+5. **Feche o ciclo: nenhuma task órfã.** Se uma task gerada na etapa anterior não aparece em nenhum workflow, ou ela pertence a um processo que ainda não foi modelado (escreva o workflow que falta) ou ela não devia ter sido gerada (volte para `generate-task-files`).
+
+## Formato da saída
+Um ou mais `.yaml` em `workflows/`, nomeados pelo processo que descrevem (`fechamento-de-proposta.yaml`, não `workflow-principal.yaml`). Cada um segue a estrutura de fases descrita acima.
+
+## O que não vale
+- Fases genéricas ("Phase 1: Setup", "Phase 2: Execução") que não correspondem a nenhum workflow extraído.
+- Reordenar etapas para parecer mais eficiente do que a pessoa realmente é.
+- `quality_gate` vago que não trava nada na prática.
+- Task ou agente citado que não existe nos arquivos do squad.
+
+## Fontes no squad
+`workflows/tier3-full-clone.yaml` e `workflows/full-clone-pipeline.yaml` (formato de referência), `templates/cognitive-profile-template.md` (Layer 3, ordem documentada), `checklists/pre-deploy-checklist.md` (seção Integridade), `knowledge-base/multi-agent-deployment-patterns.md` (quando o workflow do clone se conecta a orquestrações fora do squad-cloning).

package/squads/squad-cloning/tasks/identify-contradictions.md

@@ -17,30 +17,39 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Toda contradicao tem os dois lados documentados, nenhum foi descartado"
+  - "[ ] Contradicao temporal foi cruzada com a janela de decay da fonte"
+  - "[ ] Cada contradicao tem hipotese de resolucao proposta, nao so registrada"
+  - "[ ] Divergencias entre heuristica declarada e decision pattern real foram priorizadas"
+  - "[ ] Nenhuma contradicao foi resolvida por suposicao sem marcar como hipotese"
 ---
 
-# Task: identify-contradictions
-
-## Metadata
-- **Agent:** cognitive-extractor (Cortex)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Identificar contradições
 
 ## Objetivo
-Encontrar contradicoes entre fontes
-
-## 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
+Encontrar e documentar onde fontes diferentes — ou a heurística declarada e o decision pattern real — se contradizem, sem escolher um lado para descartar o outro.
+
+## A regra que governa
+**Contradição é dado, não defeito.** Documentar os dois lados vale mais do que decidir qual é "a verdade" — essa decisão é da próxima fase (mind-synthesizer resolve; esta task só levanta e propõe hipótese).
+
+## Passos
+1. **Revise as camadas já extraídas** (mental models, heurísticas, decision patterns, workflows, vocabulário) e cruze: a mesma situação recebe respostas diferentes em fontes diferentes?
+2. **Verifique contradição temporal.** A pessoa dizia X numa fonte antiga e diz Y numa recente? `source-classification.md` trata isso como possível evolução de pensamento, não como erro — aplique a janela temporal do documento (últimos 12 meses / 1-3 anos / 3-7 anos / 7+ anos) para contextualizar antes de julgar.
+3. **Documente cada contradição com:** fonte A, fonte B, o que cada uma diz, contexto (quando, onde, para quem), e uma hipótese de resolução (evolução de pensamento, contexto diferente, inconsistência real).
+   ⚠️ "Provavelmente ele quis dizer..." é invenção disfarçada de resolução. A hipótese entra marcada como hipótese, e a contradição continua na lista de não resolvidas até uma fonte nova confirmar um dos lados.
+4. **Separe resolvidas de não resolvidas** — `cognitive-profile-template.md` tem as duas seções, e ambas viram dado no relatório final, cada uma com o tratamento apropriado.
+5. **Priorize a divergência entre heurística declarada (de `extract-heuristics`) e decision pattern real (de `extract-decision-patterns`).** É a contradição mais valiosa deste squad: revela onde a pessoa não segue sua própria regra.
+
+## Formato da saída
+Duas tabelas, conforme `cognitive-profile-template.md`:
+
+**Resolvidas** — Contradição | Resolução | Confiança
+**Não Resolvidas** — Contradição | Contexto | Hipótese
+
+## O que não vale
+- Escolher a fonte "mais confiável" e descartar a outra sem registrar a que foi descartada.
+- Tratar toda contradição como erro de extração em vez de considerar evolução de pensamento.
+- Resolver uma contradição sem declarar a hipótese que sustenta a resolução.
+
+## Fontes no squad
+`knowledge-base/source-classification.md` (janelas temporais e decay), `knowledge-base/confidence-scoring.md` (confidence decay), `knowledge-base/extraction-patterns.md` (Pattern 5, red flags gerais), `templates/cognitive-profile-template.md`.