@daniellins/power-claude 0.16.3

package/template/pods/squad-forge/tasks/pipeline.md

@@ -0,0 +1,158 @@
+# Pipeline de criação — squad-forge
+
+Transforma "quero um agente/pod de X" em artefato registrado. Cada fase tem inputs, outputs e um gate; fase seguinte só abre com o gate anterior fechado. Executor default entre parênteses.
+
+## Fase 1 — Discovery (forge-chief)
+
+**Input:** pedido em linguagem natural ("quero um agente de X").
+**Processo:** entrevista curta — job-to-be-done em uma frase; comandos necessários (nome + o que entrega); conhecimento consumido (já existe em `knowledge/`? precisa de DNA? precisa ser criado?); onde vive (aplicar a árvore comando vs agente vs pod de `pods/squad-forge/README.md`); **se clona um especialista, perguntar a forma** — persona completa (voice DNA, custo maior por ativação, trade-off informado) ou só metodologias (otimizado, default); **se é pod de CONTEÚDO (produz peça assinada por alguém), perguntar TAMBÉM a escada de voz do DONO** (ADR-013, eixo SEPARADO da pergunta de especialista — voz de QUEM assina, não de quem se clona): **sem voz** (nenhuma checagem) / **guia de estilo** (default leve: bloco `voz:` estruturado em `knowledge/dono.yaml` — `pessoa`/`lexico_proibido`/`tom` — + veto léxico `lexical-check.cjs` no workflow + cláusula de voz no checkpoint final; referência: `content-carousel`) / **DNA completo do dono** (mind-extractor, Fase 2 — mesmo caminho de DNA já existente, custo informado).
+**Output:** brief de escopo (job, comandos, mapa de conhecimento, destino proposto, forma do clone se aplicável, degrau de voz do dono se pod de conteúdo).
+
+### Gate de proporcionalidade (ADR-004 — decide o aparato da Fase 3)
+
+Antes de gerar, classifique o pedido em **SIMPLE** ou **STANDARD/COMPLEX** com `node scripts/forge-assess-tier.cjs <spec.json>` — reprodução determinística do veredito `*assess` 5D por limiares estruturais (constante `SCOPE_THRESHOLDS`, ADR-004; este repo não embute o `pc-architect`, então os limiares SÃO a régua auditável). Gatilhos: **SIMPLE** = ≤2 agentes E ≤1 workflow E ≤1 handoff cross-agente E sem DNA/persona E entregável não crítico; **qualquer** gatilho oposto (≥3 agentes / ≥2 workflows / ≥2 handoffs / DNA / crítico) → **STANDARD/COMPLEX**. O tier decide o aparato gerado (Fase 3) — não infle pod trivial.
+
+### G1 — Escopo definido
+- [ ] Job-to-be-done em uma frase, sem "e também".
+- [ ] Lista de comandos com entregável de cada um.
+- [ ] Conhecimento mapeado: cada comando aponta para fonte existente ou a criar.
+- [ ] Destino proposto justificado pela árvore de granularidade.
+- [ ] **Tier classificado** (SIMPLE / STANDARD/COMPLEX) pelo gate de proporcionalidade, com os gatilhos registrados.
+- [ ] Clone de especialista: forma escolhida pelo usuário (persona / só metodologias) com o custo informado — ou "não é clone" explícito.
+- [ ] Pod de conteúdo: degrau de voz do DONO escolhido (sem voz / guia de estilo / DNA do dono) com o custo informado — ou "não é pod de conteúdo" explícito. Eixo separado do item anterior (ADR-013): as duas respostas coexistem.
+- [ ] **Ritmo de checkpoint** (SF12.4a/ADR-030 Bloco A, campo `ritmo`): algum gate pode ser pulado em modo autônomo, ou nenhum é pulável? Declare com `{ step, skip_modes }` — ou `nao_se_aplica` explícito, com razão.
+- [ ] **Contrato de entrada** (SF12.4a/ADR-030 Bloco A, campo `contrato_entrada`): a etapa inicial recebe mais de uma forma de entrada válida, ou só uma? Declare com `{ step, valores }` (≥2 valores) — ou `nao_se_aplica` explícito, com razão.
+- [ ] **Entregável** (SF12.4a/ADR-030 Bloco A, campo `entregavel`): alguma etapa produz artefato binário/arquivo que precisa existir em disco, ou todas produzem só texto? Declare com `{ step }` — ou `nao_se_aplica` explícito, com razão.
+- [ ] **Credencial** (`ADR-034` `DF-REPUB-5`, Emenda 1): algum agente deste pod precisa **obter e usar uma credencial própria** para trabalhar (chave de API, token), ou nenhum? Se sim, o knowledge da etapa **nomeia a origem única** e **proíbe origem alternativa** — forma de referência em `template/pods/content-carousel/knowledge/image-generation.md` §"Credencial da OpenRouter". Se não, `nao_se_aplica` explícito, **com razão** (por que nenhum agente precisa de credencial própria).
+
+## Fase 2 — Research/DNA (mind-extractor; opcional)
+
+Executa somente se o brief exige voz ou mente específica.
+
+**Input:** brief + corpus (arquivos locais ou fontes públicas citadas).
+**Processo:** `mind-extractor *extract` → YAML de DNA com `evidence:` por arquivo-fonte; `*validate` com 3 amostras comparadas ao corpus.
+**Output:** `knowledge/voice-dna/{slug}-dna.yaml` validado. Default sem corpus próprio: usar a mente de referência do usuário em `knowledge/voice-dna/`.
+**Sem gate próprio** — a qualidade do DNA é cobrada em G4 (red-team).
+
+## Fase 3 — Geração (forge-chief)
+
+**Input:** brief (G1) + tier (gate de proporcionalidade) + DNA/conhecimento (Fase 2, se houver).
+**Ordem obrigatória (SF12.4a/ADR-030 Bloco D, AC13b):** o `knowledge` declarado na spec é autorado ANTES de invocar `forge-generate.cjs`; o gerador confere existência, não cria. Se a resposta do G1 (Mapa de Conhecimento) apontar para um arquivo `knowledge/*.md` "a criar", escreva-o agora — a declaração no `pod-spec.json` só passa na checagem de existência (AC13) se o arquivo já estiver em disco no momento da geração.
+**Processo:** gerar os agentes (sempre) e, proporcional ao tier, o aparato de processo:
+- **Agentes / comando / pod / clone:** como antes — entry point ≤150 linhas, frontmatter `name/description/model/budget_tokens`, 3 blocos (Papel, Comandos, Regras de ouro); knowledge files separados; stub de command (≤15 linhas, `description` com "Use para:"). Clone: persona → carrega/encarna `knowledge/voice-dna/{slug}-dna.yaml` sob demanda; só metodologias → sem roleplay; sempre com fonte citada.
+- **Aparato de processo (disco-first, M2) — via `node scripts/forge-generate.cjs <spec.json> --out <podDir>`:**
+  - **SIMPLE:** no máximo 1 workflow mínimo (ou nenhum, se comando/agente único) + templates só das 1–2 saídas. **Sem** `squad-io.yaml`, **sem** veto-engine obrigatório, **sem** memória.
+  - **STANDARD/COMPLEX:** `workflows/wf-<id>.yaml` (DAG+checkpoints+veto de máquina, no schema da SF1.1, a partir de `templates/workflow-tmpl.yaml`) + 1 `templates/<etapa>-tmpl.md` por etapa + `squad-io.yaml` (contrato de handoff) + scaffold de memória (`memory/learnings.jsonl` vazio + `learnings.consolidated.md` só cabeçalho — **sem lifecycle**; consolidação/promoção/tier CRITICAL são G1/Fase 2).
+  - Todo artefato é gravado em disco ANTES de qualquer outra ação — nenhuma dependência de vault/rede na geração.
+**Output:** arquivos criados, ainda não registrados.
+
+### G2 — Padrão estrutural
+- [ ] `node scripts/validate-budgets.js` passa (budget declarado, dentro do próprio limite e do teto global de 1.500).
+- [ ] Entry point ≤150 linhas.
+- [ ] Corpo com exatamente os 3 blocos, na ordem: Papel → Comandos → Regras de ouro.
+- [ ] Zero conhecimento profundo no entry point (vive em `knowledge/` ou `pods/<pod>/`).
+- [ ] **Aparato proporcional ao tier:** SIMPLE sem `squad-io`/memória; STANDARD/COMPLEX com `wf-*.yaml` + template/etapa + `squad-io.yaml` + scaffold de memória.
+- [ ] **STANDARD/COMPLEX:** `node scripts/validate-pod-workflow.cjs <wf>` sai 0 sobre o `wf-*.yaml` gerado, sem ajuste manual.
+- [ ] **`Fonte:` prospectivo (SF12.4a/ADR-030 Bloco N, DF-SF12.4-9):** se `knowledge/` do pod não está vazio, `node scripts/validate-no-clone.cjs <podDir>/knowledge --knowledge <podDir>/knowledge` sai 0 antes de avançar à Fase 4 — gate sobre o que o `forge-chief` escreveu (o forge NÃO gera arquivos de `knowledge/*.md`; quem os escreve é o `forge-chief` em prosa, Fase 3).
+
+## Fase 4 — Gates (forge-chief + pod-critic)
+
+**Input:** artefatos da Fase 3.
+**Processo:** smoke test conduzido pelo forge-chief; red-team pelo pod-critic.
+**Output:** relatório PASS/FAIL por gate + correções aplicadas (loop até fechar; se não fechar em 3 iterações, escalar ao usuário).
+
+### G3 — Smoke test
+- [ ] Ativar o agente e invocar CADA comando declarado com um caso mínimo.
+- [ ] O agente responde ao comando sem pedir arquivo inexistente (todo destino `→ arquivo` existe no disco).
+- [ ] A resposta corresponde ao entregável prometido no brief.
+
+### G4 — Red-team (pod-critic)
+- [ ] `pod-critic *review` executado com verificação independente.
+- [ ] Sobreposição com pods/commands existentes descartada ou fronteira documentada.
+- [ ] Clone: forma escolhida pelo usuário com custo informado; metodologias com fonte citada (sem persona fingindo conselho novo da pessoa real).
+- [ ] **Gate G6 estendido (só STANDARD/COMPLEX):** workflow seguível (smoke 4/4, não só presença) · templates presentes e casando com os `outputs` · handoffs (`squad-io.yaml`) fechados sem órfãos · reconciliação feita e dentro do bound (se `*upgrade-pod`). O `pod-critic` roda ele mesmo o validador/smoke — não lê o relato do forge.
+- [ ] Veredito **APROVADO explícito** por escrito. REPROVADO → volta à Fase 3 com a lista de correções.
+
+## `*upgrade-pod {pod}` — formalização v0.3 de um pod EXISTENTE (upgrade-in-place)
+
+Formaliza um pod já construído SEM regenerar do zero, preservando os agentes validados (SPEC §G4). Motor: `node scripts/forge-upgrade-pod.cjs <podDir> [--critical] [--dna] [--handoffs N] [--apply]`.
+
+1. **`*assess` de tier** sobre o pod existente (conta agentes/workflows + flags declaradas) → SIMPLE ou STANDARD/COMPLEX.
+2. **Gera os artefatos AUSENTES** proporcionais ao tier (workflows/templates/handoffs/scaffold de memória) — o motor só escreve em `workflows/ templates/ squad-io.yaml memory/`, **nunca** em `agents/`.
+3. **Reconciliação workflow-aware BOUNDED** sobre cada agente preservado — APENAS: (i) remover auto-sequenciamento/auto-chamada a outro agente (o runner orquestra); (ii) escopar o output do agente ao artefato da etapa (nota workflow-aware). Qualquer ajuste que exija reescrever papel/comandos/responsabilidades **excede o bound** → o comando reporta e recomenda **`*new`** para aquele agente, **sem forçar** a reconciliação.
+4. **Validador estático** — `node scripts/validate-pod-workflow.cjs` sobre o `wf-*.yaml` gerado (exit 0).
+5. **Smoke dinâmico** (SF1.3) 4/4 sobre o workflow gerado (quando disponível).
+6. **`pod-critic *review`** — gate G6 estendido (verificação independente, reprova por default).
+7. **Registro.** Se qualquer passo 4-6 falhar de um jeito que a reconciliação bounded não resolve, o comando recomenda `*new` — nunca força "preservar" além do bound.
+
+## Fase 5 — Registro (forge-chief)
+
+**Input:** artefatos aprovados em G4.
+**Processo:** `*register` — criar o stub de command definitivo em `.claude/commands/power/`; atualizar `pods/README.md` (linha na tabela de pods, se pod novo) e o README do pod dono (tabela de agentes, se agente novo).
+**Output:** artefato descobrível e registrado. Sem commit — commit é decisão do usuário.
+
+### G5 — Registro
+- [ ] Stub de command criado (≤15 linhas, aponta para o entry point, `description` com "Use para:").
+- [ ] Linha adicionada/atualizada em `pods/README.md` (ou no README do pod dono).
+- [ ] `validate-budgets.js` re-executado após tudo — ainda verde.
+
+## Resumo dos gates
+
+| Gate | O que trava | Quem fecha |
+|---|---|---|
+| G1 | Escopo: job + comandos + conhecimento + destino | forge-chief |
+| G2 | Padrão estrutural: budgets, ≤150 linhas, 3 blocos | validate-budgets.js |
+| G3 | Smoke test: comandos respondem, destinos existem | forge-chief |
+| G4 | Red-team: aprovação explícita | pod-critic |
+| G5 | Registro: stub + README atualizados | forge-chief |
+
+## `*migrate-squad {squad}` — migração direta squad legado → pod v0.3 (F0-F3)
+
+Fase PRÓPRIA do `*migrate-squad` (não sobrescreve a Fase 5 do `*register`). **Princípio:** migrar é ENCADEAR o que existe (`migration-manifest.cjs`, `forge-generate --additive`, `validate-pod-workflow`, `smoke --sweep`, `pod-critic`, `harness-g5-lite`), não construir uma segunda fábrica. O agente **nunca edita o manifest** — só invoca subcomandos do escritor único.
+
+### F0 — Inventário determinístico (fecha G5 do design; AC1)
+`node scripts/migration-manifest.cjs init docs/migration/MIGRATION-<squad>.yaml --squad <squad> --squad-dir <squadDir>` — scan RECURSIVO do squad INTEIRO (readdir recursivo, não lista fixa): classifica cada arquivo numa família (`workflows`, `agents`, `tasks`, `checklists`, `data`, `scripts`, `templates`, `sops`, `config`, `loose`) e grep dos comandos embutidos (`*[a-z-]+`) de cada agente legado (B.5 — cada comando legado precisa de endereço). O inventário é DADO do manifest, escrito pelo helper.
+
+### F1 — Triagem com gate humano (regra 5 do ledger; AC2/AC4) — **PARA no Daniel**
+`triage-set --workflow <id> --disposition {migrate|dispense|command|knowledge} --purpose "<citação path:linha>" --overlap "<path concorrente>" --basis {dado|julgamento}` para CADA workflow E CADA balde (órfãs, `data/`, e — atenção — os validadores de `scripts/`: disposição EXPLÍCITA entre veto assertion / script do pod / óbito justificado, **nunca prosa**). Sem as colunas de evidência o helper recusa. Depois `triage-approve --workflow <id> --approved-by <daniel>`: num manifest de migração real, **`open-line` recusa (exit 2) sem essa aprovação** — a parada é estrutural, não intenção.
+
+### F2 — Loop por workflow aprovado (ordem de valor; re-assess de tier agregado no início)
+- **F2a autoria** — `specs/wf-<id>.spec.json` AUTORADA (ADR-005; **nunca parse automático do YAML legado** — o legado é evidência citada em `_sources`); `veto_conditions` machine-redutíveis → `veto.assertions` com `_sources`; condições aritméticas/julgáveis (LTV:CAC≥3) → `checkpoint.blocking` (NUNCA veto — fronteira ADR-002). Tarefa-canário + `wf-<id>.smoke.json` autorados na MESMA etapa. `open-line --spec ... --pod-dir ... --owns ...`.
+- **F2b/c geração + destilação** — `node scripts/forge-generate.cjs <spec> --out <podDir> --additive` (tier agregado do disco via `forge-assess-tier --pod-dir`); destilação de delta (tasks/checklists/`data/` → knowledge com fonte, dedup). `advance --to generated`/`distilled`.
+- **F2d lint regra 3** — `node scripts/validate-no-clone.cjs <podArtefatos> --squad-source <squadDir> [--knowledge <dir>]` (classe token-detectável: identidade, persona com token, knowledge sem `Fonte:`) + `validate-budgets.js`. `advance --to linted`.
+- **F2e gates** — `advance --to gates` dispara o hook `pre-gates-check` (decide LITE vs FULL por feature-diff/`motor_hash` ANTES de pagar runs); então `validate-pod-workflow` → `smoke --sweep` → `pod-critic *review` (G6, incl. **dimensão anti-persona** para o residual que o lint não pega) → `harness-g5-lite` (ou FULL).
+- **F2f fechamento da linha** — `close-line` re-executa estático+sweep, confere `run_ids`/`pair` com binding. **Learnings da migração são candidatos no relatório — NUNCA ingeridos automaticamente** na memória do pod destino (a ingestão é `*ingest-memory`, manual/opt-in; Decisão F).
+
+### F3 — Fechamento do squad (AC8)
+`verify` (re-aplica por código os checks a TODAS as linhas fechadas) + `coverage --squad-dir <squadDir>` (diff squad×manifest = vazio) ⇒ tabela capacidade→endereço ⇒ **proposta de aposentadoria ao Daniel**. O comando **nunca deleta** o squad: a remoção (`git rm`) é autoridade exclusiva do `pc-devops`, sob aprovação humana.
+
+### Disposição VIRAR-COMANDO (fecha G6-comando; AC9)
+Linha de disposição `command` fica `pendente-comando` e SÓ fecha com os TRÊS, conferidos por `command-close --command-path ... --smoke ... --approved-by ...`: (a) comando em disco; (b) smoke próprio registrado (output conferível, não-vazio); (c) aprovação do Daniel. Sem os três, a única saída é reclassificar como `dispensar` (`triage-set --disposition dispense`).
+
+## `*harden-learning` — promover heurística de memória a ENFORCEMENT (SF7.6/ADR-012)
+
+Memória evolutiva é SUGESTÃO, não enforcement (caso real: travessões regrediram apesar de consolidados). Este comando promove UMA heurística do `learnings.consolidated.md` (top-N) a `veto.assertion` física do workflow — bloqueio do runner, não prosa injetada. Motor determinístico (o forge-chief só invoca; nunca faz o trabalho em prosa):
+
+```
+node scripts/forge-harden-learning.cjs <podDir> \
+  --learning <id> --step <stepId> --assertion '<json>' --approved-by <nome> [--workflow <id>]
+```
+
+1. **Tradução heurística→forma é JULGAMENTO HUMANO** — o dono/dev propõe a `--assertion` (forma existente `count_gte`/`field_matches`/... quando a regra mapeia; `command_check` blessed da SF7.2 quando exige inspeção que os vetos textuais não alcançam — ex.: `lexical-check.cjs` para travessões). NUNCA derivada de prosa por LLM.
+2. **Aprovação obrigatória** — sem `--approved-by`, recusa exit 2 e NADA é aplicado (padrão `migration-manifest.cjs`).
+3. **Regeneração preservando o resto** — edita `pod-spec.json` (fonte da verdade, ADR-005) e reemite SÓ o workflow-alvo via `forge-generate --additive` + owns; `agents/` nunca é tocado. Prova: estático + smoke 4/4 ANTES/DEPOIS e diff confinado à etapa-alvo — qualquer desvio ⇒ ROLLBACK automático.
+4. **Marcação append-only** — registro `{type:"hardening", ref, target, approved_by, timestamp}` no `learnings.jsonl`; o consolidado anota `🔒 endurecida → veto <tipo> em <step>` e DEMOVE a heurística do top-N ativo (enforcement substitui injeção; orçamento de injeção é finito). NUNCA removida do log — auditável (quem, quando, qual asserção).
+
+Use para: fechar o degrau aprender→impor quando uma heurística consolidada é ignorada sob pressão; converter feedback recorrente em check binário do runner.
+
+### 2º alvo: `--target-type knowledge` (SF10.10/ADR-012 Adendo)
+
+Heurística de CONTEÚDO (prosa) não tem forma de veto — vira **knowledge canônico** do pod, que é o insumo que o export recebe cru:
+
+```
+node scripts/forge-harden-learning.cjs <podDir> --target-type knowledge \
+  --learning <id> --file <arquivo.md> --content <conteudo-novo.md> --approved-by <nome>
+node scripts/forge-harden-learning.cjs <podDir> --list-candidates   # read-only, exit 0 sempre
+```
+
+A REDAÇÃO é do dono (`--content`), nunca derivada por LLM. O motor só EDITA knowledge já declarado no `knowledge:` do wf (criar é fora de escopo) e prova **preservação**: baseline antes, escrita CONFINADA a `knowledge/<file>` + os 2 arquivos de memória, `validate-no-clone` verde, paridade de `per_file_sha` via `pod-export-compile` (ou `export_check:"n/a"` declarado), e recusa se estourar o budget do consolidado — qualquer desvio ⇒ ROLLBACK. **Não há smoke "depois"** (nenhum caminho de runtime lê `knowledge/*.md`: seria verde por construção) e **não há prova de máquina de que a prosa ficou melhor** — o único portão de qualidade é `--approved-by`. `--list-candidates` é disciplina de PRÉ-RELEASE (nunca gate). Detalhes: `docs/mecanismos/harden-learning.md`.

