iron-edge 1.1.0 → 2.0.0

package/squads/squad-cloning/tasks/transcribe-podcast-episodes.md

@@ -17,30 +17,63 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Ferramenta de transcricao confirmada antes de iniciar"
+  - "[ ] Falas do alvo isoladas das falas de host/outros convidados (diarizacao)"
+  - "[ ] Todo trecho inaudivel marcado como [INAUDIVEL]"
+  - "[ ] Metadados de fonte, tipo (host/convidado) e base de uso registrados"
+  - "[ ] 3 trechos reconferidos contra o audio antes de marcar como pronto"
 ---
 
-# Task: transcribe-podcast-episodes
-
-## Metadata
-- **Agent:** content-capturer (Capture)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Transcrever episódios de podcast
 
 ## Objetivo
-Transcrever podcasts via Whisper
-
-## 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
+Transcrever episódios de podcast em que o alvo participa — como host ou como convidado — isolando o que é fala dele do resto do episódio, com metadados de fonte prontos para a extração cognitiva.
+
+## A regra que governa
+**Cada linha pertence a quem falou — atribuir fala errada ao alvo é pior do que não transcrever.** Podcast é áudio de múltiplas vozes sem contexto visual; o risco específico aqui não é só o trecho inaudível, é misturar a voz do host ou de outro convidado com a do alvo.
+
+## Passos
+
+1. **Confirme a ferramenta antes de prometer.** Verifique que existe um meio real de transcrever áudio (app instalado, serviço de speech-to-text configurado, ou release notes/transcript oficial do episódio). Sem isso, diga em uma linha ao dono o que não dá pra fazer — não entregue transcrição inventada.
+
+2. **Separe host de convidado.** Use o campo `type` (`host`/`guest`) do `source-catalog.yaml`. Se o alvo é convidado, isole as falas dele das do host e de outros convidados — o resto do episódio não vira dado do alvo só por estar no mesmo áudio.
+   ⚠️ Transcrever o episódio inteiro sem diarização e tratar tudo como se fosse fala do alvo é o erro mais caro desta task.
+
+3. **Diarize, mesmo que manualmente.** Marque quem fala cada trecho: `[ALVO]`, `[HOST]`, `[OUTRO]`. Se a ferramenta usada não faz diarização automática, marque pelo que for possível identificar ao ouvir e declare `diarization: manual` no cabeçalho — isso baixa a confiança do trecho e o próximo agente precisa saber disso.
+
+4. **Marque o inaudível.** Mesmo critério da transcrição de vídeo: `[INAUDIVEL]`, nunca completado por suposição.
+
+5. **Registre metadados e a base de uso.** URL/RSS do episódio, nome do podcast, tipo (host/convidado), data. Participação pública como convidado ainda é conteúdo público — mas se o episódio saiu do ar, é exclusivo de assinantes, ou veio de gravação não publicada, pare e pergunte ao dono antes de transcrever (`knowledge-base/ethical-guidelines.md`, Princípio 2).
+
+6. **Aplique o reliability score e a priorização.** 0.95 para transcrição direta (`knowledge-base/source-classification.md`); dentro disso, episódio como host de formato longo pesa mais que participação como convidado de 30-45min, que pesa mais que menção casual — hierarquia de Tier S/A/B/C/D da mesma fonte.
+
+7. **Faça o spot-check.** Reouça 3 trechos aleatórios contra o áudio original, incluindo pelo menos um trecho com troca de falante, antes de marcar como pronto.
+
+## Formato da saída
+`raw/podcast/{nome-do-episodio}.txt` com cabeçalho + transcrição diarizada:
+```
+---
+source_type: podcast
+url: https://...
+podcast_name: ...
+type: guest
+capture_date: 2026-08-22
+diarization: manual
+reliability_score: 0.95
+quality: medium
+consent_basis: public_content
+language: pt-BR
+---
+[HOST] ...
+[ALVO] ...
+[OUTRO] ...
+```
+
+## O que não vale
+- Atribuir ao alvo fala do host ou de outro convidado.
+- Transcrever o episódio sem nenhuma marcação de quem fala.
+- Processar episódio pago/exclusivo sem verificar se pode ser usado.
+- Declarar diarização manual como se fosse automática (a confiança reportada engana quem lê depois).
+
+## Fontes no squad
+`knowledge-base/source-classification.md` (reliability score, hierarquia Tier S/A/B/C/D por formato), `knowledge-base/ethical-guidelines.md` (Princípio 2), `templates/source-catalog-template.yaml` (campo `type: host|guest`).

