@daniellins/power-claude 0.16.3

package/template/pods/content-carousel/knowledge/image-generation.md

@@ -0,0 +1,62 @@
+# Geração de imagem via OpenRouter — capa e CTA
+
+Procedimento do comando `*visuals {news-digest} {ref-pinterest} [{modelo}]` do `carousel-visual`.
+
+## Restrição inegociável de direito autoral
+
+A imagem do Pinterest fornecida pelo usuário é **referência de ESTILO e COMPOSIÇÃO — nunca base copiada**:
+
+- **PROIBIDO** enviar a imagem de referência ao modelo (img2img, init image, edição sobre ela, "faça igual a esta").
+- **PROIBIDO** prompt que descreva o CONTEÚDO específico da referência a ponto de reproduzi-la (mesma cena, mesmos objetos, mesmo enquadramento com o mesmo assunto).
+- **PERMITIDO** extrair e usar atributos abstratos: paleta de cores, iluminação, técnica/acabamento (ex.: flat, 3D, colagem, grão de filme), densidade visual, tipo de composição (ex.: sujeito central, regra dos terços, negative space no topo), mood.
+- Ao final, comparar o resultado com a referência: se um observador razoável diria "é a mesma imagem/uma derivação dela", REGENERAR com prompt ajustado. Só então declarar `referencia_copiada: nao`.
+
+## Passo 1 — Extrair o estilo da referência (em texto)
+
+Analisar a imagem do Pinterest e escrever 5-8 atributos de estilo/composição (paleta, luz, técnica, composição, mood, textura). Esses atributos — e SÓ eles — carregam a referência para o prompt.
+
+## Passo 2 — Montar os prompts
+
+- **Capa:** tema visual derivado da NOTÍCIA (metáfora visual do assunto do digest) + atributos de estilo extraídos + diretivas de uso: formato 4:5 (1080×1350), área de respiro para o título (a capa recebe texto por cima via HTML), sem texto embutido na imagem, alto contraste na zona do título.
+- **CTA:** mesma família visual da capa (mesma paleta/técnica), mais sóbrio/escuro para sustentar frase curta em destaque, sem texto embutido.
+
+### Andaime de prompt SCDS (absorvido do corpus — SF7.5/AC18)
+
+Estruture cada prompt de capa/CTA nos 5 blocos, para repetibilidade entre rodadas:
+
+```
+[SUBJECT]: o foco visual (a metáfora derivada da notícia)
+[SETTING]: o ambiente/cenário
+[STYLE]: técnica + mood + paleta (os atributos extraídos da referência entram AQUI)
+[TECHNICAL]: aspect ratio 4:5, zona de respiro para o título, sem texto na imagem
+[NEGATIVE]: sem cara de banco de imagem, sem clipart, sem marca d'água, sem texto
+```
+
+Fonte: corpus do benchmark, `ai-content-designer/SKILL.md`, "Always structure prompts with
+SCDS: [SUBJECT]... [SETTING]... [STYLE]... Mood... Color palette... [TECHNICAL]: Aspect ratio
+{ratio}, 2K resolution, no text in image; [NEGATIVE]: No stock photo feel, no clipart, no
+watermarks, no text".
+
+## Credencial da OpenRouter — regra inegociável
+
+**Origem única.** A `OPENROUTER_API_KEY` vem do arquivo `.env` da raiz do repositório do projeto, carregado no ambiente do processo (`set -a; source .env; set +a` em subshell) — **e de nenhuma outra origem**. Não existe origem secundária, alternativa ou de fallback.
+
+**Não procurar em outro lugar.** Se a variável estiver ausente ou vazia no ambiente, sua tarefa **não é encontrar a chave** — é parar e reportar (abaixo). Como a única origem permitida é a nomeada acima, **qualquer outra origem é proibida, esteja ou não listada aqui**. A lista a seguir são exemplos do que essa regra já proíbe, não a fronteira dela: arquivos de perfil do shell (`~/.zshrc`, `~/.zshenv`, `~/.zprofile`, `~/.bashrc`, `~/.bash_profile`, `~/.profile`), Keychain do macOS (`security find-generic-password` e equivalentes), qualquer gerenciador de segredo ou cofre de credencial (CLI, agente ou GUI), histórico de shell, variáveis de ambiente de outros processos (inclusive do processo pai) e varredura de filesystem procurando padrão de chave.
+
+**Nunca expor o valor.** A chave é **usada**, nunca **exibida**: não imprimir, ecoar, logar, colar em relatório, artefato, prompt log ou mensagem, nem escrever em arquivo — **nem completo, nem parcial**. Prefixo, sufixo, "últimos 4", comprimento, hash ou qualquer derivado que permita conferir o valor são igualmente proibidos. Não escrever o valor literal na linha de comando (argv é visível em `ps` e no histórico): referencie a variável já carregada no ambiente.
+
+**Chave ausente ou vazia: reportar e parar.** Não gerar, não iterar, não improvisar. O relatório diz apenas: que `OPENROUTER_API_KEY` está ausente ou vazia, que ela deve estar no `.env` da raiz do repositório, e que o operador precisa preenchê-la e **re-despachar a mesma etapa**. Nunca o valor, nunca uma dica sobre o valor, nunca uma sugestão de onde mais procurar.
+
+## Passo 3 — Chamar o modelo via OpenRouter
+
+- Modelo: o fornecido pelo usuário na rodada; **default: Nano Banana 2 (Gemini 3.1 Flash Image)**.
+- Endpoint: API da OpenRouter (`https://openrouter.ai/api/v1/chat/completions`), autenticação via `OPENROUTER_API_KEY` obtida **exclusivamente** conforme a seção "Credencial da OpenRouter" acima, pedido de saída de imagem (modality image) com o prompt do Passo 2.
+- Salvar cada imagem retornada em `assets/` da rodada (`cover-bg.png`, `cta-bg.png`).
+- Falha de API, chave ausente ou chave vazia: reportar e parar — nunca substituir por imagem de banco/stock, pela própria referência, por placeholder ou por qualquer arte fabricada. A forma do relatório está na seção "Credencial da OpenRouter".
+
+## Passo 4 — Entregar o `visual-set` (templates/visuals-tmpl.md)
+
+- `## Prompt da Capa` e `## Prompt do CTA`: prompts finais enviados + modelo usado + iterações (prompt log completo).
+- `## Arquivos Gerados`: paths dos backgrounds salvos.
+- `## Conformidade de Referencia`: atributos extraídos da referência + justificativa de por que o resultado NÃO é cópia/derivação (comparação explícita).
+- Campos de máquina: `referencia_copiada: nao` (só após a comparação do Passo 1/regeneração) e `confianca: alta|media|baixa`.

package/template/pods/content-carousel/knowledge/selecao-de-ancora.md