package/template/pods/squad-forge/templates/discovery-tmpl.md

@@ -0,0 +1,40 @@
+# Template de saída — etapa `discovery` (agente `forge-chief`, artefato `scope-brief`)
+
+> Gerado por forge-generate.cjs (SF1.4 + ADR-005). Preencher com o artefato real da etapa.
+> FORMA (seções `##`) verificada por checkTemplateConformance; VETO ORTOGONAL via o
+> campo de máquina `confianca` abaixo (fora dos headings — ADR-005 Decisão A).
+
+## Job-to-be-done
+<!-- preencher: conteúdo de "Job-to-be-done" -->
+
+## Comandos
+<!-- count_gte "Comandos": conte itens de lista sob este heading — bullets (`- `/`* `), linhas numeradas (`1.` `2.` ...) OU linhas de tabela (`| ... |`, o separador `|---|---|` NÃO conta). Prosa corrida NÃO conta. -->
+<!-- preencher: conteúdo de "Comandos" -->
+
+## Mapa de Conhecimento
+<!-- preencher: conteúdo de "Mapa de Conhecimento" -->
+
+## Destino
+<!-- preencher: conteúdo de "Destino" -->
+
+<!-- SF12.4a/ADR-030 Bloco B: preencher, na Fase 3 (autoria do pod-spec.json), os 3 campos
+     canônicos abaixo — DECLARADOS com conteúdo OU RECUSADOS (nao_se_aplica + razao +
+     respondido_por), NUNCA deixados de fora da spec. Ver docs/mecanismos/forma-canonica-do-forge.md -->
+<!-- ritmo: algum gate pode ser pulado em modo autônomo? -->
+<!-- contrato_entrada: a etapa inicial recebe mais de uma forma de entrada válida? -->
+<!-- entregavel: alguma etapa produz artefato binário/arquivo que precisa existir em disco? -->
+<!-- Campos de máquina (ADR-005 Decisão A) — registram que a PERGUNTA foi respondida nesta
+     entrevista (declarado|recusado); NÃO provam que a resposta foi transcrita ao pod-spec.json
+     (isso é o Bloco C, camada diferente — AC6).
+     Fronteira (ADR-034 DF-REPUB-8, Emenda 1): `credencial_registrada` é campo de máquina desta
+     entrevista e **entra no `pod-spec.json` como assertion do veto do `discovery` (Bloco B)**.
+     Ele **NÃO** é campo canônico de topo: **não existe** `credencial:` na raiz da spec e
+     `forge-generate` **não** o lê (`ADR-034` Emenda 1, `DEBT-REPUB-B`). Escrever
+     `credencial: {…}` na raiz é ignorado **em silêncio**. -->
+ritmo_registrado: <declarado|recusado>
+contrato_entrada_registrado: <declarado|recusado>
+entregavel_registrado: <declarado|recusado>
+credencial_registrada: <declarado|recusado>
+
+<!-- Campo de máquina do veto default (ADR-005) — NÃO é heading. Troque o placeholder por alta|media|baixa. -->
+confianca: <alta|media|baixa>