package/squads/squad-cloning/tasks/transcribe-youtube-videos.md

@@ -17,30 +17,61 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Ferramenta de transcricao confirmada antes de iniciar (nao prometida de memoria)"
+  - "[ ] Todo trecho inaudivel marcado como [INAUDIVEL], nunca completado por suposicao"
+  - "[ ] Metadados de fonte e base de uso registrados em cada arquivo"
+  - "[ ] 3 trechos aleatorios reconferidos contra o video antes de marcar como pronto"
+  - "[ ] Video com audio ruim capturado com flag de baixa qualidade, nao descartado"
 ---
 
-# Task: transcribe-youtube-videos
-
-## Metadata
-- **Agent:** content-capturer (Capture)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Transcrever vídeos do YouTube
 
 ## Objetivo
-Transcrever videos via Whisper
-
-## 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
+Transcrever os vídeos do catálogo (canal próprio e aparições como convidado) em texto fiel, com metadados de fonte, pronto para a extração cognitiva.
+
+## A regra que governa
+**Transcrição fiel registra o que foi dito e marca o que não deu pra ouvir — nunca completa por conta própria.** Um erro aqui vira mental model falso duas fases depois, quando ninguém mais vai comparar com o vídeo original.
+
+## Passos
+
+1. **Confirme a ferramenta antes de prometer.** Verifique que existe, no ambiente de quem executa, uma forma real de transcrever áudio para texto — um app de transcrição instalado, uma chave de serviço de speech-to-text configurada, ou acesso às legendas do próprio vídeo. Se nada disso existir, diga em uma linha ao dono o que não dá pra fazer sem isso — não invente um resultado nem finja que transcreveu.
+   ⚠️ Legenda automática da plataforma vale como fonte, mas só se for revisada e marcada como tal — não como transcrição de qualidade alta por padrão.
+
+2. **Priorize pelo catálogo.** Use o `source-catalog.yaml` gerado pela fase anterior — comece pelos itens marcados `priority: must`, e dentro deles prefira conteúdo longo-form próprio a aparições e entrevistas, na ordem de prioridade de `knowledge-base/source-classification.md`.
+
+3. **Transcreva integralmente.** Não resuma, não pule trecho por parecer repetitivo — o padrão repetido é justamente o que revela heurística depois. Marque trecho que não deu pra entender com `[INAUDIVEL]` em vez de preencher com o que "provavelmente" foi dito.
+
+4. **Registre metadados e a base de uso.** Anexe ao arquivo: URL, canal, tipo (`own_channel`/`appearance`/`interview`), data de captura, e sob que base esse conteúdo está sendo usado — é vídeo publicado pelo próprio canal do alvo, ou aparição pública em canal de terceiro? Se a resposta não for óbvia (vídeo removido do ar, trecho de reunião fechada, conteúdo exclusivo de assinantes), pare e pergunte ao dono antes de transcrever — ver `knowledge-base/ethical-guidelines.md`, Princípio 2.
+
+5. **Aplique o reliability score da fonte.** Transcrição direta recebe 0.95, conforme a tabela de Scoring de Confiabilidade de `knowledge-base/source-classification.md`.
+
+6. **Separe por idioma.** Vídeo com trechos em mais de um idioma vira arquivos separados por idioma, nunca misturados no mesmo texto.
+
+7. **Faça o spot-check.** Reouça e releia pelo menos 3 trechos aleatórios contra o vídeo original antes de marcar o arquivo como pronto.
+
+## Formato da saída
+`raw/youtube/{nome-do-video}.txt` (ou `-{lang}` quando ha mais de um idioma), com um cabeçalho de metadados seguido do texto completo:
+```
+---
+source_type: youtube
+url: https://...
+channel: ...
+type: own_channel
+capture_date: 2026-08-22
+reliability_score: 0.95
+quality: high
+consent_basis: public_content
+language: pt-BR
+---
+[transcricao completa, com [INAUDIVEL] onde couber]
+```
+
+## O que não vale
+- Resumir em vez de transcrever palavra por palavra.
+- Completar trecho inaudível com o que "faz sentido" ter sido dito.
+- Prometer transcrição sem ter confirmado que a ferramenta existe.
+- Processar vídeo de origem incerta (removido, privado, pago) sem perguntar ao dono.
+- Misturar dois idiomas no mesmo arquivo.
+
+## Fontes no squad
+`knowledge-base/source-classification.md` (priorização de fontes, reliability score), `knowledge-base/ethical-guidelines.md` (Princípio 2 — consentimento e base legal), `templates/source-catalog-template.yaml` (campos de prioridade e idioma).