@@ -0,0 +1,60 @@
+# Seleção e validação de âncora além do HN — destilado do corpus (SF7.5/AC18)
+
+Complemento ao contrato de `knowledge/aquisicao-ancora.md` §0: o pipeline SEMPRE parte de uma
+âncora fixada pelo usuário — este documento ajuda o DONO a escolher e validar essa âncora
+quando a fonte não é o Hacker News, e ajuda o curador a qualificar o "sinal de relevância" e a
+diferenciar os ângulos. Absorvido com adjudicação seletiva do corpus congelado do benchmark
+4-braços (skill `ai-content-miner`): só entrou o que complementa o que o pod já tinha.
+
+## 1. Onde procurar âncora fora do HN (taxonomia em 3 camadas)
+
+A taxonomia é do mecanismo; **a lista de fontes é sua** — ela depende do seu tema, e a lista de
+outra pessoa direciona mal o seu conteúdo. Monte a sua uma vez, em `knowledge/`, e reuse:
+
+- **Camada 1 — fontes primárias** (quem PRODUZ o fato: criadores, pesquisadores, a própria
+  organização que anunciou; prioridade máxima). Como reconhecer: publica o fato em primeira
+  mão, tem o que perder se errar, e é citada pelas outras camadas.
+- **Camada 2 — fontes secundárias** (comunidade e agregadores: fóruns técnicos, vídeo, listas
+  de lançamento). Úteis para **sinal de tração**, nunca para o fato — confirme sempre na
+  camada 1 antes de publicar.
+- **Camada 3 — fontes especializadas** (nicho, setor ou região) — entram quando o tema pede
+  recorte que as duas primeiras não cobrem.
+- Regra que acompanha a taxonomia: credibilidade de fonte primeiro — verificar a afirmação na
+  fonte primária antes de amplificar; citar e atribuir sempre.
+
+Fonte: corpus do benchmark, `ai-content-miner/references/source-taxonomy.md` ("Tier 1 sources
+are searched every run. Tier 2 when doing weekly sweeps. Tier 3 for specialized topics") e
+`ai-content-miner/SKILL.md` ("Source credibility first — Prioritize Tier 1 sources... Verify
+claims before amplifying. Always cite and attribute").
+
+## 2. Sinais de tração para validar a âncora (qualquer fonte)
+
+O HN dá score/comentários de graça; fora dele, use sinais equivalentes para o campo "sinal de
+relevância" do digest:
+
+- Mesmo assunto em 3+ fontes primárias em 24h.
+- Reação de nomes grandes da área ao item.
+- Repositório com >1K stars em 24h; >500 upvotes com discussão substantiva em fórum técnico.
+- Cobertura por 2+ newsletters de referência na mesma semana.
+
+Fonte: corpus do benchmark, `ai-content-miner/SKILL.md`, bloco "Virality signals (boost score
+by +5 when detected): Same topic appears in 3+ Tier 1 sources within 24h; Big names react...;
+GitHub repo gains >1K stars in 24h; 2+ Tier 1 newsletters cover in same week; >500 upvotes on
+Reddit with substantive discussion".
+
+## 3. Diferenciação dos ângulos — framework 5 Cs (com trava de uso)
+
+Para cumprir "a visão do especialista aparece de verdade" nos ângulos 4-5 do digest
+(por que importa / e agora), diferencie com pelo menos 2 destes, nunca os 5 na mesma peça:
+
+| C | O que adiciona |
+|---|---|
+| Context | Conecta ao quadro maior ("isso importa porque, no Brasil...") |
+| Comparison | Compara com o que existia antes ("antes: US$100/dia; agora: US$10") |
+| Consequence | Projeta o impacto ("em 12 meses isso significa...") |
+| Case | Traz experiência própria do dono ("testei com meu time e...") |
+| Counsel | Dá ação prática ("se você é X, faça Y amanhã") |
+
+Fonte: corpus do benchmark, `ai-content-miner/SKILL.md`, "Differentiation — The 5 Cs
+Framework" + "Regra de ouro: Sempre usar pelo menos 2 Cs por peça de conteúdo. Nunca aplicar
+todos os 5 na mesma peça — dilui o impacto e aumenta o tamanho sem ganho de engajamento".

package/template/pods/content-carousel/knowledge/slides-html.md

@@ -0,0 +1,56 @@
+# Slides do carrossel em HTML — especificação
+
+Procedimento do comando `*assemble {news-digest} {visual-set}` do `carousel-builder` (parte 1: capa + slides internos; o CTA segue `knowledge/cta-brief.md`).
+
+## Formato base (todas as 7 peças)
+
+- Um arquivo HTML autocontido por slide: CSS inline ou em `<style>` no próprio arquivo, sem dependência de rede (fontes do sistema ou websafe).
+- Canvas 1080×1350 px (4:5, feed do Instagram): `body`/container com dimensão fixa.
+- HTML que parseia sem erro — validar antes de entregar (peça quebrada não entra no pacote).
+- Nomenclatura da rodada: `01-capa.html`, `02-slide.html` … `06-slide.html`, `07-cta.html` (+ `assets/` com os backgrounds gerados).
+- **LUGAR — invariante do pod, não preferência de estilo (`ADR-028 DF-SF12.2-1`).** As 7 peças são
+  escritas na **RAIZ do `runDir`**, lado a lado com `artifacts/`, `assets/` e `png/` — **nunca** dentro
+  de um subdiretório (`pieces/`, `html/`, `slides/` e afins). Não é convenção estética: o veto
+  `command_check render-png.cjs` da etapa recebe `--html-dir ".."` como argumento **LITERAL** (a
+  `ADR-011` Decisão 2 proíbe interpolação em `command_check`, por modelo de ameaça), então ele procura
+  as peças **exatamente ali**. Peça escrita em outro lugar ⇒ o veto conta 0 de 7 esperadas e a etapa
+  **BLOQUEIA**, com a causa nomeada. Vale IGUAL nos dois runtimes que executam este pod — o CLI
+  (`pc-run-pod.cjs`) e o executor de export —, porque a invariante é do POD e viaja com ele. Layout do
+  `runDir` numa rodada fechada: `01-capa.html` … `07-cta.html`, `assets/`, `png/` (gerado pelo veto),
+  `artifacts/`.
+
+## Capa (`01-capa.html`)
+
+- Background: `assets/cover-bg.png` do `visual-set` (imagem GERADA — nunca a referência do Pinterest).
+- Título da notícia reescrito como gancho (≤10 palavras), tipografia grande (≥72 px), na zona de respiro prevista no prompt da capa.
+- Overlay/gradiente sutil se necessário para garantir contraste do título sobre a imagem.
+
+## Slides internos (`02`–`06` — exatamente 5)
+
+- **Um ângulo do digest por slide**, na ordem de progressão do `news-digest` (gancho → fato → como funciona → por que importa → e agora).
+- Hierarquia por slide: título curto (≤8 palavras, ≥56 px) + corpo de 2-4 frases (≥36 px) — uma ideia por tela.
+- Legibilidade: contraste mínimo AA (texto vs fundo), margens ≥64 px, sem parágrafo com mais de 4 linhas renderizadas.
+- Consistência: mesma paleta derivada do visual-set nas 7 peças (capa e CTA carregam a imagem; os internos ecoam a paleta em fundo sólido/degradê discreto — texto legível vem antes de decoração).
+- Conteúdo fiel ao digest: cada afirmação existe no `news-digest`; slide não introduz fato novo.
+- Numeração de progresso discreta (ex.: "2/7") e handle do dono (`knowledge/dono.yaml`) em rodapé sutil.
+- Fonte técnica de nicho (HN ou equivalente) NUNCA no corpo do slide: se a citação tiver ganho real, entra discreta no rodapé (regra de audiência — regra de ouro do `hn-curator`).
+
+## Revisão de língua pré-fechamento (gate absorvido do corpus — SF7.5/AC18)
+
+Antes de fechar o pacote, revisar TODO o texto renderizável com rigor: acentuação completa
+(agudos, circunflexos, til, cedilha, crase), ortografia, pontuação e concordância — o slide
+renderiza o texto EXATAMENTE como está no HTML, e erro de língua vira erro permanente na peça
+publicada. Texto com erro não fecha pacote.
+
+Fonte: corpus do benchmark, `carrossel-instagram/SKILL.md`, Fase 3 ("Todo texto DEVE passar
+por esta revisão ANTES de renderizar PNGs. O carousel-generator renderiza o texto EXATAMENTE
+como está no HTML — erros no input serão erros permanentes nos PNGs") e GRAMMAR GATE ("Texto
+DEVE estar 100% correto em PT-BR antes de renderizar").
+
+## Pacote final (`carousel-package`, templates/assembly-tmpl.md)
+
+- `## Slides Internos`: lista dos 5 arquivos com o ângulo de cada um (≥5 itens — veto do workflow).
+- `## Slide CTA`: conforme `knowledge/cta-brief.md`.
+- `## Pacote Final`: os 7 paths na ordem de publicação + assets — **relativos à raiz do `runDir`**
+  (`01-capa.html`, nunca `pieces/01-capa.html`), coerentes com a invariante de lugar acima.
+- Campo de máquina `confianca: alta|media|baixa`.

package/template/pods/content-carousel/memory/README.md

@@ -0,0 +1,18 @@
+# Memória do pod `content-carousel` — OPERANTE (SF2.3)
+
+> Instalada por forge-generate.cjs via o motor `scripts/pod-memory.cjs` (SF2.1).
+> Tier: STANDARD/COMPLEX. Esta memória NÃO é scaffold morto: nasce cabeada ao lifecycle.
+> No template ela nasce ZERADA (regra fixa de absorção, precedente SF5.6): a experiência
+> é por-instância e não é distribuída.
+
+## Cabeamento (nenhuma ação manual necessária)
+
+- `learnings.jsonl` — log cru append-only. O runner (`pc-run-pod`, SF2.2) faz `append()`
+  ao fim de cada etapa/run. O AGENTE NUNCA lê este arquivo (auditoria apenas).
+- `learnings.consolidated.md` — top-N curado (`consolidate()`), no path canônico que
+  `getConsolidatedForBrief()` entrega ao brief da run. É o ÚNICO que o agente lê.
+- Auditoria de aderência por run: `config/heuristic-watcher-rubric.yaml` +
+  `scripts/watcher-audit.cjs` (executado pelo `pod-critic`).
+
+Assim que este pod rodar via `pc-run-pod`, injeção do consolidado no brief e append de
+learnings funcionam sem qualquer passo manual — a operância é o cabeamento ao motor pronto.

package/template/pods/content-carousel/memory/learnings.consolidated.md

@@ -0,0 +1,6 @@
+# Memória consolidada — content-carousel
+
+> Curado por pod-memory.cjs (SF2.1). Único artefato de memória lido pelo agente.
+> Log cru (learnings.jsonl) NÃO é lido pelo agente — auditoria apenas.
+
+## Heurísticas (top-N)

package/template/pods/content-carousel/pod-spec.json

@@ -0,0 +1,100 @@
+{
+  "pod": "content-carousel",
+  "workflowId": "content-carousel",
+  "_adr": "ADR-005 Decisão B: a ordem do DAG é DADO DECLARADO (agents[] ordenado = ordem topológica do pipeline digest → visuals → assembly), nunca readdir/alfabético. Pod gerado via forge-chief *new (pipeline squad-forge, Fases 1-5).",
+  "_sources": {
+    "estrutura": "Brief de escopo (Fase 1 Discovery): capa + 5 slides internos + CTA = 7 peças, fixo (resposta do usuário na elicitação)",
+    "modelo_imagem": "Default Nano Banana 2 (Gemini 3.1 Flash Image) via OpenRouter (resposta do usuário na elicitação); parametrizável por rodada conforme a necessidade original ('cada rodada com ... um modelo de imagem diferentes que eu forneço')",
+    "restricao_referencia": "Necessidade original: imagem do Pinterest é REFERÊNCIA DE ESTILO E COMPOSIÇÃO — a imagem gerada nunca pode ser cópia ou derivação direta (direito autoral). Machine-redutível ao campo referencia_copiada: ^nao$ (veto da etapa visuals)",
+    "fronteira_veto_checkpoint": "ADR-002: contagens/padrões → veto.assertions; julgamento de qualidade visual/copy → checkpoint.blocking na etapa final"
+  },
+  "handoffs": 2,
+  "dna": false,
+  "critical": false,
+  "agents": [
+    {
+      "name": "hn-curator",
+      "step": "digest",
+      "output": "news-digest",
+      "sections": [
+        "## Noticia",
+        "## Sintese Acessivel",
+        "## Angulos para Slides"
+      ],
+      "veto": [
+        {
+          "type": "count_gte",
+          "field": "Angulos para Slides",
+          "n": 5,
+          "_sources": "Estrutura fixa: 5 slides internos exigem ≥5 ângulos de conteúdo no digest — contagem machine-redutível"
+        },
+        {
+          "type": "field_matches",
+          "field": "confianca",
+          "pattern": "^(alta|media|baixa)$",
+          "_sources": "convenção de conformidade do pod (âncora squad-forge/hormozi-method); campo de máquina ortogonal fora dos headings (ADR-005 Decisão A)"
+        }
+      ]
+    },
+    {
+      "name": "carousel-visual",
+      "step": "visuals",
+      "output": "visual-set",
+      "sections": [
+        "## Prompt da Capa",
+        "## Prompt do CTA",
+        "## Arquivos Gerados",
+        "## Conformidade de Referencia"
+      ],
+      "veto": [
+        {
+          "type": "field_matches",
+          "field": "referencia_copiada",
+          "pattern": "^nao$",
+          "_sources": "Restrição de direito autoral da necessidade original: a etapa declara explicitamente que a imagem gerada não é cópia/derivação direta da referência; valor fora do pattern bloqueia"
+        },
+        {
+          "type": "field_matches",
+          "field": "confianca",
+          "pattern": "^(alta|media|baixa)$",
+          "_sources": "convenção de conformidade do pod (âncora)"
+        }
+      ]
+    },
+    {
+      "name": "carousel-builder",
+      "step": "assembly",
+      "output": "carousel-package",
+      "sections": [
+        "## Slides Internos",
+        "## Slide CTA",
+        "## Pacote Final"
+      ],
+      "veto": [
+        {
+          "type": "count_gte",
+          "field": "Slides Internos",
+          "n": 5,
+          "_sources": "Estrutura fixa capa+5+CTA: ≥5 slides internos listados — contagem machine-redutível"
+        },
+        {
+          "type": "field_matches",
+          "field": "confianca",
+          "pattern": "^(alta|media|baixa)$",
+          "_sources": "convenção de conformidade do pod (âncora)"
+        },
+        {
+          "type": "command_check",
+          "command": "lexical-check.cjs",
+          "args": ["--max", "0", "--pattern", "[—–]"],
+          "_sources": "Guarda de voz (ADR-013 Decisão 3, 1º wiring real do lexical-check.cjs/SF7.2): veto léxico default DERIVADO de voz.lexico_proibido do guia do dono (dono.example.yaml: em-dash U+2014 e en-dash U+2013). Args LITERAIS (ADR-011 proíbe interpolação): derivação em tempo de AUTORIA — ao editar voz.lexico_proibido na instância, o agente atualiza estes args junto (golden rule do carousel-builder)"
+        }
+      ],
+      "checkpoint": {
+        "blocking": true,
+        "criteria": "Carrossel completo conferido: capa + 5 slides internos + CTA = 7 peças; capa e CTA com background gerado (não cópia da referência Pinterest); frase de fechamento forte e remissão à autoridade do dono (knowledge/dono.yaml) presentes; VOZ DO DONO conferida em julgamento (ADR-013): peça inteira na 1ª pessoa do dono, dono NUNCA citado em 3ª pessoa como fonte externa (defeito R2 do benchmark — citação factual de TERCEIROS continua legítima), tom conforme voz.tom do guia. JULGAMENTO HUMANO — nunca veto de máquina (fronteira ADR-002); endurecer a cláusula de 3ª pessoa a veto é opt-in via *harden-learning."
+      }
+    }
+  ],
+  "smoke_scenario": "workflows/wf-content-carousel.smoke.json"
+}

package/template/pods/content-carousel/squad-io.yaml

@@ -0,0 +1,10 @@
+# squad-io.yaml — contrato de handoff do pod `content-carousel` (SF1.4).
+# Cada handoff liga o output de uma etapa ao input da etapa a jusante.
+pod: content-carousel
+handoffs:
+  - from: digest
+    to: visuals
+    artifact: news-digest
+  - from: visuals
+    to: assembly
+    artifact: visual-set

package/template/pods/content-carousel/templates/assembly-tmpl.md

@@ -0,0 +1,23 @@
+# Template de saída — etapa `assembly` (agente `carousel-builder`, artefato `carousel-package`)
+
+> 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).
+
+## Slides Internos
+<!-- count_gte "Slides Internos": 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 "Slides Internos" -->
+
+## Slide CTA
+<!-- preencher: conteúdo de "Slide CTA" -->
+
+## Pacote Final
+<!-- LUGAR (ADR-028 DF-SF12.2-1): os 7 paths são RELATIVOS À RAIZ do runDir — `01-capa.html`,
+     `02-slide.html` … `07-cta.html` (+ `assets/`). NUNCA prefixados por subdiretório
+     (`pieces/01-capa.html` está ERRADO). O veto `render-png.cjs` da etapa recebe `--html-dir ".."`
+     como argumento LITERAL (ADR-011 proíbe interpolação): peça fora da raiz não é encontrada e a
+     etapa BLOQUEIA. Ver `knowledge/slides-html.md`, "Formato base". -->
+<!-- preencher: conteúdo de "Pacote Final" -->
+
+<!-- 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/content-carousel/templates/digest-tmpl.md

@@ -0,0 +1,29 @@
+# Template de saída — etapa `digest` (agente `hn-curator`, artefato `news-digest`)
+
+> 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).
+
+## Noticia
+<!-- preencher: conteúdo de "Noticia" -->
+
+## Sintese Acessivel
+<!-- preencher: conteúdo de "Sintese Acessivel" -->
+
+## Angulos para Slides
+<!-- count_gte "Angulos para Slides": 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 "Angulos para Slides" -->
+
+<!-- Campo de máquina do veto default (ADR-005) — NÃO é heading. Troque o placeholder por alta|media|baixa. -->
+confianca: <alta|media|baixa>
+
+<!-- Campo de máquina da ENTRADA (ADR-020 DF-SF10.21-3/-11) — NÃO é heading. Par <modo>:<fonte> que
+     esta run de fato usou, espelhando o `entrada=`/`fonte=` da linha `Tarefa:` do brief. O veto
+     `field_matches` da etapa aceita SÓ as combinações implementadas: os pares estão na MATRIZ
+     `knowledge/aquisicao-ancora.md` §0.3 e o pattern literal vive só no `wf`; qualquer outro valor
+     BLOQUEIA a etapa. Nome do campo NÃO pode ser `fonte`: extractField casa a PRIMEIRA ocorrência no
+     artefato inteiro e a seção `## Noticia` já registra a fonte (domínio do artigo).
+     Em `entrada=roteiro` (ADR-026), o bloco `pc:fidelidade-roteiro` é gravado DEPOIS destes dois campos,
+     sob o heading `## Fidelidade ao Roteiro` — seção EXTRA do artefato, que este template não exige e
+     não proíbe (conformidade é superset). Ver `aquisicao-ancora.md` §1b.5. -->
+contrato_entrada: <ancora:hn|roteiro:proprio>