package/template/pods/squad-forge/templates/generation-tmpl.md

@@ -0,0 +1,18 @@
+# Template de saída — etapa `generation` (agente `forge-chief`, artefato `pod-artifacts`)
+
+> Gerado por forge-generate.cjs (SF1.4 + ADR-005). Preencher com o artefato real da etapa.
+> FORMA (seções `##`) verificada por checkTemplateConformance; VETO ORTOGONAL via o
+> campo de máquina `confianca` abaixo (fora dos headings — ADR-005 Decisão A).
+
+## Agentes Gerados
+<!-- count_gte "Agentes Gerados": conte itens de lista sob este heading — bullets (`- `/`* `), linhas numeradas (`1.` `2.` ...) OU linhas de tabela (`| ... |`, o separador `|---|---|` NÃO conta). Prosa corrida NÃO conta. -->
+<!-- preencher: conteúdo de "Agentes Gerados" -->
+
+## Aparato de Processo
+<!-- preencher: conteúdo de "Aparato de Processo" -->
+
+## Conformidade Estrutural
+<!-- preencher: conteúdo de "Conformidade Estrutural" -->
+
+<!-- Campo de máquina do veto default (ADR-005) — NÃO é heading. Troque o placeholder por alta|media|baixa. -->
+confianca: <alta|media|baixa>