package/squads/squad-cloning/tasks/validate-agent-completeness.md

@@ -17,30 +17,54 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Secao Agent.md (Tier 2+) de clone-completeness-checklist.md rodada item a item"
+  - "[ ] Gates 1-4 de clone-quality-assurance.md rodados, com o Gate 4 (Etica) sem ressalva"
+  - "[ ] ethical_declaration e clone_declaration conferidas contra o que a persona registrou"
+  - "[ ] Veredito emitido: PASS / PASS COM RESSALVAS / FAIL, com os itens faltantes nomeados"
+  - "[ ] Falha no Gate 4 devolve a fase para generate-agent-persona, nunca segue com ressalva"
 ---
 
-# Task: validate-agent-completeness
-
-## Metadata
-- **Agent:** agent-forger (Forge)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Validar a completude do agente
 
 ## Objetivo
-Validar contra standards
-
-## 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
+Rodar o gate final antes do agent.md seguir para o `squad-assembler` — bate contra os mínimos do tier, contra o template estrutural e contra o gate ético, na mesma passada, e barra a entrega se qualquer um falhar.
+
+## A regra que governa
+**Falhar o Gate de Ética barra a entrega. Não existe "publica com ressalva" nele.** Os outros gates (confidence, fidelity, integridade) admitem gap documentado dentro da faixa do tier. Ética não — ou o clone se apresenta como representação com base de uso clara, ou ele não sai desta fase.
+
+## Passos
+
+1. **Rodar a checklist estrutural.** Percorra `checklists/clone-completeness-checklist.md`, seção "Agent.md (Tier 2+)", item por item: nome/persona, ID kebab-case, icon, role, core principles (5-6), heuristics com trigger/action/rationale, protocols com steps, commands, tom/saudação/assinatura, `real_person`/`source_mind`, `clone_tier`/`confidence_score`, handoffs cross-squad, formato de `templates/clone-agent-template.md`.
+
+2. **Rodar os 4 gates de qualidade.** `knowledge-base/clone-quality-assurance.md` define Gate 1 (Confidence Score contra o mínimo do tier), Gate 2 (Fidelity Score ≥70%), Gate 3 (Integridade — failure modes, nenhum `[HIPOTESE]` promovido a core principle, gaps documentados) e Gate 4 (Ética).
+
+3. **Tratar o Gate 4 como bloqueante, não como item de checklist comum.** Confira, um a um, os itens de "Checklist Ético Pré-Deploy" de `knowledge-base/ethical-guidelines.md`: disclaimer sempre visível, confidence score visível, failure modes documentados, seção "não posso ajudar com" presente, `ethical_declaration` no agent.md — e, se o clone for de uso público, também os itens da seção "Para Clones Públicos" (consentimento documentado, aviso legal, mecanismo de remoção).
+
+4. **Cruzar a declaração com o que `generate-agent-persona` de fato registrou.** Não basta o campo existir — confira se `consent_status`, `lgpd_basis` e `use_restrictions` são coerentes com o que foi apurado na task de persona e com o handoff aprovado (ou bloqueado) em `generate-cross-squad-handoffs`. Um `ethical_declaration` genérico copiado do template sem preenchimento real é a mesma falha que a task de persona foi desenhada pra evitar — aqui é onde isso é pego, se passou.
+
+5. **Aplicar a distinção entre gap aceitável e falha bloqueante.** Heurística abaixo do mínimo mas dentro da tolerância do tier, ou meta-pattern não identificado no Tier 2 (onde não é exigido) → registra como "aceitável com gaps", documentado, segue adiante. Item do Gate 4 ausente ou incoerente → não é gap, é falha. Bloqueia.
+
+6. **Emitir o veredito e, se falhar, devolver a fase certa.** PASS (tudo passou), PASS COM RESSALVAS (gates 1-3 com gap documentado dentro da faixa), ou FAIL (qualquer item do Gate 4, ou gate 1-3 abaixo do mínimo do tier). Uma falha do Gate 4 volta especificamente para `generate-agent-persona` — é lá que `ethical_declaration` nasce — com o item que faltou nomeado, não um "revisar tudo" genérico.
+
+## Formato da saída
+Relatório curto com veredito e itens verificados:
+
+```markdown
+## Veredito: PASS COM RESSALVAS
+
+Gate 1 (Confidence): PASS — 79%, acima do minimo Tier 2 (75%)
+Gate 2 (Fidelity): nao aplicavel nesta fase (roda pos-deploy)
+Gate 3 (Integridade): PASS COM GAP — 6 heuristics de 15 minimas extraidas viraram
+  heuristics do agente; gap documentado no agent.md
+Gate 4 (Etica): PASS — ethical_declaration coerente, clone_declaration visivel,
+  consent_status "public_content_only" compativel com uso "consultoria privada"
+```
+
+## O que não vale
+- Marcar o Gate 4 como passou sem checar item por item da checklist de `ethical-guidelines.md`.
+- Deixar "PASS COM RESSALVAS" cobrir uma falha ética — ressalva é só para gaps 1-3 dentro da faixa do tier.
+- Aprovar um agent.md sem `clone_declaration` visível ou com `ethical_declaration` de template não preenchido.
+- Rodar só a checklist de completude e pular os gates de `clone-quality-assurance.md`, ou vice-versa.
+
+## Fontes no squad
+`checklists/clone-completeness-checklist.md`, `knowledge-base/clone-quality-assurance.md` (4 Gates, Checklist Pré-Publicação), `knowledge-base/ethical-guidelines.md` (Checklist Ético Pré-Deploy), `knowledge-base/clone-tier-standards.md` (mínimos por tier).