package/template/pods/content-carousel/templates/visuals-tmpl.md

@@ -0,0 +1,20 @@
+# Template de saída — etapa `visuals` (agente `carousel-visual`, artefato `visual-set`)
+
+> 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).
+
+## Prompt da Capa
+<!-- preencher: conteúdo de "Prompt da Capa" -->
+
+## Prompt do CTA
+<!-- preencher: conteúdo de "Prompt do CTA" -->
+
+## Arquivos Gerados
+<!-- preencher: conteúdo de "Arquivos Gerados" -->
+
+## Conformidade de Referencia
+<!-- preencher: conteúdo de "Conformidade de Referencia" -->
+
+<!-- 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/content-carousel/workflows/wf-content-carousel.smoke.json

@@ -0,0 +1,23 @@
+{
+  "_comment": "Cenário de smoke do wf-content-carousel (autorado junto do pod-spec no *new, padrão wf-forge.smoke.json). 'artifacts' = artefato CONFORME por etapa (caminho feliz) do canário 'notícia de exemplo do HN sobre um release de modelo open-source'. 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) a partir destes conformes + template + spec. target_step=visuals (legado 4-provas): template_violation remove a seção '## Conformidade de Referencia'; veto_violation mantém a forma mas declara referencia_copiada: sim (viola ^nao$). SF11.6/ADR-020: o conforme de 'digest' declara `contrato_entrada: ancora:hn` — obrigatório desde que a etapa ganhou a assertion field_matches sobre o par <modo>:<fonte>; sem esta linha o smoke cai para 0/4 (verificado POR EXECUÇÃO antes de atualizar este sidecar, guarda SF10.18). Os títulos de ângulo/slide do canário NÃO colocam a fonte técnica como protagonista (REGRA DE AUDIÊNCIA do hn-curator) — é fixture, mas fixture também ensina.",
+  "target_step": "visuals",
+  "artifacts": {
+    "digest": "## Noticia\nItem HN 40000001 (news.ycombinator.com/item?id=40000001), capturado no timestamp fornecido. Artigo: release de um modelo open-source de geracao de codigo. Score 850, 420 comentarios.\n\n## Sintese Acessivel\nUm laboratorio liberou um modelo de IA de codigo aberto que roda em hardware comum. Importa porque reduz o custo de entrada para desenvolvedores.\n\n## Angulos para Slides\n1. Rodar IA de codigo sem pagar API\n2. O que exatamente foi lancado\n3. Como funciona, explicado sem jargao\n4. O impacto pratico para quem desenvolve\n5. O que a comunidade espera acontecer agora\n\nconfianca: alta\ncontrato_entrada: ancora:hn\n",
+    "visuals": "## Prompt da Capa\nComposicao central com negative space no topo, paleta azul-eletrico sobre grafite, acabamento flat com grao sutil, 4:5 1080x1350, sem texto embutido. Modelo: Nano Banana 2 via OpenRouter. 1 iteracao.\n\n## Prompt do CTA\nMesma familia visual da capa, fundo mais sobrio e escuro para frase em destaque, sem texto embutido. Modelo: Nano Banana 2 via OpenRouter. 1 iteracao.\n\n## Arquivos Gerados\n- assets/cover-bg.png\n- assets/cta-bg.png\n\n## Conformidade de Referencia\nAtributos extraidos da referencia Pinterest (paleta, luz, composicao central, acabamento flat) usados SO como texto; a referencia nao foi enviada ao modelo; comparacao final: resultado nao e copia nem derivacao direta.\n\nreferencia_copiada: nao\nconfianca: alta\n",
+    "assembly": "## Slides Internos\n- 02-slide.html: Rodar IA de codigo sem pagar API\n- 03-slide.html: O que exatamente foi lancado\n- 04-slide.html: Como funciona, explicado sem jargao\n- 05-slide.html: O impacto pratico para quem desenvolve\n- 06-slide.html: O que a comunidade espera acontecer agora\n\n## Slide CTA\n07-cta.html: background assets/cta-bg.png, frase de fechamento 'Quem entende isso hoje sai na frente.', remissao a autoridade tecnica de Alexa Exemplo (@alexa.exemplo, dono ficticio de teste), acao: seguir.\n\n## Pacote Final\n01-capa.html, 02-06 slides internos, 07-cta.html + assets/: 7 pecas na ordem de publicacao.\n\nconfianca: alta\n"
+  },
+  "_comment_aux_files": "SF11.11/ADR-025 DF-SF11.11-6: aux_files sao arquivos NAO-artefato plantados no runDir no despacho da etapa. Os 7 HTML abaixo existem para que a prova 2 EXERCITE o command_check render-png.cjs (que verifica o PRODUTO da etapa em disco, nao o texto do artefato) em vez de ser contornada por ele. A mudanca deste sidecar E A PROVA, nao uma regressao: sem ela o smoke cai para 2/4 com bloqueio por contagem em assembly. Cenario sem aux_files = comportamento byte-identico ao anterior (chave opcional).",
+  "aux_files": {
+    "assembly": {
+      "01-capa.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>01-capa.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>01-capa.html</main></body>\n</html>\n",
+      "02-slide.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>02-slide.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>02-slide.html</main></body>\n</html>\n",
+      "03-slide.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>03-slide.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>03-slide.html</main></body>\n</html>\n",
+      "04-slide.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>04-slide.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>04-slide.html</main></body>\n</html>\n",
+      "05-slide.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>05-slide.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>05-slide.html</main></body>\n</html>\n",
+      "06-slide.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>06-slide.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>06-slide.html</main></body>\n</html>\n",
+      "07-cta.html": "<!doctype html>\n<html lang=\"pt-BR\">\n<head><meta charset=\"utf-8\"><title>07-cta.html</title>\n<style>html,body{width:1080px;height:1350px;margin:0;background:#101820;color:#fff;font-family:sans-serif}</style>\n</head>\n<body><main>07-cta.html</main></body>\n</html>\n"
+    }
+  },
+  "template_violation": "## Prompt da Capa\nComposicao central, paleta azul-eletrico, flat, 4:5.\n\n## Prompt do CTA\nMesma familia visual, fundo sobrio.\n\n## Arquivos Gerados\n- assets/cover-bg.png\n- assets/cta-bg.png\n\nreferencia_copiada: nao\nconfianca: alta\n",
+  "veto_violation": "## Prompt da Capa\nComposicao central, paleta azul-eletrico, flat, 4:5.\n\n## Prompt do CTA\nMesma familia visual, fundo sobrio.\n\n## Arquivos Gerados\n- assets/cover-bg.png\n- assets/cta-bg.png\n\n## Conformidade de Referencia\nComparacao feita.\n\nreferencia_copiada: sim\nconfianca: alta\n"
+}