package/template/pods/squad-forge/templates/red-team-tmpl.md

@@ -0,0 +1,17 @@
+# Template de saída — etapa `red-team` (agente `pod-critic`, artefato `review-verdict`)
+
+> Gerado por forge-generate.cjs (SF1.4 + ADR-005). Preencher com o artefato real da etapa.
+> FORMA (seções `##`) verificada por checkTemplateConformance; VETO ORTOGONAL via o
+> campo de máquina `confianca` abaixo (fora dos headings — ADR-005 Decisão A).
+
+## Verificacao Independente
+<!-- preencher: conteúdo de "Verificacao Independente" -->
+
+## Sobreposicao
+<!-- preencher: conteúdo de "Sobreposicao" -->
+
+## Veredito
+<!-- preencher: conteúdo de "Veredito" -->
+
+<!-- Campo de máquina do veto default (ADR-005) — NÃO é heading. Troque o placeholder por alta|media|baixa. -->
+confianca: <alta|media|baixa>

package/template/pods/squad-forge/templates/register-tmpl.md

@@ -0,0 +1,17 @@
+# Template de saída — etapa `register` (agente `forge-chief`, artefato `registration`)
+
+> Gerado por forge-generate.cjs (SF1.4 + ADR-005). Preencher com o artefato real da etapa.
+> FORMA (seções `##`) verificada por checkTemplateConformance; VETO ORTOGONAL via o
+> campo de máquina `confianca` abaixo (fora dos headings — ADR-005 Decisão A).
+
+## Stub de Command
+<!-- preencher: conteúdo de "Stub de Command" -->
+
+## README Atualizado
+<!-- preencher: conteúdo de "README Atualizado" -->
+
+## Registro
+<!-- preencher: conteúdo de "Registro" -->
+
+<!-- Campo de máquina do veto default (ADR-005) — NÃO é heading. Troque o placeholder por alta|media|baixa. -->
+confianca: <alta|media|baixa>