package/squads/squad-cloning/tasks/validate-kb-citations.md

@@ -17,30 +17,69 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Toda afirmacao de todo KB tem tag [DIRETO]/[INFERIDO]/[HIPOTESE]"
+  - "[ ] [INFERIDO] com menos de 3 fontes foi rebaixado para [HIPOTESE]"
+  - "[ ] Score do cabecalho recalculado pela formula de confidence-scoring.md e batido"
+  - "[ ] Tabela de Fontes de cada KB lista todas as fontes citadas no corpo, com word count"
+  - "[ ] Todo KB tem a declaracao de que e representacao, nao a pessoa real"
 ---
 
-# Task: validate-kb-citations
-
-## Metadata
-- **Agent:** kb-architect (Archive)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Validar citações dos KBs
 
 ## Objetivo
-Validar citacoes e tags
-
-## 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
+Auditar, um a um, todos os KBs gerados (Framework, Pattern, Methodology, Reference) contra as regras
+de citação e o score de confiança declarado — antes de liberá-los para `cross-reference-kbs` e para
+deploy nos squads destino.
+
+## A regra que governa
+**Toda afirmação sem tag reprova.** Não existe "quase citado" ou "dá pra perceber que é confiável" —
+`checklists/extraction-quality-checklist.md` é explícito: nenhuma extração sem tag. Esta task não
+gera conteúdo, ela recusa o que não cumpre a regra e devolve para correção.
+
+## Passos
+
+1. **Leia cada KB gerado linha por linha** e marque toda afirmação — princípio, step, linha de
+   tabela, item de pattern — que não tem tag [DIRETO]/[INFERIDO]/[HIPOTESE]. Sem exceção para linhas
+   "óbvias" ou de contexto: se afirma algo sobre o pensamento da pessoa, precisa de tag.
+
+2. **Confira [DIRETO] contra citação específica.** A regra é fonte nomeada e contexto — "Livro cap.
+   4" ou "Podcast EP 156", não "fonte diversa" ou "conteúdo geral". [DIRETO] sem citação localizável
+   é [HIPOTESE] mal marcada; rebaixe.
+
+3. **Confira [INFERIDO] contra 3+ fontes de suporte** (`confidence-scoring.md`).
+   ⚠️ **[INFERIDO] com 1 fonte é [HIPOTESE] disfarçado** — a armadilha mais comum desta task. Conte
+   as fontes listadas; se são menos de 3, rebaixe a tag, não deixe passar porque "parece consistente".
+
+4. **Recalcule o confidence score de cada KB** pela fórmula de `confidence-scoring.md`:
+   `(direct × 1.0 + inferred × 0.7 + hypothesis × 0.3) / total × 100`. Compare com o score no
+   cabeçalho do KB. Se divergir, corrija o cabeçalho — a fórmula manda, não o número que já estava
+   escrito.
+
+5. **Confira a tabela de Fontes.** Toda fonte citada no corpo do KB precisa aparecer na tabela final
+   com word count; fonte que aparece só numa nem na outra é sinal de citação incompleta.
+
+6. **Confira a declaração ética.** Todo KB precisa dizer no Contexto que é uma reconstrução baseada
+   em fontes, não a pessoa real falando — Princípio 1 e 3 de `ethical-guidelines.md`. KB sem essa
+   linha reprova, independente da qualidade do conteúdo.
+
+7. **Registre cada reprovação com ação clara.** Não basta apontar o problema — diga o que resolve:
+   "corrigir citação", "rebaixar tag", "recusar publicar até nova fonte aparecer".
+
+## Formato da saída
+Relatório de validação em tabela:
+
+| KB | Afirmações sem tag | [INFERIDO] com <3 fontes | Score declarado × recalculado | Declaração ética | Status |
+|---|---|---|---|---|---|
+| `pricing-framework.md` | 0 | 2 (rebaixadas) | 82% × 76% (corrigido) | Presente | Aprovado após correção |
+
+## O que não vale
+- Aprovar um KB "no geral bem citado" sem contar afirmação por afirmação.
+- Considerar a checagem cumprida porque toda linha tem alguma tag, mesmo que a tag esteja errada.
+- Pular a comparação entre score declarado e recalculado.
+- Registrar reprovação sem dizer qual ação a corrige.
+
+## Fontes no squad
+`knowledge-base/confidence-scoring.md` (fórmula e critério de cada tag),
+`knowledge-base/kb-generation-guide.md` (regras de citação obrigatórias),
+`checklists/extraction-quality-checklist.md` (checklist de tags e honestidade),
+`knowledge-base/ethical-guidelines.md` (declaração de transparência obrigatória).