package/template/pods/content-carousel/workflows/wf-content-carousel.yaml

@@ -0,0 +1,80 @@
+# wf-content-carousel.yaml — gerado por forge-generate.cjs (SF1.4).
+# Contrato: templates/workflow-tmpl.yaml. Validador: scripts/validate-pod-workflow.cjs.
+#
+# GUARDA (Story SF10.18): qualquer mudança em `veto.assertions` (deste arquivo OU do
+# `command_check` que ele referencia) exige rodar, ANTES de commitar:
+#   node scripts/smoke-pod-workflow.cjs pods/content-carousel/workflows/wf-content-carousel.yaml
+# e confirmar 4/4. Motivo (precedente real na instância que originou este pod): dois
+# commits adicionaram vetos ao `wf` sem atualizar o sidecar `.smoke.json` ao lado,
+# derrubando o smoke 4/4 -> 2/4 -> 1/4 sem detecção até a Story SF10.18 fechar a
+# lacuna. Esta é disciplina DOCUMENTADA, não um guard mecânico.
+
+state_machine:
+  states: [init, running, review, complete, failed]
+  initial: init
+  terminal: [complete, failed]
+
+steps:
+  - id: digest
+    agent: hn-curator
+    template: templates/digest-tmpl.md
+    inputs: [brief]
+    outputs: [news-digest]
+    # SF10.1/D2: knowledge citado pela fase (export-readiness). ATENÇÃO (SF11.2 / ADR-021
+    # DF-SF11.2-4): este campo NÃO é mais inerte ao runtime — o motor (pc-run-pod.cjs)
+    # resolve cada entrada em path absoluto, injeta a lista na seção de LEITURA OBRIGATÓRIA
+    # do brief e BLOQUEIA o despacho se algum arquivo não existir
+    # (`leitura_obrigatoria_ausente`). Apontar para arquivo inexistente quebra a etapa.
+    knowledge: [aquisicao-ancora.md, selecao-de-ancora.md]
+    depends_on: []
+    veto:
+      assertions:
+        - { type: count_gte, field: "Angulos para Slides", n: 5, _sources: "Estrutura fixa: 5 slides internos exigem ≥5 ângulos de conteúdo no digest — contagem machine-redutível" }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora squad-forge/hormozi-method); campo de máquina ortogonal fora dos headings (ADR-005 Decisão A)" }
+        - { type: field_matches, field: contrato_entrada, pattern: "^(ancora:hn|roteiro:proprio)$", _sources: "ADR-020 DF-SF10.21-3/-11 + ADR-026 DF-SF11.7-3: âncora de MÁQUINA da entrada parametrizada. O par <modo>:<fonte> declarado no digest tem que ser uma COMBINAÇÃO IMPLEMENTADA — hoje `ancora:hn` (§1 do knowledge) e `roteiro:proprio` (§1b). Alargar de uma para duas alternativas é SUPERSET por construção (nenhum digest antigo passa a falhar) e o sweep do smoke continua derivável (o pattern não é universal). Sem esta assertion, 'a entrada é parâmetro' seria 100% disciplina de agente e inverificável em disco. O QUE ELA PROVA: propriedade do artefato, binária e sem limiar calibrável — declarar entrada fora do conjunto implementado BLOQUEIA a etapa. O QUE ELA NÃO PROVA: PROVENIÊNCIA (que o agente de fato buscou naquela fonte). É declaração AUTO-ATESTADA, mesma honestidade de `referencia_copiada`; o fail-closed que impede o default silencioso vive no agente e em knowledge/aquisicao-ancora.md §0.2, não aqui. NOME load-bearing: NÃO pode ser `fonte` — extractField casa a PRIMEIRA ocorrência no artefato inteiro e a seção `## Noticia` prescreve registrar 'fonte (domínio do artigo)', o que bloquearia todo digest legítimo. Pelo mesmo motivo (ADR-026 DF-SF11.7-17), o bloco `pc:fidelidade-roteiro` do modo `roteiro` é gravado DEPOIS de `confianca:` e `contrato_entrada:`: um trecho citado do roteiro do dono contendo `- confianca: ...` sequestraria o veto se viesse antes. INVARIANTE DE MANUTENÇÃO: este pattern é o espelho do conjunto de seções de aquisição implementadas em knowledge/aquisicao-ancora.md (§1 e §1b), e a MATRIZ de aplicabilidade por modo (§0.3) é o único lugar do pod que o espelha — fonte ou modo novo = 1 seção + 1 linha na matriz + 1 token aqui + sidecar + smoke 4/4. O valor LITERAL do pattern vive aqui e em nenhum outro arquivo do pod." }
+    # SF11.10/ADR-024 — GATE DE TEXTO ANTES DO CUSTO. O roteiro é conferido AQUI, antes de
+    # `visuals` gastar geração de imagem. `skip_modes: ["yolo"]`: o ritmo autônomo NÃO tem
+    # este gate (a etapa vai direto a `done` e o state grava `checkpoint: null`) — pular não
+    # é aprovar; `approve` continua PROIBIDO ao autônomo (ADR-020), e o gate de `assembly`
+    # segue sem `skip_modes`, isto é, bloqueando nos dois ritmos.
+    # POSIÇÃO LOAD-BEARING (ADR-025 DF-SF11.11-9 / OBS-4): `checkpoint` é a ÚLTIMA chave da
+    # etapa. O parser YAML-lite não suporta escalar de bloco e, se alguém trocar o `criteria`
+    # de uma linha física por `criteria: |`, ele descarta o resto EM SILÊNCIO — engolindo a
+    # chave irmã que viesse depois. Com `checkpoint` por último, só o próprio campo se perde,
+    # e o validador (`checkCheckpoint`) o nomeia. Não mova esta chave para cima.
+    checkpoint: { blocking: true, skip_modes: ["yolo"], criteria: "Roteiro conferido ANTES de qualquer imagem ser gerada. (0) QUAL É A SUA PERGUNTA - descubra ANTES de ler o resto: abra o digest e leia o campo `contrato_entrada:` (fora dos headings, no fecho do artefato; quando existe, o bloco `pc:fidelidade-roteiro` vem DEPOIS dele). Se o valor começa com `ancora:`, vale a SEÇÃO A e a SEÇÃO B NÃO se aplica. Se começa com `roteiro:`, vale a SEÇÃO B e a SEÇÃO A NÃO se aplica. Não existe run em que as duas valham; a SEÇÃO C vale nos dois. Se a seção que você leria não bate com a run que VOCÊ pediu, o conformador declarou o modo errado - isso sozinho já é `revise`. || SEÇÃO A - VOCÊ NÃO ESCREVEU ESTE TEXTO (entrada=ancora). (A1) O QUE SE CONFERE: a notícia e os fatos são rastreáveis à fonte declarada (item/URL/data em `## Noticia`, sem número inventado); a síntese explica para quem não é da área, sem jargão; e os >=5 ângulos de `## Angulos para Slides` formam um ARCO NARRATIVO (abertura que prende, desenvolvimento que ensina, fechamento que conclui) e não uma lista de tópicos soltos que repetem a mesma ideia. (A2) CLÁUSULA DA LIÇÃO (mesma régua da subseção `Consequência e conselho` de knowledge/aquisicao-ancora.md): o aprendizado de um case precisa ser um ENSINAMENTO APLICÁVEL - uma lição e um direcionamento. Análise de circunstância não é lição: fechar o raciocínio na causa do episódio explica a notícia e não entrega nada ao leitor. Se nenhum ângulo entrega algo que o leitor possa APLICAR na própria realidade, o roteiro ainda não está pronto. || SEÇÃO B - VOCÊ ESCREVEU ESTE TEXTO (entrada=roteiro). A pergunta aqui NÃO é se o roteiro está bom: você escreveu, você já sabe. A pergunta é uma só - O CONFORMADOR PRESERVOU O QUE VOCÊ ESCREVEU? Leia NESTA ordem. (B1) O bloco `pc:fidelidade-roteiro`, no fim do artefato: confira o cabeçalho de proveniência (`roteiro=` é o SEU arquivo? `sha256=`, `ts=`) e depois as linhas de mapeamento - uma por ângulo, cada uma com o trecho-fonte citado do seu texto, o ângulo produzido e a classe. (B2) PRIMEIRO as linhas de classe `REESCRITO`: são exatamente onde a redação deixou de ser a sua. Cada uma traz o motivo declarado; motivo que não convence é `revise`. `PRESERVADO` e `RECORTADO` você confere por amostragem. (B3) DEPOIS a lista do que NÃO COUBE: é a metade da fidelidade que a contagem de ângulos jamais pega - o que do seu roteiro ficou de FORA. (B4) POR FIM as `observações`: em `entrada=roteiro` o conformador é proibido de corrigir, atualizar, aprofundar, traduzir ou reordenar o seu texto por conta própria - ele OBSERVA e REGISTRA, e quem decide é você, aqui. Lista vazia é resposta legítima, e é diferente de ausente. (B5) O QUE VOCÊ NÃO PRECISA JULGAR AQUI: se o roteiro está bom, se a lição está boa, se o arco fecha - isso é a SEÇÃO A e não é a sua run. (B6) LIMITE HONESTO, dito na cara: NÃO existe veto de máquina sobre fidelidade. Nenhum script conferiu que o trecho-fonte citado existe mesmo no seu arquivo - quem confere é você, agora. Trecho que você não escreveu é citação fabricada: `revise` e diga isso com todas as letras. || SEÇÃO C - VALE NOS DOIS MODOS. (C1) FRONTEIRA HONESTA - o que este gate NÃO cobre: aqui não se aprova a COPY LITERAL de cada peça nem NADA do visual. Copy e objeto gráfico são a mesma decisão e só existem dentro do canvas; eles são julgados no checkpoint de `assembly`, que continua sendo a aprovação final do carrossel. (C2) O QUE CUSTA CORRIGIR AQUI: `revise` nesta etapa devolve SÓ o `digest` a pending e re-despacha o curador - ZERO imagem gerada, zero imagem repaga. Depois de `visuals` o mesmo defeito de roteiro só se conserta com uma run nova do zero. Diga a correção com as suas palavras: ela vira aprendizado do pod e insumo do re-despacho. (C3) JULGAMENTO HUMANO - nunca veto de máquina (fronteira ADR-002)." }
+
+  - id: visuals
+    agent: carousel-visual
+    template: templates/visuals-tmpl.md
+    inputs: [news-digest]
+    outputs: [visual-set]
+    knowledge: [image-generation.md, identidade-visual-mascote.md]  # SF10.1/D2
+    depends_on: [digest]
+    checkpoint: null
+    veto:
+      assertions:
+        - { type: field_matches, field: referencia_copiada, pattern: "^nao$", _sources: "Restrição de direito autoral da necessidade original: a etapa declara explicitamente que a imagem gerada não é cópia/derivação direta da referência; valor fora do pattern bloqueia" }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora)" }
+
+  - id: assembly
+    agent: carousel-builder
+    template: templates/assembly-tmpl.md
+    inputs: [visual-set]
+    outputs: [carousel-package]
+    knowledge: [slides-html.md, cta-brief.md, identidade-visual-mascote.md]  # SF10.1/D2
+    depends_on: [visuals]
+    # GUARDA (SF10.18): este veto tem command_check (lexical-check.cjs, render-png.cjs) — ver
+    # comentário de cabeçalho do arquivo antes de alterar qualquer assertion aqui. O sidecar
+    # `.smoke.json` declara `aux_files.assembly` com 7 HTML mínimos: eles NÃO são resíduo nem
+    # regressão — são o que faz o smoke EXERCITAR o `render-png.cjs` em vez de ficar cego a ele
+    # (SF11.11 / ADR-025 DF-SF11.11-6). Removê-los derruba a prova 2 para bloqueio por contagem.
+    veto:
+      assertions:
+        - { type: count_gte, field: "Slides Internos", n: 5, _sources: "Estrutura fixa capa+5+CTA: ≥5 slides internos listados — contagem machine-redutível" }
+        - { type: field_matches, field: confianca, pattern: "^(alta|media|baixa)$", _sources: "convenção de conformidade do pod (âncora)" }
+        - { type: command_check, command: "lexical-check.cjs", args: ["--max", "0", "--pattern", "[—–]"], _sources: "Guarda de voz (ADR-013 Decisão 3, 1º wiring real do lexical-check.cjs/SF7.2): veto léxico default DERIVADO de voz.lexico_proibido do guia do dono (dono.example.yaml: em-dash U+2014 e en-dash U+2013). Os args são LITERAIS por segurança (ADR-011 proíbe interpolação em command_check) — a derivação é em tempo de AUTORIA: ao editar voz.lexico_proibido na instância, o agente atualiza estes args junto (golden rule de elicitação do carousel-builder)" }
+        - { type: command_check, command: "render-png.cjs", args: ["--html-dir", "..", "--out-dir", "../png", "--width", "1080", "--height", "1350", "--expect", "7"], timeout_ms: 180000, _sources: "O ENTREGÁVEL NASCE ANTES DO GATE. ADR-025 (DF-SF11.11-1 a -4). O QUE ESTE command_check FAZ: renderiza em headless Chrome os 7 HTML da raiz do runDir, grava os PNG em png/, lê o IHDR de cada PNG gerado e exige 1080x1350 EXATOS (igualdade de inteiros, sem limiar - ADR-018 DF4-5), exige EXATAMENTE 7 arquivos, e faz upsert de um bloco no artefato com arquivo, dimensão e sha256. POR QUE AQUI E NÃO DEPOIS DO APPROVE: verifyStep roda em advance ANTES de isBlocking e de awaiting_approval, logo os PNG existem, medidos, no instante em que o dono é convocado - ele aprova o ARQUIVO QUE PUBLICA, não um proxy HTML. Idêntico em interactive e yolo por construção: verifyStep e evalVeto não leem o modo. Zero linha de motor (DF2-1 preservado). O QUE ELE NÃO PROVA: qualidade, encaixe copy x canvas, contraste, overflow - isso é o julgamento humano do checkpoint abaixo (fronteira ADR-002); overflow tem script próprio (render-gate.cjs), dívida 1 do DF-SF11.11-13. LIMITE MEDIDO NA IMPLEMENTAÇÃO: a dimensão do PNG vem do --window-size do Chrome, não do CSS - logo a checagem de dimensão é pós-condição SOBRE O RENDERIZADOR (pega escala dobrada, PNG truncado, binário que sai 0 escrevendo outra coisa: a classe green-fake do chromium-snap), não veto sobre o conteúdo do HTML. SEM ESCAPE HATCH, por decisão de desenho do ADR-025: Chrome ausente ou render falho BLOQUEIA a etapa e a rodada não fecha, nem entregando HTML - a alternativa reintroduziria a degradação silenciosa que a SF11.4b eliminou. Args LITERAIS (ADR-011 proíbe interpolação); o runDir sai do artifactPath pelo invariante runDir/artifacts/step.md. Requer framework com scripts/veto-checks/render-png.cjs blessed; ausente na instalação, capabilityGaps faz o start RECUSAR nomeando o script. Ver docs/mecanismos/veto-entregavel-png.md no repositório do framework." }
+    # POSIÇÃO LOAD-BEARING (ADR-025 DF-SF11.11-9 / OBS-4): `checkpoint` é a ÚLTIMA chave da
+    # etapa — ver a nota equivalente em `digest`. Não mova esta chave para cima.
+    checkpoint: { blocking: true, criteria: "APROVAÇÃO FINAL DO CARROSSEL. (0) O QUE VOCÊ ESTÁ APROVANDO: os 7 arquivos .png em `<runDir>/png/` (01-capa.png a 07-cta.png) - eles são EXATAMENTE o que vai ao Instagram. O HTML é fonte, não entregável; se você aprovar aqui, publica o que viu. Abra os 7. (1) O QUE A MÁQUINA JÁ GARANTIU, NÃO GASTE OLHO NISSO: as 7 peças existem e cada PNG mede 1080x1350 - verificado por `render-png.cjs` ANTES desta pergunta (se você chegou aqui, isso está certo; o bloco `pc:entregavel-png` no artefato lista arquivo, dimensão e sha256). (2) O QUE SÓ O OLHO HUMANO VÊ, e é por isso que este gate existe - defeitos invisíveis no HTML como texto e visíveis só no render: rótulo ou título quebrando em duas linhas; quebra DENTRO de um valor que não deveria quebrar (moeda separada do número, unidade separada da grandeza); parágrafo estourando o número de linhas que a caixa comporta; contraste do texto sobre o background gerado; encaixe copy x canvas peça a peça. Confira também: capa e CTA com background gerado (não cópia da referência); frase de fechamento forte e remissão à autoridade do dono (`knowledge/dono.yaml`) presentes; VOZ DO DONO em julgamento (ADR-013): peça inteira na 1ª pessoa do dono, dono NUNCA citado em 3ª pessoa como fonte externa (citação factual de TERCEIROS continua legítima), tom conforme `voz.tom` do guia. (3) CONFERIR TAMBÉM (ADR-020 DF-SF10.21-4): NENHUMA peça exibe sinal de relevância da plataforma de origem - pontos, upvotes, curtidas, views ou contagem de comentários; esse número é insumo de curadoria do digest e não é conteúdo de roteiro. Não há veto de máquina para essa regra (veto lexical foi avaliado e RECUSADO: é proxy sintático de regra semântica, com falso-positivo legítimo quando o TEMA da notícia é o próprio sinal) - ela é conferida AQUI, por leitura. (4) SE ESTA RODADA PARTIU DE UM ROTEIRO SEU (o `contrato_entrada` do digest começa com `roteiro:`): confira também se a copy das peças ainda SOA COMO VOCÊ ESCREVEU, ou se foi reformulada no caminho. O gate de `digest` cobriu a conformação do seu texto em ângulos; ele NÃO cobriu a passagem de ângulo para copy de slide - esta é a única parada em que isso é visível, e não há bloco de fidelidade aqui para instrumentá-la (ADR-026 DF-SF11.7-23). Em rodada `ancora:` esta cláusula é vacuamente satisfeita: o texto não é seu. JULGAMENTO HUMANO - nunca veto de máquina (fronteira ADR-002); endurecer a cláusula de 3ª pessoa a veto é opt-in via *harden-learning." }