package/template/pods/squad-forge/templates/workflow-tmpl.yaml

@@ -0,0 +1,101 @@
+# workflow-tmpl.yaml — contrato do `wf-*.yaml` de um pod v0.3 (schema documentado).
+#
+# Este arquivo é a FONTE de geração dos `workflows/wf-*.yaml` reais (SF1.4) e o
+# documento de schema consumido pelo validador estático `scripts/validate-pod-workflow.cjs`
+# (SF1.1). Ele descreve, campo a campo, o contrato que todo workflow de pod deve honrar.
+#
+# Fronteira (ADR-002): este contrato prova BEM-FORMAÇÃO, nunca funcionamento.
+# `veto.assertions[]` são asserções ESTRUTURADAS e determinísticas (avaliáveis por
+# máquina). É PROIBIDO veto em prosa avaliada por LLM — qualidade de conteúdo
+# subjetiva é critério do `checkpoint.blocking` do pod-critic, não do veto.
+#
+# ---------------------------------------------------------------------------
+# CAMPOS OBRIGATÓRIOS
+# ---------------------------------------------------------------------------
+
+# (1) state_machine — a máquina de estados do workflow.
+#   states:   lista de estados; DEVE conter `init`, `complete` e `failed`.
+#   initial:  estado inicial (normalmente `init`).
+#   terminal: estados terminais; DEVE incluir `failed` (terminal, sem saída).
+state_machine:
+  states: [init, running, review, complete, failed]
+  initial: init
+  terminal: [complete, failed]
+
+# (2) steps[] — os passos do DAG. Cada passo declara:
+#   id:          identificador único do passo (referenciado por `depends_on`).
+#   agent:       agente do pod que executa o passo (OBRIGATÓRIO).
+#   template:    path do template de saída, relativo à raiz do pod (OBRIGATÓRIO;
+#                deve existir em disco).
+#   inputs:      lista de artefatos/entradas consumidos (nomes de `outputs` de
+#                passos a montante, ou entradas iniciais do workflow).
+#   outputs:     lista de artefatos produzidos (OBRIGATÓRIO, não-vazio). Todo
+#                output deve ser consumido por um `inputs` a jusante OU ser o
+#                artefato final (produzido por um passo-sumidouro do DAG).
+#   depends_on:  arestas do DAG — ids de passos que devem terminar antes deste.
+#                O grafo DEVE ser acíclico (fluxo unidirecional).
+#   checkpoint:  { blocking: bool, criteria: string, skip_modes?: [modo] } — gate humano.
+#                `blocking: true` para o runner até aprovação. Pode ser null.
+#                `criteria` é OBRIGATÓRIO quando `blocking: true` (gate sem critério escrito
+#                é pausa, não gate) e é GRATUITO em runtime: `buildBrief` não o lê, então ele
+#                nunca entra em brief nenhum — seja explícito e diga também o que o gate NÃO
+#                cobre. Chave desconhecida sob `checkpoint` é FALHA estática (o campo é
+#                contrato fechado; chave nova = motor mais novo ⇒ `update --scope motor`).
+#                `skip_modes` (SF11.10/ADR-024, OPCIONAL): ritmos de run que NÃO param neste
+#                gate — hoje o conjunto fechado é [interactive, yolo]. AUSENTE ⇒ bloqueia em
+#                TODO modo (default, retrocompat). Enumeração NEGATIVA de propósito: modo não
+#                listado BLOQUEIA (fail-closed). PULAR NÃO É APROVAR — num modo que pula,
+#                `approve()` não é chamado, a etapa nunca entra em `awaiting_approval` e o
+#                `state.json` grava `checkpoint: null` ali; o modo autônomo continua PROIBIDO
+#                de aprovar (ADR-020). INVARIANTE validado: cada modo precisa manter ao menos
+#                um checkpoint bloqueante NÃO-pulável — pular um gate é permitido, ficar sem
+#                gate não é. Uso típico: gate barato de conteúdo cedo no DAG (antes de uma
+#                etapa cara) que só o ritmo interativo atravessa.
+#   veto:        { assertions: [...] } — asserções de máquina (OBRIGATÓRIO).
+#                Ver formas suportadas abaixo.
+steps:
+  - id: discovery
+    agent: forge-chief
+    template: templates/discovery-tmpl.md
+    inputs: [brief]
+    outputs: [discovery]
+    depends_on: []
+    checkpoint: null
+    veto:
+      assertions:
+        - { type: section_exists, section: "## Escopo" }
+        - { type: count_gte, field: requisitos, n: 1 }
+
+  - id: build
+    agent: forge-chief
+    template: templates/build-tmpl.md
+    inputs: [discovery]
+    outputs: [pod_spec]
+    depends_on: [discovery]
+    checkpoint: null
+    veto:
+      assertions:
+        - { type: file_referenced_exists, field: template_ref }
+
+  - id: red_team
+    agent: pod-critic
+    template: templates/critique-tmpl.md
+    inputs: [pod_spec]
+    outputs: [verdict]
+    depends_on: [build]
+    checkpoint: { blocking: true, criteria: "score >= 8/10" }
+    veto:
+      assertions:
+        - { type: field_matches, field: veredito, pattern: "^(GO|NO-GO)$" }
+
+# ---------------------------------------------------------------------------
+# FORMAS SUPORTADAS DE `veto.assertions[]` (ADR-002 — as 5 desta fase)
+# ---------------------------------------------------------------------------
+# - section_exists        { type, section }           — seção existe no artefato.
+# - field_matches         { type, field, pattern }    — campo casa a regex.
+# - file_referenced_exists{ type, field }             — arquivo referenciado existe.
+# - count_gte             { type, field, n }           — contagem >= n.
+# - json_schema_valid     { type, schema }             — artefato valida no schema.
+#
+# Qualquer entrada de `veto` que não seja uma dessas formas estruturadas
+# (ex.: uma string de prosa livre) é REJEITADA pelo validador estático.