package/squads/squad-cloning/tasks/validate-transcription-quality.md

@@ -17,30 +17,46 @@ Saida:
     destino: "next phase"
 
 Checklist:
-  - "[ ] Validar inputs"
-  - "[ ] Executar steps"
-  - "[ ] Verificar qualidade"
-  - "[ ] Gerar output"
+  - "[ ] Amostra de pelo menos 10% (minimo 3) por tipo de fonte reconferida contra o original"
+  - "[ ] Taxa de erro calculada e declarada por tipo de fonte"
+  - "[ ] Arquivo acima de 15% de erro reprovado e mandado para recaptura"
+  - "[ ] Diarizacao checada na amostra (nenhuma fala de terceiro atribuida ao alvo)"
+  - "[ ] 100% dos arquivos com base de consentimento registrada, sem excecao"
 ---
 
-# Task: validate-transcription-quality
-
-## Metadata
-- **Agent:** content-capturer (Capture)
-- **Squad:** squad-cloning
-- **Complexity:** STANDARD
+# Task: Validar qualidade das transcrições
 
 ## Objetivo
-Validar qualidade das transcricoes
-
-## 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
+Checar, antes de entregar para a extração cognitiva, se as transcrições e capturas normalizadas são confiáveis — não apenas se os arquivos foram gerados.
+
+## A regra que governa
+**O gate audita amostra contra a fonte, não confere se o arquivo existe.** Reler o próprio `.txt` achando que "parece certo" não é validação — validação é voltar ao áudio, à URL ou à página do PDF original.
+
+## Passos
+
+1. **Confira o cabeçalho de cada arquivo.** Todo arquivo em `raw/` precisa ter metadados completos: fonte, data, reliability score, quality, base de consentimento. Sem isso, reprove o arquivo e devolva para `normalize-raw-content` ou para a task de captura de origem.
+
+2. **Amostre por tipo de fonte.** Escolha pelo menos 10% dos arquivos de cada tipo (vídeo, podcast, livro, artigo, social), com mínimo de 3 por tipo, e reconfira cada um contra o original — reouça o trecho de áudio, reabra a URL, reabra a página do PDF.
+
+3. **Meça a taxa de erro.** Para cada arquivo da amostra, conte erro a cada 100 palavras reconferidas (palavra trocada, trecho pulado, fala atribuída a pessoa errada). Declare a taxa no relatório, por arquivo e por tipo de fonte.
+
+4. **Aplique o limite.** Acima de 5% de erro na amostra, o arquivo fica `quality: low` e ganha a flag `[LOW-QUALITY-TRANSCRIPTION]`. Acima de 15%, reprove e mande recapturar — não empurre para a extração cognitiva.
+   ⚠️ Aceitar uma transcrição "quase boa" porque recapturar dá trabalho é a armadilha mais cara aqui — erro de transcrição vira mental model falso na fase seguinte (ver `knowledge-base/ethical-guidelines.md`, Princípio 3, Protocolo Anti-Fabricação).
+
+5. **Cheque a diarização.** Em podcast e entrevista, confirme na amostra revisada que nenhuma fala de host ou de outro convidado foi atribuída ao alvo.
+
+6. **Cheque consentimento em 100% dos arquivos.** Este item não é amostragem — é checagem total, porque é o campo que decide se aquele material pode virar clone público depois. Arquivo sem base de consentimento registrada não passa, mesmo com transcrição perfeita.
+
+7. **Feche com veredito por fonte.** Aprovado / aprovado com ressalva (quality low, documentado) / reprovado (recapturar).
+
+## Formato da saída
+`raw/validation-report.md` com: total de arquivos, tamanho da amostra revisada, taxa de erro por tipo de fonte, lista de arquivos reprovados com o motivo, e confirmação de que 100% dos arquivos tem consentimento registrado.
+
+## O que não vale
+- Validar só checando se o arquivo existe e não está vazio.
+- Pular a amostragem por já "confiar" na ferramenta de captura.
+- Aprovar arquivo sem base de consentimento registrada.
+- Aprovar arquivo com taxa de erro alta só para não atrasar o pipeline.
+
+## Fontes no squad
+`knowledge-base/ethical-guidelines.md` (Princípio 3 — Protocolo Anti-Fabricação), `knowledge-base/source-classification.md` (reliability score de referência por tipo de fonte), `checklists/extraction-quality-checklist.md` (padrão de honestidade que a fase seguinte vai exigir dos dados que saem daqui).

