iron-edge 1.2.0 → 2.0.0

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)

package/squads/squad-commercial/agents/cs-lead-generation-strategist.md

@@ -1,3 +1,12 @@
+---
+id: cs-lead-generation-strategist
+layer: xq
+role: master
+orchestrated_by: legal-chief
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Magnet — Lead Generation & Acquisition Strategist
 
 ## Identity
@@ -110,6 +119,6 @@ OUTBOUND ENGINE:
 3. run-dream-100-campaign
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @content-intelligence (content assets), @growth-analytics (channel data, SEO keywords), @research-intelligence (ICP research)
-- **Envia para:** @copywriting-persuasion (outreach copy), @digital-experience (landing pages), @growth-analytics (campaign tracking)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @content-orqx (content assets), @growth-orqx (channel data, SEO keywords), @research-orqx (ICP research)
+- **Envia para:** @squad-copy (outreach copy), @design-orqx (landing pages), @growth-orqx (campaign tracking)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-offer-designer.md

@@ -1,3 +1,12 @@
+---
+id: cs-offer-designer
+layer: iron
+role: specialist
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Mint — Offer Architect & Pricing Strategist
 
 ## Identity
@@ -111,6 +120,6 @@ Psychology: B looks most reasonable; C makes B feel affordable
 13. model-retention-pricing
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @research-intelligence (market research, competitor analysis), @brand-system (messaging framework)
-- **Envia para:** @copywriting-persuasion (proposal copy briefs), @digital-experience (landing page specs)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @research-orqx (market research, competitor analysis), @brand-orqx (messaging framework)
+- **Envia para:** @squad-copy (proposal copy briefs), @design-orqx (landing page specs)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-revops-analyst.md

@@ -1,3 +1,12 @@
+---
+id: cs-revops-analyst
+layer: iron
+role: specialist
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Ledger — Revenue Operations & Analytics Lead
 
 ## Identity
@@ -86,6 +95,6 @@ Pipeline Coverage = Total Pipeline / Quota  [Target: 3-5x]
 10. create-revenue-dashboard
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @growth-analytics (analytics data, attribution models), @operations-hub (financial data)
-- **Envia para:** @growth-analytics (revenue metrics for dashboards), @operations-hub (tech stack requirements)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @growth-orqx (analytics data, attribution models), @eng-orqx (financial data)
+- **Envia para:** @growth-orqx (revenue metrics for dashboards), @eng-orqx (tech stack requirements)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-sales-closer.md

@@ -1,3 +1,12 @@
+---
+id: cs-sales-closer
+layer: xq
+role: master
+orchestrated_by: legal-chief
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Close — Sales Process & Closing Specialist
 
 ## Identity
@@ -122,6 +131,6 @@ NO-ORIENTED QUESTIONS — Get a "no" to feel safe
 3. design-sales-process
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @commercial-systems/Magnet (qualified leads), @copywriting-persuasion (proposal copy), @research-intelligence (prospect research)
-- **Envia para:** @commercial-systems/Bond (closed clients for onboarding), @commercial-systems/Vault (deal data)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @commercial-orqx/Magnet (qualified leads), @squad-copy (proposal copy), @research-orqx (prospect research)
+- **Envia para:** @commercial-orqx/Bond (closed clients for onboarding), @commercial-orqx/Vault (deal data)
+- **Escalates to:** @iron-ceo (cross-squad coordination)

package/squads/squad-commercial/agents/cs-sales-enablement.md

@@ -1,3 +1,12 @@
+---
+id: cs-sales-enablement
+layer: iron
+role: specialist
+orchestrated_by: commercial-orqx
+squad: squad-commercial
+model: sonnet
+---
+
 # Agent: Edge — Sales Methodology & Enablement Coach
 
 ## Identity
@@ -108,6 +117,6 @@ Insight: Challengers outperform all other profiles in complex B2B
 11. build-sales-intelligence-brief
 
 ## Cross-Squad Handoffs
-- **Recebe de:** @copywriting-persuasion (scripts, messaging), @research-intelligence (competitor intelligence)
-- **Envia para:** @content-intelligence (enablement content needs), @brand-system (messaging alignment)
-- **Escalates to:** @sinapse-orqx (cross-squad coordination)
+- **Recebe de:** @squad-copy (scripts, messaging), @research-orqx (competitor intelligence)
+- **Envia para:** @content-orqx (enablement content needs), @brand-orqx (messaging alignment)
+- **Escalates to:** @iron-ceo (cross-squad coordination)