package/template/pods/dev-ia/README.md

@@ -0,0 +1,45 @@
+# Pod Dev-IA — Desenvolvimento de Software com IA
+
+## Propósito
+
+Desenvolver software com IA em ciclo disciplinado: cada story passa por validação antes de codar, implementação rastreável e QA gate independente antes de fechar. O ciclo já existe como skills; este pod é a formalização fina — o mapa de quando usar cada uma.
+
+## O ciclo
+
+```
+SPEC → epic → story → validação → implementação → QA gate independente → fechamento
+```
+
+| Etapa | Skill | O que faz |
+|---|---|---|
+| Validação da story | `validate-story-draft` | Checklist de prontidão; GO/NO-GO antes de qualquer código |
+| Implementação | `develop-story` | Implementa os ACs, atualiza checkboxes e File List |
+| QA gate | `review-story` | Revisão independente; veredito PASS/CONCERNS/FAIL/WAIVED |
+| Correções de QA | `apply-qa-fixes` | Aplica achados do gate e devolve para re-review — nunca se auto-aprova |
+| Fechamento | `close-story` | Bookkeeping final de story já aprovada pelo QA |
+| Commit local | `pc-commit` | Commit convencional local; nunca faz push |
+
+## Princípios comprovados (ciclo de 2026-07-21)
+
+1. **Separação implementador/aprovador.** Quem implementa não se aprova. No ciclo de validação, essa separação pegou um **"fake green" real**: relato de sucesso que os gates re-executados desmentiram.
+2. **Verificação independente re-executa gates.** O revisor roda testes/lint/typecheck de novo em vez de confiar no relato do implementador. Confiança é output de execução, não de prosa.
+3. **Branch guard + push com aprovação humana.** Trabalho em branch própria; push só com aprovação humana explícita — nunca automático no fim do ciclo.
+
+## Referência de validação
+
+- `docs/stories/1.1.story.md` — story completa do ciclo validado (chat-gateway, 2026-07-21).
+- `docs/qa/gates/1.1-esqueleto-auth.yaml` — gate de QA correspondente, com veredito independente registrado.
+
+## Quando usar o quê
+
+- Story pronta para codar → `validate-story-draft` primeiro; só implementa com GO.
+- Gate reprovou → `apply-qa-fixes` e re-review via `review-story`; nunca fechar por cansaço.
+- Bug fix trivial → ciclo curto (implementa → gate), sem burocracia de epic.
+- Schema, RLS, migration ou performance de banco → agente `db-architect` (abaixo).
+| `ux-architect` | Design de fluxo/UI, revisão UX de stories (estados, mobile-first, a11y), design system leve | `*flow` `*review` `*a11y` `*ds` |
+
+## Agentes
+
+| Agente | Job | Conhecimento |
+|---|---|---|
+| `agents/db-architect.md` | Banco de dados PostgreSQL/Supabase: modelagem (`*model`), migrations seguras (`*migrate`), RLS (`*rls`), otimização (`*optimize`), auditoria (`*audit`), operações (`*ops`) | `knowledge/db/` (protocolo de migration, padrões RLS, checklist de schema) + `tools/db-ops/` (13 scripts determinísticos: migration-runner, backup-manager, health-checker, rls-test-suite etc.) |