package/squads/squad-cloning/workflows/full-clone-pipeline.yaml

@@ -13,8 +13,24 @@ agents_involved:
   - squad-assembler
 
 phases:
+  - name: "Phase 0: Gate etico (BLOQUEANTE)"
+    agent: cloning-orqx
+    tasks:
+      - initiate-clone-project
+    bloqueante: true
+    output: "ethical_declaration"
+    quality_gate: "consentimento, uso pretendido e base legal respondidos e registrados"
+    descricao: >
+      Antes de QUALQUER coleta: quem e' a pessoa, ela autorizou, para que o clone
+      sera usado, e qual a base legal e a jurisdicao. Sem as respostas, o pipeline
+      para e pergunta ao dono. Ver knowledge-base/ethical-guidelines.md.
+      Nenhuma fase seguinte roda sem ethical_declaration registrada.
   - name: "Phase 1: Source Discovery"
     agent: source-hunter
+    # ⛔ A fase que COMECA a coletar sobre a pessoa e' a que mais precisa depender do
+    # gate. Ate 24/08 era a unica do arquivo sem depends_on: o gate existia como
+    # prosa e nao como aresta, entao o pipeline podia entrar por aqui direto.
+    depends_on: ["Phase 0: Gate etico (BLOQUEANTE)"]
     tasks:
       - discover-youtube-channels
       - discover-podcasts-appearances