package/template/pods/squad-forge/workflows/wf-forge.smoke.json

@@ -0,0 +1,12 @@
+{
+  "_comment": "Cenário de smoke do wf-forge (SF6.1 dogfood, AUTORADO junto do pod-spec; discovery atualizado na SF12.4a/ADR-030 Bloco B com os 3 campos de registro novos). 'artifacts' = artefato CONFORME por etapa (caminho feliz) do canário 'quero um agente de checklist de onboarding de cliente': seções ## + campos de máquina (confianca sempre; ritmo_registrado/contrato_entrada_registrado/entregavel_registrado/credencial_registrada no discovery — sao 4: os 3 da SF12.4a mais credencial_registrada (ADR-034 Emenda 1, DF-REPUB-7); veredito na red-team; entry_point no register). O sweep --sweep DERIVA as violações (3a por etapa: 1 seção obrigatória removida; 3b por assertion: count_gte→0 itens sob o heading, field_matches→valor fora do pattern, file_referenced_exists→path inexistente) a partir destes conformes + template + spec. target_step=generation (legado 4-provas). entry_point aponta agents/forge-chief.md (existe em podRoot) — stand-in do entry point que a etapa register verifica existir; num *new real seria o path do agente gerado.",
+  "target_step": "generation",
+  "artifacts": {
+    "discovery": "## Job-to-be-done\nGerar e conduzir um checklist de onboarding de cliente novo.\n\n## Comandos\n- *checklist: gera o checklist de onboarding a partir do tipo de cliente\n- *validar: confere se todos os itens do onboarding foram cumpridos\n\n## Mapa de Conhecimento\n- etapas de onboarding -> knowledge/onboarding-steps.md (a criar)\n\n## Destino\nAgente novo em pod existente (dev-ia), justificado pela arvore de granularidade.\n\nritmo_registrado: recusado\ncontrato_entrada_registrado: recusado\nentregavel_registrado: recusado\ncredencial_registrada: recusado\nconfianca: alta\n",
+    "generation": "## Agentes Gerados\n- onboarding-checklist (entry point 42 linhas, budget 900)\n\n## Aparato de Processo\nTier SIMPLE: 1 workflow minimo + templates das saidas; sem squad-io/memoria obrigatorios.\n\n## Conformidade Estrutural\nEntry point <=150 linhas, 3 blocos na ordem, budget dentro do teto.\n\nconfianca: alta\n",
+    "red-team": "## Verificacao Independente\nvalidate-budgets.js rodado; smoke dos comandos rodado; destinos conferidos com ls.\n\n## Sobreposicao\nNenhuma sobreposicao com pods/agentes existentes; fronteira documentada.\n\n## Veredito\nArtefato sobrevive a critica; correcoes aplicadas.\n\nveredito: APROVADO\nconfianca: alta\n",
+    "register": "## Stub de Command\nStub /power:onboarding-checklist criado (<=15 linhas, aponta o entry point).\n\n## README Atualizado\nLinha adicionada em pods/README.md e no README do pod dono.\n\n## Registro\nArtefato descobrivel e registrado; validate-budgets re-executado verde.\n\nentry_point: agents/forge-chief.md\nconfianca: alta\n"
+  },
+  "template_violation": "## Agentes Gerados\n- onboarding-checklist (entry point 42 linhas, budget 900)\n\n## Aparato de Processo\nTier SIMPLE.\n\nconfianca: alta\n",
+  "veto_violation": "## Agentes Gerados\n- onboarding-checklist (entry point 42 linhas, budget 900)\n\n## Aparato de Processo\nTier SIMPLE.\n\n## Conformidade Estrutural\n3 blocos, budget ok.\n\nconfianca: incerta\n"
+}