package/template/pods/dev-ia/agents/db-architect.md

@@ -0,0 +1,33 @@
+---
+name: db-architect
+description: "Arquiteto de banco de dados PostgreSQL/Supabase — schema, RLS, migrations seguras e performance. Use para: modelar domínio e desenhar schema, planejar/aplicar migration com rollback, criar políticas RLS, otimizar queries e índices, auditar schema existente."
+model: sonnet
+budget_tokens: 1200
+---
+
+# db-architect
+
+## Papel
+
+Arquiteto de banco de dados e engenheiro de confiabilidade PostgreSQL/Supabase. Guardião da integridade dos dados: correto antes de rápido, tudo versionado e reversível, segurança por default. Critério de qualidade: nenhuma mudança de schema chega em produção sem dry-run, snapshot e plano de rollback documentado — e nenhuma tabela nova nasce sem justificar por que as existentes não bastam.
+
+## Comandos
+
+| Comando | O que faz | Carrega |
+|---|---|---|
+| `*model` | Modelagem de domínio → schema. Começa pelo gate KISS (reusar > estender > criar; 0 mudanças > 1 campo > 1 tabela); depois entidades, relacionamentos, regras de negócio, access patterns, tipos e índices. Saída: schema documentado + DDL. | `knowledge/db/schema-review-checklist.md` |
+| `*migrate` | Plano e execução de migration segura: fases (verify-order → dry-run → snapshot → apply com advisory lock → smoke-test), padrões zero-downtime (expand/contract, CONCURRENTLY, NOT VALID) e rollback (roll-forward preferido, PITR, manual). | `knowledge/db/migration-protocol.md` |
+| `*rls` | Políticas RLS: escolhe padrão (owner, team, role, public-read, multi-tenant), gera policies com `auth.uid()` embrulhado em SELECT, indexa colunas de policy, testa casos positivo e negativo. | `knowledge/db/rls-patterns.md` |
+| `*optimize` | Análise de queries e índices: hot paths via pg_stat_statements, EXPLAIN (ANALYZE, BUFFERS), recomendação de índices (FKs sempre; parciais; GIN p/ JSONB), tuning de timeouts e pooling. | `tools/db-ops/explain-analyzer.sh` |
+| `*audit` | Auditoria de schema existente: cobertura RLS, constraints, tipos (TIMESTAMPTZ, JSONB, NUMERIC p/ dinheiro), índices ausentes/inúteis, scorecard de best practices. | `knowledge/db/schema-review-checklist.md` + `tools/db-ops/best-practices-auditor.sh` |
+| `*ops` | Operações via scripts determinísticos em `tools/db-ops/`: migration-runner (dry-run/apply/verify-order), backup-manager (snapshot/restore), health-checker, rls-test-suite, rls-policy-installer, query-runner, data-loader, bootstrap-runner, detect-database, schema-context-loader. Ler `--help` de cada um antes de usar. | `tools/db-ops/` |
+
+Antes de qualquer trabalho: resolver conexão via `$SUPABASE_DB_URL` ou `$DATABASE_URL` (nessa ordem) e carregar contexto do schema vivo (`tools/db-ops/schema-context-loader.sh`) — o banco é a fonte da verdade, nunca propor entidade sem saber o que já existe.
+
+## Regras de ouro
+
+- **Nunca CREATE/ALTER/DROP sem plano de rollback documentado** — snapshot antes, roll-forward preparado, instrução de desfazer registrada no plano.
+- **RLS por default em toda tabela exposta a cliente.** Ausência de RLS é decisão explícita e documentada (ex.: tabela operacional service-role-only), nunca esquecimento.
+- **Migrations idempotentes e dry-run antes de aplicar:** `IF NOT EXISTS`/`OR REPLACE`, execução em BEGIN/ROLLBACK primeiro, `ON_ERROR_STOP` sempre, advisory lock contra migrations concorrentes.
+- **Gate KISS antes de criar tabela:** se funciona hoje, mudar exige justificativa extraordinária; 3+ tabelas ou 10+ campos sem dor validada pelo usuário = parar e revalidar.
+- **Credenciais só por env** (`SUPABASE_DB_URL`/`DATABASE_URL`), nunca parseadas com sed/awk, nunca ecoadas; segredos sempre redigidos no output.