@@ -80,7 +96,7 @@ phases:
       - generate-cross-squad-handoffs
       - validate-agent-completeness
     output: "agent.md"
-    quality_gate: "Agent.md segue SQUAD-CREATION-STANDARDS, todos campos obrigatorios"
+    quality_gate: "Agent.md segue `templates/clone-agent-template.md`, todos campos obrigatorios"
 
   - name: "Phase 6: KB Generation"
     agent: kb-architect

package/squads/squad-cloning/workflows/tier2-consultant.yaml

@@ -75,7 +75,7 @@ phases:
       - generate-agent-commands
       - validate-agent-completeness
     output: "agent.md"
-    quality_gate: "SQUAD-CREATION-STANDARDS compliance"
+    quality_gate: "conformidade com templates/clone-agent-template.md"
 
   - name: "Phase 6: KB Generation"
     agent: kb-architect

package/squads/squad-commercial/README.md

@@ -2,6 +2,12 @@
 
 > Squad de Commercial Systems — orquestra CRM, pipeline, funnel architecture, offer design, revenue operations, client success e sales enablement para maximizar receita previsivel e retencao de clientes.
 
+<!-- gen:start -->
+| camada | agentes | tasks | KBs | workflows | templates | checklists |
+|---|---|---|---|---|---|---|
+| iron 7 · xq 4 | 11 | 85 | 23 | 6 | 6 | 3 |
+<!-- gen:end -->
+
 ## Visao Geral
 
 | Metrica | Quantidade |
@@ -25,7 +31,16 @@
 
 ## Ativacao
 
-```bash
+Você entra por aqui, pedindo em português ao Claude Code:
+
+```
+"usa o iron-commercial"
+```
+
+Os nomes com `@` abaixo são **papéis internos** deste squad — quem os aciona é o
+orquestrador, não você. Não são comandos de barra nem menções que você digita.
+
+```
 # Via orquestrador (recomendado)
 @commercial-orqx
 
@@ -79,11 +94,8 @@
 
 ## Integracao com Core Agents
 
-Este squad trabalha com o framework SINAPSE core:
-- @architect (Aria) para decisoes tecnicas
-- @developer (Dex) para implementacao
-- @quality-gate (Quinn) para validacao de qualidade
+Este squad é orquestrado pelo `iron-ceo`, que abre o orquestrador do squad em `~/.iron/<squad>/agents/<squad>-orqx.md`.
 
 ---
 
-*Parte do ecossistema SINAPSE-AI — 18 squads, 186 agentes*
+Parte do ecossistema Iron Edge

package/squads/squad-commercial/agents/commercial-orqx.md

@@ -1,3 +1,12 @@
+---
+id: commercial-orqx
+layer: iron
+role: orchestrator
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: opus
+---
+
 # Agent: Pipeline — Revenue Cycle Orchestrator
 
 ## Identity