package/template/pods/squad-forge/workflows/wf-forge.yaml

@@ -0,0 +1,60 @@
+# wf-forge.yaml — gerado por forge-generate.cjs (SF1.4).
+# Contrato: templates/workflow-tmpl.yaml. Validador: scripts/validate-pod-workflow.cjs.
+
+state_machine:
+  states: [init, running, review, complete, failed]
+  initial: init
+  terminal: [complete, failed]
+
+steps:
+  - id: discovery
+    agent: forge-chief
+    template: templates/discovery-tmpl.md
+    inputs: [brief]
+    outputs: [scope-brief]
+    depends_on: []
+    checkpoint: null
+    veto:
+      assertions:
+        - { type: count_gte, field: Comandos, n: 1, _sources: "tasks/pipeline.md:17 G1 'Lista de comandos com entregável de cada um' — condição machine-redutível a count_gte (≥1 comando declarado), ortogonal (a forma '## Comandos' existe; a contagem de itens é independente), derivável pelo sweep (0 itens → bloqueia)" }
+        - { type: field_matches, field: ritmo_registrado, pattern: "^(declarado|recusado)$", _sources: "SF12.4a/ADR-030 Bloco B (AC6): G1 novo checkbox 'Ritmo de checkpoint' — prova que o artefato do discovery REGISTROU a resposta em forma reconhecível pelo veto; não prova que foi transcrita ao pod-spec.json (Bloco C, camada diferente)." }
+        - { type: field_matches, field: contrato_entrada_registrado, pattern: "^(declarado|recusado)$", _sources: "SF12.4a/ADR-030 Bloco B (AC6): G1 novo checkbox 'Contrato de entrada' — mesmo alcance declarado do item anterior." }
+        - { type: field_matches, field: entregavel_registrado, pattern: "^(declarado|recusado)$", _sources: "SF12.4a/ADR-030 Bloco B (AC6): G1 novo checkbox 'Entregável' — mesmo alcance declarado do item anterior." }
+        - { type: field_matches, field: credencial_registrada, pattern: "^(declarado|recusado)$", _sources: "ADR-034 DF-REPUB-7 (Emenda 1): 4º checkbox declare-ou-recuse, camada Bloco B (agents[discovery].veto) — mesma camada dos 3 irmãos, não o campo canônico de topo (Bloco A/C, DEBT-REPUB-B). Sem esta assertion na spec, a próxima regeneração (forge-generate) apaga a assertion do wf em silêncio (medido, C4 vs C5 no *review). Alcance declarado (DF-REPUB-6): prova que a PERGUNTA foi respondida; não prova que a resposta é verdadeira." }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora hormozi-method); campo de máquina ortogonal fora dos headings (ADR-005 Decisão A)" }
+
+  - id: generation
+    agent: forge-chief
+    template: templates/generation-tmpl.md
+    inputs: [scope-brief]
+    outputs: [pod-artifacts]
+    depends_on: [discovery]
+    checkpoint: null
+    veto:
+      assertions:
+        - { type: count_gte, field: "Agentes Gerados", n: 1, _sources: "tasks/pipeline.md:36 Fase 3 'gerar os agentes (sempre)' — ≥1 agente é sempre produzido; count_gte n:1 ortogonal e derivável (0 itens → bloqueia)" }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora)" }
+
+  - id: red-team
+    agent: pod-critic
+    template: templates/red-team-tmpl.md
+    inputs: [pod-artifacts]
+    outputs: [review-verdict]
+    depends_on: [generation]
+    checkpoint: { blocking: true, criteria: "Veredito APROVADO explícito por escrito do pod-critic (verificação independente: valida-pod-workflow + smoke rodados por ele mesmo, G6 estendido). REPROVADO → volta à Fase 3 com a lista de correções. JULGAMENTO HUMANO — NUNCA veto de máquina (fronteira ADR-002; a máquina não decide 'aprovado')." }
+    veto:
+      assertions:
+        - { type: field_matches, field: veredito, pattern: "^(APROVADO|REPROVADO)$", _sources: "tasks/pipeline.md:67 G4 'Veredito APROVADO explícito por escrito' — o veto de MÁQUINA garante que um veredito BEM-FORMADO foi registrado (APROVADO|REPROVADO), NUNCA decide qual é o correto (isso é julgamento → checkpoint). Ortogonal (campo fora dos headings) e derivável (valor fora do pattern → bloqueia)" }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora)" }
+
+  - id: register
+    agent: forge-chief
+    template: templates/register-tmpl.md
+    inputs: [review-verdict]
+    outputs: [registration]
+    depends_on: [red-team]
+    checkpoint: { blocking: true, criteria: "Registro conferido: stub em disco (≤15 linhas, aponta o entry point), linha em pods/README.md, validate-budgets re-executado verde. Fase 5 termina em DECISÃO DO USUÁRIO (sem commit automático) — checkpoint bloqueante, não veto." }
+    veto:
+      assertions:
+        - { type: file_referenced_exists, field: entry_point, _sources: "tasks/pipeline.md:88 G5 'Stub de command criado... aponta para o entry point' — o registro referencia o entry point (o agente dono); file_referenced_exists verifica que ele EXISTE em disco. Machine-redutível, ortogonal (campo fora dos headings), derivável (path inexistente → bloqueia)" }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora)" }