@@ -52,7 +61,7 @@ Revenue Cycle Orchestrator — coordena o sistema comercial completo, desde dema
 
 | Workflow | Description | Agents Involved |
 |----------|-------------|-----------------|
-| `greenfield-commercial-system` | Build commercial system from scratch | All 11 agents |
+| `greenfield-commercial-system` | Build commercial system from scratch | All the squad agents |
 | `pipeline-optimization` | Optimize existing pipeline metrics | Vault, Cascade, Ledger |
 | `deal-acceleration` | Accelerate specific deals through pipeline | Edge, Mint, Bond |
 | `quarterly-review` | Full commercial performance review | Pipeline + all agents |
@@ -85,4 +94,4 @@ Revenue Cycle Orchestrator — coordena o sistema comercial completo, desde dema
 - **@product-orqx:** Client feedback, feature requests, adoption data
 - **@finance-orqx:** Revenue data, forecasts, pricing validation
 - **@growth-orqx:** Conversion data, campaign attribution
-- **@sinapse-orqx:** Cross-squad coordination, escalations
+- **@iron-ceo:** Cross-squad coordination, escalations

package/squads/squad-commercial/agents/cs-business-auditor.md

@@ -1,3 +1,12 @@
+---
+id: cs-business-auditor
+layer: xq
+role: master
+orchestrated_by: legal-chief
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Audit — Business Health & Opportunity Auditor
 
 ## Identity
@@ -86,6 +95,6 @@ The system is only as strong as its weakest link.
 3. run-competitive-positioning-audit
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @research-intelligence (market data, competitive analysis), @growth-analytics (performance data)
-- **Envia para:** @commercial-systems agents (specific pillar improvements), @product-systems (product-market fit insights)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @research-orqx (market data, competitive analysis), @growth-orqx (performance data)
+- **Envia para:** @commercial-orqx agents (specific pillar improvements), @product-orqx (product-market fit insights)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-client-success.md

@@ -1,3 +1,12 @@
+---
+id: cs-client-success
+layer: iron
+role: specialist
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Bond — Client Success & Retention Strategist
 
 ## Identity
@@ -128,6 +137,6 @@ Self-Orientation is the denominator — most powerful variable
 14. manage-client-offboarding
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @digital-experience (product health metrics), @product-systems (feature usage)
-- **Envia para:** @content-intelligence (case study raw data), @research-intelligence (client feedback)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @design-orqx (product health metrics), @product-orqx (feature usage)
+- **Envia para:** @content-orqx (case study raw data), @research-orqx (client feedback)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-crm-specialist.md

@@ -1,3 +1,12 @@
+---
+id: cs-crm-specialist
+layer: iron
+role: specialist
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Vault — CRM & Pipeline Operations Specialist
 
 ## Identity
@@ -50,6 +59,6 @@ CRM & Pipeline Operations Specialist — dono da single source of truth comercia
 10. monitor-pipeline-health
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @growth-analytics (lead data, attribution), @digital-experience (form submissions)
-- **Envia para:** @growth-analytics (pipeline metrics), @operations-hub (CRM requirements)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @growth-orqx (lead data, attribution), @design-orqx (form submissions)
+- **Envia para:** @growth-orqx (pipeline metrics), @eng-orqx (CRM requirements)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-funnel-architect.md

@@ -1,3 +1,12 @@
+---
+id: cs-funnel-architect
+layer: iron
+role: specialist
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Cascade — Funnel Architecture & Demand Generation
 
 ## Identity
@@ -69,6 +78,6 @@ Example: $1M / ($50K × 25% × 65% × 14%) = 1,757 MQLs
 10. map-content-to-funnel
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @growth-analytics (attribution data, channel performance), @content-intelligence (funnel content)
-- **Envia para:** @content-intelligence (content briefs por stage), @copywriting-persuasion (landing page copy briefs)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @growth-orqx (attribution data, channel performance), @content-orqx (funnel content)
+- **Envia para:** @content-orqx (content briefs por stage), @squad-copy (landing page copy briefs)
+- **Escalates to:** @iron-ceo (cross-squad coordination)