@daniellins/power-claude 0.16.3

package/template/pods/content-carousel/knowledge/aquisicao-ancora.md

@@ -0,0 +1,443 @@
+# Aquisição da entrada — contrato de entrada + implementações `ancora`/`hn` (§1) e `roteiro` (§1b)
+
+Procedimento do comando `*digest` do `hn-curator`. A entrada da etapa chega pela linha `Tarefa:` do
+brief (o `task_ref` que o comando `/power:content-carousel` passou ao motor `pc-run-pod.cjs`). O motor é
+transporte CEGO: ele não parseia nem valida esta gramática — quem a lê e a honra é você, agente.
+
+## 0. Contrato de entrada (leia ANTES de qualquer fetch)
+
+### 0.1 Gramática do `task_ref` (ADR-020 `DF-SF10.21-1/-11`)
+
+```
+entrada=ancora fonte=<slug> url=<url-exata> ts=<ISO-8601> -- <nota livre opcional>
+entrada=roteiro roteiro=<path> ts=<ISO-8601> -- <nota livre opcional>
+```
+
+- Pares `chave=valor` separados por espaço; valores não contêm espaço. Parsing: split em espaço +
+  primeiro `=`.
+- `entrada` é **obrigatória em toda run** e é lida PRIMEIRO — ela decide quais outras chaves são
+  obrigatórias e qual seção de aquisição se aplica.
+- Tudo após o primeiro ` -- ` é **nota humana**, ignorada pelo parsing (existe porque o `task_ref`
+  também é o rótulo que o `status` imprime e que fica gravado para sempre no `state.json`).
+
+| `entrada=` | Chaves obrigatórias | Seção de aquisição | Estado |
+|---|---|---|---|
+| `ancora` | `fonte`, `url`, `ts` | §1 (só `fonte=hn` implementada) | IMPLEMENTADO |
+| `roteiro` | `roteiro`, `ts` | §1b (`roteiro:proprio`) | IMPLEMENTADO (ADR-026) |
+
+**O modo decide o seu PAPEL, não só de onde vem o texto.** Em `ancora` você é AUTOR. Em `roteiro` você é
+**CONFORMADOR** (`ADR-020 DF-SF10.21-10`): o texto já é do dono e você o mapeia à forma do pod **sem
+reescrevê-lo** (§1b). A matriz da §0.3 diz, requisito a requisito, o que muda.
+
+### 0.2 Fail-closed — INEGOCIÁVEL, sem default silencioso
+
+**Antes de qualquer fetch, leitura de URL, leitura de arquivo ou produção de texto**, confira a linha
+`Tarefa:` do brief. Em QUALQUER das situações abaixo você **HALTA**:
+
+| Situação | Você HALTA dizendo |
+|---|---|
+| brief sem linha `Tarefa:` | que a run começou sem `task_ref` e a entrada não pode ser inferida |
+| `entrada=` ausente | que falta a chave `entrada`, primeiro discriminador da gramática |
+| `entrada=` com valor fora de `{ancora, roteiro}` | que o modo declarado não existe na gramática |
+| `entrada=ancora` sem `fonte=`, `url=` ou `ts=` | qual chave obrigatória do modo faltou |
+| `entrada=ancora` com `fonte=<slug>` fora de `{hn}` | que **não existe seção de aquisição `<slug>` neste knowledge** — a única fonte implementada do modo `ancora` é a §1 (`hn`) |
+| `entrada=roteiro` sem `roteiro=` ou `ts=` | qual chave obrigatória do modo faltou |
+| `entrada=roteiro` com `roteiro=<path>` que **não abre** (não existe, sem permissão, vazio) | que o roteiro apontado não pôde ser lido, repetindo o path recebido. **É PROIBIDO** reconstruir o roteiro de memória, usar outro arquivo do diretório, ou "aproximar" a partir do que você acha que o dono queria dizer — em `roteiro` o arquivo é a fonte inteira, e sem ele não há nada a conformar |
+
+**HALT significa:** não buscar nada, não ler a URL, **não escrever o artefato**, e devolver no relatório
+(a) o que faltou ou qual seção de aquisição não existe, (b) a linha `Tarefa:` recebida na íntegra, e
+(c) a pergunta ao dono para ele corrigir e reiniciar a run.
+
+**É PROIBIDO** assumir Hacker News, "a fonte mais provável", inferir a fonte pelo host da URL, ou usar
+qualquer outro default. Um fallback silencioso para a única fonte implementada faria toda run
+"funcionar" e tornaria o parâmetro decorativo — é exatamente o que o `DF-SF10.21-1/-2` proíbe, e a
+razão pela qual a etapa bloqueia em vez de adivinhar.
+
+### 0.3 MATRIZ DE APLICABILIDADE POR MODO — ponto único de verdade
+
+A fonte **e o modo de entrada** são PARAMETRIZÁVEIS. O que a etapa `digest` entrega é sempre o mesmo
+(`templates/digest-tmpl.md` + os vetos do workflow); o que muda é **como cada requisito é satisfeito**.
+Esta matriz é o **único** lugar do pod que declara isso, requisito a requisito (`ADR-026 DF-SF11.7-15`).
+
+> **Regra de manutenção, e é ela que impede o buraco de reabrir na 3ª fonte:** toda regra específica de
+> modo vive em **exatamente um** de três lugares — esta matriz (§0.3), a §1 (`ancora`) ou a §1b
+> (`roteiro`). Fora desses três, o texto deste knowledge e do `hn-curator` só contém regra **agnóstica
+> de modo**; quem precisa de uma regra de modo **referencia esta matriz** em vez de reafirmá-la.
+
+| Requisito | `entrada=ancora` (§1) | `entrada=roteiro` (§1b) |
+|---|---|---|
+| **Âncora fixada pelo usuário** | URL exata + timestamp de captura, **nunca escolhida pelo agente** — vale inclusive quando a fonte oferece lista/feed: você não escolhe o item | o **arquivo** de `roteiro=<path>`, fixado pelo dono. Você não troca de arquivo, não procura "uma versão melhor", não completa com outro texto dele |
+| **Fatos rastreáveis** | 3-6 fatos, cada um apontando ao texto-fonte (artigo linkado / item da âncora) | a fonte primária **é o roteiro**. Fato que não está no roteiro NÃO entra. Fontes que o roteiro cita inline são registradas **como o roteiro as cita** — sem URL fabricada e **sem sair para buscar a URL** |
+| **Sinal de relevância** | **OBRIGATÓRIO** no momento do `ts` (pontos/upvotes/curtidas/views/nº de comentários). Ver §0.4 | **N/A, e a ausência é CORRETA**: ensaio autoral não publicado não tem sinal de plataforma. **Não invente substituto** — nem estimativa, nem métrica de outro texto |
+| **Contexto de discussão** | quando a fonte tiver comunidade (objeções, esclarecimentos, ângulos) | **N/A** — não há comunidade nem discussão a ler |
+| **≥5 ângulos** | veto `count_gte` do `wf`; ângulos derivados do artigo + discussão | veto `count_gte` **idêntico**; ângulos **recortados do roteiro**. Se o roteiro não sustenta 5, você **NÃO inventa o quinto** — a etapa bloqueia honestamente e o dono decide (`ADR-020 DF-SF10.21-10`) |
+| **`confianca`** | qualidade da FONTE: artigo primário acessível = `alta`; só título + discussão = `media`; paywalled/incompleta = `baixa` | **rastreabilidade das afirmações do roteiro**, nunca a sua autoconfiança: `alta` = as afirmações centrais têm fonte citada no roteiro; `media` = posição autoral sem citação; `baixa` = o roteiro traz afirmação factual que ele próprio não sustenta |
+| **`contrato_entrada`** | `ancora:hn` | `roteiro:proprio` |
+| **Bloco `pc:fidelidade-roteiro`** | **N/A** — não existe em `ancora` | **OBRIGATÓRIO**, no fecho do artefato. Forma e conteúdo na §1b |
+
+**O valor LITERAL do pattern do veto vive no `wf`** (`pods/content-carousel/workflows/wf-content-carousel.yaml`,
+assertion `contrato_entrada`) **e em nenhum outro arquivo do pod** — esta matriz espelha os PARES
+aceitos, e é a ela que o resto do pod se refere. Copiar o regex para cá, para o agente ou para o
+template recria as 4 cópias divergentes que a `ADR-026 DF-SF11.7-15` eliminou.
+
+#### Guarda-chuva do modo `roteiro` — por CANAL, e vale para regra NOMEADA ou NÃO (`ADR-026 DF-SF11.7-21`/`-25`)
+
+> Em `entrada=roteiro`, qualquer instrução que mande **verificar, atualizar, corrigir, completar,
+> aprofundar, elevar, traduzir, reordenar ou reescrever** o texto — **nomeada nesta matriz ou não** —
+> vale como instrução de **OBSERVAR e REGISTRAR** no bloco `pc:fidelidade-roteiro`. O conformador
+> **nunca** edita por conta própria.
+>
+> **O escopo é por CANAL, não por arquivo.** A cláusula vale para instrução que chegue por **qualquer**
+> um destes: (1) este knowledge; (2) o arquivo do agente `hn-curator`; (3) **a memória consolidada do
+> pod, injetada inline no brief** — inclusive sob o cabeçalho `## Memória consolidada (aplique estas
+> heurísticas)`; (4) o próprio brief.
+>
+> **PRECEDÊNCIA, escrita para não depender de interpretação:** em conflito, **esta cláusula PREVALECE
+> sobre a memória do pod**. Uma heurística consolidada que mande verificar o estado atual do mundo,
+> corrigir um dado, aprofundar um ângulo ou traduzir jargão é, em `roteiro`, **observação e registro** —
+> nunca ação. A memória foi consolidada de rodadas `ancora`, onde o texto era do agente; aqui não é.
+>
+> **Exceção única de MOVIMENTO:** SELECIONAR, CORTAR e compor o TÍTULO de ≤8 palavras (§1b.3), que são a
+> conformação em si. **Única fonte fora do alcance da cláusula:** a linha `Tarefa:`, que é o parâmetro do
+> próprio dono.
+
+É **default seguro**, não lista: regra de ação escrita amanhã — ou heurística consolidada amanhã pela
+memória, automaticamente — já nasce coberta, sem ninguém precisar auditar nada. Limite dito na cara:
+isto é instrução a agente, **sem enforcement de máquina**, e a memória chega **inline e no imperativo**
+enquanto esta cláusula chega por leitura de arquivo — a assimetria de saliência é real e não se resolve
+em texto. O que torna a desobediência verificável depois é o próprio bloco: ângulo alterado sem
+`REESCRITO` (ou sem `observações`) é a assinatura.
+
+**Custo de plugar uma fonte ou um modo novo** (explícito, e é o que mantém o mecanismo honesto): 1 seção
+de aquisição nova aqui + 1 linha nesta matriz + 1 token novo no pattern da assertion `contrato_entrada`
+do `wf` + sidecar `.smoke.json` atualizado + smoke 4/4. Nada de agente novo, arquivo novo ou etapa nova.
+O pattern do veto é o **espelho** do conjunto de seções implementadas neste arquivo — se as duas listas
+divergirem, o mecanismo está quebrado.
+
+Para plugar outra fonte do modo `ancora` (ex.: RSS de um veículo, newsletter, release oficial):
+documente na instância como obter (a) o item pela URL, (b) o artigo/fonte primária, (c) o sinal de
+relevância, (d) a discussão se existir — e siga as seções 2-5 abaixo, que são agnósticas de fonte.
+
+### 0.4 Sinal de relevância: OBRIGATÓRIO aqui, PROIBIDO na peça
+
+Aplicabilidade **por modo: ver a matriz §0.3** — em `entrada=roteiro` este requisito é **N/A** (não há
+plataforma de origem, e inventar substituto é proibido). O que segue descreve o requisito onde ele vale.
+
+Score/upvotes/curtidas/views/contagem de comentários da plataforma de origem são **insumo de
+CURADORIA**: eles decidem se a notícia entra e ficam registrados no digest (§2). Eles **NUNCA** viram
+conteúdo do roteiro — nenhuma peça do carrossel (capa, os 5 slides internos, CTA) exibe esse número.
+A fronteira está declarada aqui, no mesmo lugar em que se manda capturá-lo, é reafirmada como golden
+rule do `hn-curator` e é conferida no `checkpoint.criteria` bloqueante de `assembly`. Quem pode violá-la
+é quem monta a peça (`carousel-visual`, `carousel-builder`) — vale reafirmá-la como golden rule desses
+agentes na sua instância. Não há veto de máquina para esta regra, por decisão consciente
+(`DF-SF10.21-4`): o enforcement é o julgamento humano no checkpoint.
+
+## 1. Seção de aquisição `hn` — `entrada=ancora fonte=hn` (única fonte implementada do modo `ancora`)
+
+O `task_ref` traz a URL exata do item (`https://news.ycombinator.com/item?id=<ID>`) e o timestamp de
+captura. Nunca escolher outra notícia.
+
+1. Extrair o `<ID>` da URL de `url=`.
+2. Buscar o item na API pública do HN (Firebase):
+   `https://hacker-news.firebaseio.com/v0/item/<ID>.json`
+   Campos relevantes: `title`, `url` (artigo linkado), `score`, `descendants` (nº de comentários),
+   `time`, `by`, `kids`.
+3. Se houver `url`, buscar e ler o ARTIGO LINKADO — ele é a fonte primária do conteúdo. O item do HN dá
+   o sinal de relevância (score/comentários); o artigo dá os fatos.
+4. Ler a discussão do HN (página do item ou top `kids` via API) para capturar contexto: objeções
+   técnicas, esclarecimentos do autor, ângulos que a comunidade destacou.
+
+> Não siga URL descoberta DENTRO da fonte como se fosse a âncora: a âncora é a de `url=`, sempre. Links
+> internos servem como material de apoio rastreável, nunca como substituto do item fixado.
+
+## 1b. Seção de aquisição `roteiro` — `entrada=roteiro roteiro=<path>` (ADR-026)
+
+Aqui **o texto já é do dono** e você é **CONFORMADOR**: mapeia o roteiro dele para a forma do pod
+(`templates/digest-tmpl.md`) **preservando a voz e o conteúdo**, e **declara** tudo o que não foi
+preservação pura. A golden rule "nada além da fonte" vale integralmente — aqui a fonte é o arquivo dele.
+
+### 1b.1 Aquisição
+
+1. Ler o arquivo indicado em `roteiro=<path>`, **inteiro**. Se ele não abrir, **HALTE** (§0.2) — não há
+   substituto legítimo.
+2. Calcular o `sha256` do arquivo exatamente como ele está em disco (`shasum -a 256 <path>`, ou
+   `sha256sum <path>`). Ele vai no cabeçalho de proveniência do bloco de fidelidade.
+3. **Não sair do arquivo:** nenhuma busca na web, nenhuma leitura de "arquivo irmão", nenhuma URL
+   seguida — nem para conferir um dado, nem para completar uma citação. Ver §1b.4.
+
+### 1b.2 O que preenche cada seção do template
+
+> **PROIBIDO: citação do dono que COMECE A LINHA com o NOME de `confianca` ou de `contrato_entrada`,
+> em QUALQUER forma que o `extractField` do motor aceite** (`ADR-026 DF-SF11.7-24`) — e ele aceita
+> mais formas do que a mais óbvia: `campo:`, `campo =`, `- campo:`, `**campo**:`, com indentação à
+> esquerda e **em qualquer caixa** (`Confianca:` sequestra igual). Em `roteiro` as três seções acima
+> carregam texto verbatim do dono e vêm **antes** dos dois campos de máquina; `extractField` casa a
+> **primeira** linha do artefato inteiro que bata qualquer uma dessas formas, então uma citação
+> começando por um desses dois nomes sequestra o campo. Se o trecho do dono começar assim, cite-o
+> dentro de célula de tabela ou de item numerado (formas comprovadamente seguras: o regex não aceita
+> `1. `, nem linha iniciada por `|`, nem por aspas), ou prefixe a linha com o rótulo do fato.
+> A direção da falha é **fail-closed EXCETO quando o valor sequestrado pertence ao conjunto aceito,
+> caso em que a etapa passa declarando o modo errado; quem pega isso é o item (0) do `criteria`** do
+> checkpoint de `digest` — que manda o dono conferir se a seção apresentada bate com a run que ELE
+> pediu. Fora desse caso, o valor sequestrado não casa o pattern e a etapa BLOQUEIA: bloqueio confuso,
+> mas bloqueio. Evitar os dois custa esta linha.
+
+- **`## Noticia`** — a "notícia" em `roteiro` é o próprio roteiro. Registre: o **título** do roteiro
+  (como o dono o escreveu), a **proveniência** (`roteiro=<path>`, `sha256=`, `ts=` recebido no
+  `task_ref`), e os **fatos centrais que o roteiro afirma** (3-6), cada um rastreável a um trecho do
+  roteiro. As fontes que o roteiro cita inline entram **como ele as cita** (ex.: se ele escreve o nome
+  de um instituto e um número, é isso que se registra) — **URL fabricada é invenção**, e a matriz §0.3
+  já declara `N/A` para URL de âncora e sinal de relevância. Não preencha esses campos com placeholder
+  inventado: escreva `N/A (modo roteiro)` e siga.
+- **`## Sintese Acessivel`** — montada **com as palavras do dono**. Ver a disposição da §3 abaixo:
+  traduzir jargão é ATO DE REDAÇÃO e, se você o fizer, **declare em `Observações`, com o motivo** — a
+  síntese não tem linha própria no bloco de fidelidade, que é 1:1 com os ângulos (§1b.5).
+- **`## Angulos para Slides`** — os ≥5 ângulos **recortados do roteiro**, na ordem do roteiro (a
+  progressão é a dele, não o arco prescrito da §4). Se o roteiro não sustenta 5 ângulos, **NÃO invente o
+  quinto**: entregue os que existem, registre no bloco que o roteiro não sustenta cinco, e deixe a etapa
+  bloquear no `count_gte`. Bloquear honestamente é o comportamento correto — o dono decide o que fazer.
+
+### 1b.3 Conformar sem reescrever — a regra operacional (`ADR-026 DF-SF11.7-6`)
+
+| Movimento | Permitido? |
+|---|---|
+| **SELECIONAR** qual trecho do roteiro vira ângulo | **Sim** — é a competência da etapa |
+| **CORTAR** (elisão, truncamento) mantendo as palavras do dono | **Sim** — classe `RECORTADO` |
+| **TÍTULO** de ≤8 palavras com redação nova | **Sim**: o título é rótulo de slide, não conteúdo. Quem carrega o texto é a sustentação |
+| **Sustentação** com redação nova | Sim, **mas declarada** — classe `REESCRITO`, com o motivo na mesma linha |
+| **Fundir** dois argumentos do dono num ângulo só | Não sem declarar `REESCRITO` — funde tese, muda sentido |
+| **Acrescentar** fato, número, exemplo ou fonte que o roteiro não tem | **NUNCA.** É a golden rule "nada além da fonte", e aqui a fonte é o roteiro |
+| **Inventar o 5º ângulo** quando o roteiro não o sustenta | **NUNCA** — bloqueia no `count_gte` e o dono decide |
+
+As **4 classes** (conjunto fechado) usadas no bloco de fidelidade:
+
+`PRESERVADO` — a sustentação é o texto do dono, sem alteração.
+`RECORTADO` — só corte/elisão do texto do dono.
+`REESCRITO` — houve reformulação; **obrigatório dizer por quê na mesma linha**.
+`NAO COUBE` — trecho/argumento do roteiro que não virou ângulo nenhum.
+
+### 1b.4 Observar e registrar, nunca agir (`ADR-026 DF-SF11.7-16`)
+
+Em `roteiro`, toda regra deste knowledge que em `ancora` autoriza você a **agir sobre o texto** vira
+instrução de **observar e registrar** — ver a cláusula guarda-chuva da §0.3, que vale para regra nomeada
+ou não. Os três casos mais fáceis de errar, nomeados:
+
+| Você percebeu que… | Em `ancora` você… | Em `roteiro` você… |
+|---|---|---|
+| uma afirmação do roteiro parece **datada** (§2, "Precisão é sobre o estado de HOJE") | verifica contra o estado atual do mundo e **corrige** | **não** consulta o mundo e **não** corrige: escreve `ponto a conferir` em `observações`, com o trecho, e segue |
+| um ângulo **só descreve**, sem consequência (§4, "Aprofundar o ângulo de consequência") | **aprofunda** o ângulo | **não** aprofunda: registra em `observações` que o ângulo N não entrega consequência — o dono decide se `revise` |
+| um ângulo **só informa**, sem conselho acionável (§4, "precisa subir de categoria") | **reescreve** até virar lição | **não** reescreve: registra em `observações` que o ângulo N não entrega conselho |
+
+**Por que registrar em vez de simplesmente ignorar a regra:** suspendê-la perderia sinal — o dono
+deixaria de saber que o roteiro dele tem um dado possivelmente datado ou um ângulo que só informa.
+Registrar preserva o valor editorial da regra **e** a autoria dele.
+
+### 1b.5 O bloco `pc:fidelidade-roteiro` — OBRIGATÓRIO, e é o que instrumenta o gate
+
+Ele é a **última coisa do artefato**, gravado **DEPOIS** de `confianca:` e `contrato_entrada:`.
+
+> **Duas invariantes de posição/forma, ambas load-bearing — quebrar qualquer uma corrompe um veto:**
+> **(1) DEPOIS dos dois campos de máquina** (`ADR-026 DF-SF11.7-17`): o motor casa a **primeira** linha
+> que bate `campo:` no artefato inteiro, aceitando bullet e negrito — um trecho citado do dono contendo
+> `confianca:` sequestraria o veto se o bloco viesse antes.
+> **(2) O bloco ABRE com o heading `## Fidelidade ao Roteiro`**, e é por isso que ele pode conter tabela
+> e listas: o veto `count_gte "Angulos para Slides"` conta itens de lista **até o próximo heading**, e
+> os campos de máquina ficam dentro daquela seção. Sem o heading, cada linha de mapeamento contaria como
+> um ângulo e o veto passaria a ser satisfeito pelo próprio bloco que o audita. O heading é seção EXTRA
+> do artefato (conformidade de template é superset) — o `digest-tmpl.md` **não** muda.
+
+Forma:
+
+```
+confianca: <alta|media|baixa>
+contrato_entrada: roteiro:proprio
+
+## Fidelidade ao Roteiro
+<!-- pc:fidelidade-roteiro:inicio -->
+roteiro=<path exato recebido no task_ref>
+sha256=<do arquivo lido>
+ts=<o do task_ref>
+
+| # | Trecho-fonte (verbatim do roteiro) | Ângulo produzido | Classe |
+|---|---|---|---|
+| 1 | ... | ... | PRESERVADO |
+
+### O que não coube
+<trechos/argumentos do roteiro que não viraram ângulo, um por linha>
+
+### Observações
+<pontos a conferir e ângulos que não entregam conselho; "nenhuma" é resposta legítima>
+<!-- pc:fidelidade-roteiro:fim -->
+```
+
+Regras do bloco:
+
+- **Uma linha de mapeamento por ângulo produzido**, casando 1:1 com `## Angulos para Slides`. Nada mais
+  ganha linha na tabela: o que não é ângulo (a síntese, por exemplo) se declara em `Observações`.
+- **Trecho-fonte é CITAÇÃO VERBATIM e CONTÍGUA** do roteiro: colada do arquivo, sem uma palavra trocada.
+  Precisa elidir? **cite dois trechos separados** (`"…" + "…"`) na mesma linha, cada um contíguo e
+  literal — **nunca** costure os dois com reticências dentro de uma única citação. O motivo é
+  verificabilidade: a única conferência barata que existe sobre esta coluna é procurar o trecho no
+  arquivo do dono (comparação literal, com espaços em branco colapsados), e uma citação costurada não
+  casa com nada. Não parafraseie na coluna de origem: ela existe para o dono conferir que o ângulo saiu
+  do texto dele. Trecho que não existe no arquivo é **citação fabricada**, o defeito mais grave que este
+  bloco pode conter.
+- A célula **Classe** começa pelo TOKEN da classe (`PRESERVADO`, `RECORTADO`, `REESCRITO`, `NAO COUBE`)
+  e só depois, na mesma célula, vem a explicação. Assim a classe é legível por quem confere sem depender
+  de interpretar prosa.
+- Toda linha `REESCRITO` traz **o motivo**, na mesma linha.
+- **O que não coube** é obrigatório: é a metade da fidelidade que a contagem de ângulos não pega.
+- **Observações** é obrigatória como seção; **vazia é valor legítimo** (escreva `nenhuma`) e é diferente
+  de ausente — ausente significa que você não olhou.
+
+### 1b.6 O que NÃO existe em `roteiro`
+
+Sem URL de âncora, sem sinal de relevância, sem discussão de comunidade (matriz §0.3). Declare `N/A
+(modo roteiro)` onde o template pediria esses campos — **nunca** um substituto inventado.
+
+## 2. Registrar os fatos (seção `## Noticia`) — agnóstica de fonte, aplicabilidade na matriz §0.3
+
+O QUE entra aqui depende do modo — a matriz da §0.3 é quem diz, requisito a requisito; em `roteiro`, a
+§1b.2 detalha. Os itens abaixo descrevem o modo `ancora`; os campos marcados `N/A` na matriz **não são
+substituídos por invenção** em `roteiro`.
+
+- Título original, fonte (domínio do artigo), URL do item da âncora e URL do artigo — **`ancora`**; em
+  `roteiro`, título do roteiro + proveniência (`roteiro=`/`sha256=`/`ts=`), sem URL fabricada.
+- Sinal de relevância NO MOMENTO do timestamp fornecido (evidência de "viral e atual") — **`ancora`**;
+  **N/A em `roteiro`** (§0.3).
+- Timestamp de captura fornecido pelo usuário — nos dois modos (é o `ts=` do `task_ref`).
+- 3-6 fatos centrais do artigo, cada um rastreável ao texto-fonte. Fato sem fonte não entra. Em
+  `roteiro`, "o texto-fonte" é o roteiro do dono, e **fato que não está nele não entra**.
+
+### Fato crítico não pode faltar (checagem final obrigatória)
+
+Omitir fato crítico é falha editorial GRAVE. O resumo pode cortar detalhe acessório; NUNCA um fato que
+altera a decisão ou a ação do leitor (ex.: produto em preview fechado = não dá para usar hoje). Antes de
+fechar a seção, responder explicitamente: **que fato da fonte, se omitido, faria o leitor agir errado?**
+Esse fato ENTRA.
+
+> Vale **nos dois modos** e sem mudança: esta regra age sobre a SELEÇÃO, não sobre o texto. Em `roteiro`
+> ela impede que o recorte perca um fato crítico **do próprio roteiro do dono**.
+
+### Precisão é sobre o estado de HOJE
+
+Precisão factual é inegociável e um único erro derruba a peça inteira. Toda afirmação que depende do
+estado do mundo é verificada contra o estado ATUAL no momento da captura, nunca contra conhecimento
+parado no tempo (ex.: a situação de bolsa de uma empresa muda). O mesmo vale para o ESCOPO de
+ferramentas: onde algo roda ou funciona reflete o que é verdade hoje, não o que era verdade no
+lançamento. Escopo desatualizado é erro editorial.
+
+> **Em `entrada=roteiro` esta regra manda OBSERVAR, não agir** (§1b.4 e guarda-chuva da §0.3): você
+> **não** consulta o mundo e **não** corrige o texto do dono. Se uma afirmação parecer datada, escreva
+> `ponto a conferir` em `observações`, com o trecho, e siga. Corrigir aqui seria exatamente o que o gate
+> de fidelidade existe para impedir.
+
+## 3. Síntese acessível (seção `## Sintese Acessivel`) — agnóstica de fonte
+
+Explicar a notícia para quem não é da área, em 1-2 parágrafos:
+- O que aconteceu, por que importa, para quem importa.
+- Jargão traduzido em linguagem comum (ex.: "rate limit" → "limite de uso"), sem perder a precisão do
+  que de fato ocorreu.
+- Proibido opinar além do que a fonte e a discussão sustentam.
+- Lembrete da REGRA DE AUDIÊNCIA (regra de ouro do `hn-curator`, detalhada na §4): o leitor do carrossel
+  não é o leitor da fonte técnica; a fonte de nicho nunca protagoniza a narrativa.
+
+> **Em `entrada=roteiro`:** a síntese é montada **com as palavras do dono**. Traduzir jargão é **ato de
+> redação** — se você traduzir, **declare em `Observações`, com o motivo** (a síntese não tem linha
+> própria no bloco de fidelidade, §1b.5). Preferência: preservar a formulação dele e registrar o jargão
+> como ponto a conferir. Vale a guarda-chuva da §0.3.
+
+## 4. Ângulos para os slides (seção `## Angulos para Slides`) — agnóstica de fonte
+
+Listar **≥5 ângulos** (um por slide interno), em progressão narrativa:
+
+1. **Gancho/contexto** — por que essa notícia está explodindo agora.
+2. **O que aconteceu** — o fato central, direto.
+3. **Como funciona / o detalhe técnico** — o mecanismo explicado de forma simples.
+4. **Por que importa** — impacto prático para o leitor.
+5. **E agora?** — desdobramento, reação da comunidade ou takeaway.
+
+> **Em `entrada=roteiro` a progressão é a DO ROTEIRO.** Reordenar ou reenquadrar o ensaio do dono para
+> caber neste arco de notícia é agir sobre a estrutura dele: **não faça**. Siga a ordem em que ele
+> escreveu; se a ordem dele não bate com este arco, isso é `observações`, não correção. Guarda-chuva §0.3.
+
+Cada ângulo: título curto (≤8 palavras) + 1-2 frases de sustentação com o fato-fonte. A lista alimenta
+diretamente o `carousel-builder` (um ângulo por slide). Em `roteiro`, compor o TÍTULO é movimento
+autorizado (§1b.3); a **sustentação** é onde o texto do dono tem de sobreviver.
+
+### Audiência: o leitor do carrossel não é o leitor da fonte técnica
+
+Os ângulos são escolhidos para o leitor do carrossel, não para a comunidade da fonte. O conteúdo se
+sustenta pelo valor que entrega a esse leitor: o Hacker News, ou qualquer fonte técnica de nicho, só
+aparece quando há ganho REAL para ele, e sempre de forma SECUNDÁRIA (rodapé da peça) — nunca como
+protagonista do ângulo. Corolário direto (§0.4): o sinal de relevância da plataforma NUNCA vira ângulo.
+
+### A visão do autor é OBRIGATÓRIA no ângulo
+
+O leitor precisa sair sabendo o que o AUTOR pensa da notícia. O conjunto de ângulos carrega,
+explicitamente, a leitura da autoridade técnica do dono da instância: qual a consequência da notícia e
+por que ela importa na avaliação dele. Aprofundar o ângulo de consequência (item 5) em vez de parar no
+relato do fato — ângulo que só descreve o que aconteceu está incompleto.
+
+> **Em `entrada=roteiro` esta regra manda OBSERVAR, não agir** (§1b.4): a visão do autor já está no
+> roteiro — é dele o texto. **Acrescentar** visão que o roteiro não tem é invenção, e **aprofundar** um
+> ângulo é reescrever o dono. Se um ângulo só descreve, registre isso em `observações` e siga; quem
+> decide se vale um `revise` é o dono, no gate. Guarda-chuva §0.3.
+
+**Fronteira com a seção 3:** a `## Sintese Acessivel` permanece factual (proibido opinar além do que a
+fonte e a discussão sustentam) — é ali que a precisão é medida. A visão do autor entra AQUI, nos
+ângulos, ancorada nos fatos já registrados na seção 2. Uma seção diz o que aconteceu; a outra, o que o
+autor pensa disso.
+
+### Consequência e conselho: ângulo que só explica não ensina
+
+A subseção acima garante que o leitor saiba o que o autor PENSA. Esta garante o que ele LEVA. Quem lê o
+carrossel decide algo na própria realidade a partir do tema, então o conjunto de ângulos entrega duas
+camadas além do fato:
+
+- **Consequência** — o que este fato passa a significar na operação de quem lê. Não é a causa do que
+  aconteceu na história contada; é o que ela obriga a considerar em qualquer contexto parecido com o do
+  leitor.
+- **Conselho** — o que essa pessoa faz diferente por causa disso. Concreto o bastante para virar ação:
+  uma decisão a tomar antes, uma trava a colocar, uma pergunta a fazer antes de aprovar.
+
+**Explicação causal NÃO é ensinamento.** Fechar o raciocínio na causa do episódio ("o prazo apertado
+produziu a fraude") explica a notícia e não entrega nada: o leitor sai com uma providência estreita e
+falsa ("então é só não dar prazo apertado"). A lição vive uma camada acima do episódio, na categoria de
+decisão que ele expõe — que meta foi dada, que métrica foi escolhida, onde faltou ponto de controle
+humano —, porque a categoria se repete na realidade do leitor e o episódio não.
+
+**Teste obrigatório antes de fechar a lista, ângulo a ângulo:** *o que o leitor vai concluir que deve
+fazer depois de ler isto?* Se a resposta provável só evita a repetição literal do caso, o ângulo está
+preso ao episódio e precisa subir de categoria. E: *agindo exatamente pelo que o ângulo diz, ele fica
+mais protegido ou só mais informado?* Ângulo que só informa está incompleto.
+
+> **Em `entrada=roteiro` o teste continua, mas o que ele produz muda: OBSERVAÇÃO, nunca reescrita**
+> (§1b.4). Você faz as duas perguntas ângulo a ângulo e, onde a resposta for "só informa", **registra em
+> `observações`** que o ângulo N não entrega conselho. **Não** o faz subir de categoria, **não** o
+> reescreve: o texto é do dono e o gate de fidelidade existe justamente para ele decidir isso. E vale o
+> inverso também: o `criteria` do gate manda o dono, em `roteiro`, NÃO julgar se a lição está boa — essa
+> pergunta é da SEÇÃO A, do modo `ancora`. Guarda-chuva §0.3.
+
+O ângulo 5 (`E agora?`) é onde isso fecha: consolida a lição e entrega o direcionamento, em vez de
+repetir o desfecho do fato.
+
+_Forma emprestada das camadas Consequence e Counsel do framework 5 Cs (Context, Comparison,
+Consequence, Case, Counsel) da skill `ai-content-miner`; a formulação acima é do pod._
+
+## 5. Fechamento — os dois campos de máquina
+
+Fora dos headings (convenção ADR-005 Decisão A), no fim do artefato:
+
+- `confianca: alta|media|baixa` — **a régua é por modo: ver a matriz §0.3.** Em `ancora`, é a qualidade
+  da fonte (artigo primário acessível = alta; só título + discussão = media; fonte paywalled/incompleta
+  = baixa, registrando a limitação). Em `roteiro`, é a **rastreabilidade das afirmações do roteiro** —
+  nunca a sua autoconfiança como conformador.
+- `contrato_entrada: <modo>:<fonte>` — o par que esta run de fato usou. Os pares aceitos estão na matriz
+  §0.3 (`ancora:hn`, `roteiro:proprio`); o **valor literal do pattern** vive só no `wf`, e qualquer valor
+  fora do conjunto BLOQUEIA a etapa. Declare o par que você realmente executou — se você teve que
+  HALTar, não há artefato para declarar.
+
+Em `entrada=roteiro`, e **só nele**, o bloco `pc:fidelidade-roteiro` vem **depois** destes dois campos,
+sob o heading `## Fidelidade ao Roteiro` — forma, conteúdo e as duas invariantes de posição estão na
+§1b.5. Invertê-la sequestra o veto `field_matches` ou o `count_gte`.

package/template/pods/content-carousel/knowledge/cta-brief.md

@@ -0,0 +1,25 @@
+# Slide CTA — composição e remissão de autoridade
+
+Procedimento do comando `*assemble` do `carousel-builder` (parte 2: peça `07-cta.html`). O CTA fecha o carrossel e SEMPRE tem os 3 elementos abaixo — faltou um, o slide não está pronto.
+
+## 1. Background
+
+- `assets/cta-bg.png` do `visual-set` (imagem GERADA, mesma família visual da capa — nunca a referência do Pinterest).
+- Overlay escurecido o suficiente para a frase dominar a tela (contraste AA no mínimo).
+
+## 2. Frase forte de fechamento
+
+- UMA frase, ≤14 palavras, tipografia dominante (≥64 px), centrada visualmente.
+- Deriva do takeaway da notícia (último ângulo do digest) — fecha o raciocínio do carrossel, não introduz assunto novo.
+- Formas que funcionam: provocação ("Enquanto você lê isso, X já mudou."), consequência direta ("Quem entende isso hoje sai na frente."), síntese afiada do fato. Sem clickbait vazio: a frase precisa ser sustentada pelo conteúdo dos slides.
+
+## 3. Remissão à autoridade técnica — o dono da instância (`knowledge/dono.yaml`)
+
+- Bloco de assinatura: **nome do dono** + **handle**, ambos de `knowledge/dono.yaml`, hierarquia menor que a frase de fechamento.
+- Enquadramento factual de autoridade técnica: a linha `autoridade` de `knowledge/dono.yaml` — uma linha curta posicionando o dono como referência técnica no tema, sem persona, sem promessa que o conteúdo não sustente.
+- Ação pedida explícita (uma só): a `acao_padrao_cta` de `knowledge/dono.yaml` (seguir o handle / salvar o post / compartilhar / comentar {PALAVRA}) — ajustável por rodada se outra ação for mais coerente com a notícia, sempre UMA ação.
+- Voz conforme `dono.yaml` (`voz`): o carrossel É do dono — nunca citá-lo em 3ª pessoa como fonte externa.
+
+## Registro no `carousel-package`
+
+Na seção `## Slide CTA` do template de assembly: path do arquivo, frase de fechamento usada, ação pedida, e confirmação dos 3 elementos presentes.

package/template/pods/content-carousel/knowledge/dono.example.yaml

@@ -0,0 +1,45 @@
+# dono.example.yaml — forma declarada da configuração de dono da instância (ADR-010 + ADR-013).
+# O template NUNCA distribui dado pessoal real: este arquivo é o placeholder.
+# pc:placeholder   <- SENTINELA (ADR-027): enquanto esta marca existir, o arquivo
+#                     ainda NÃO foi personalizado. Apague-a ao preencher de verdade.
+#                     É ela que o oráculo de contenção do framework exige de todo
+#                     arquivo da camada do dono que entra no pacote, e é ela
+#                     que o agente consulta em vez de diffar contra este exemplo — um
+#                     diff quebra em silêncio assim que o usuário edita um campo só.
+# Na instância: copie para `knowledge/dono.yaml` e preencha. Se `dono.yaml` estiver
+# ausente ou ainda igual a este placeholder, o agente (hn-curator/carousel-builder)
+# ELICITA os dados na 1ª ativação e persiste — a instalação é não-interativa.
+#
+# RETROCOMPAT (ADR-013 Decisão 2): instâncias antigas com o campo escalar
+# `voz: "primeira pessoa"` continuam válidas — o agente interpreta o escalar como
+# `voz.pessoa: "primeira"` com os defaults abaixo, e oferece o upgrade na ativação.
+dono:
+  nome: "<Nome do Dono>"        # quem assina o CTA (nome civil ou de marca)
+  handle: "<@handle>"           # handle do perfil onde o carrossel é publicado
+  autoridade: "<uma linha factual de enquadramento de autoridade técnica, sem persona nem promessa que o conteúdo não sustente>"
+  acao_padrao_cta: "seguir"     # ação única default do CTA: seguir | salvar | compartilhar | comentar {PALAVRA}
+  # Guia de estilo do dono (ADR-013) — degrau intermediário da escada de voz
+  # (sem voz / GUIA DE ESTILO / DNA completo do dono). Machine-readable:
+  # `voz.lexico_proibido` alimenta o veto léxico do workflow (lexical-check.cjs)
+  # e é o campo que `*harden-learning` lê para promover regra léxica nova.
+  #
+  # (a) DEGRAU MAIS ALTO MANDA (ADR-027, DF-SF12.1-13). Se existir
+  #     `knowledge/voice-dna/voice-dna.yaml` (degrau 3), os campos de voz abaixo
+  #     NÃO são autorados aqui em paralelo: ou ficam AUSENTES, ou carregam
+  #     `derived_from: knowledge/voice-dna/voice-dna.yaml`. Dois lares autorados
+  #     para o mesmo eixo é como uma configuração começa a mentir — o degrau mais
+  #     alto presente é o lar autorado da voz.
+  #
+  # (b) `lexico_proibido` é PARÂMETRO DE MECANISMO (classe P), não preferência
+  #     solta: o valor default NÃO é neutro nem vazio — é o PISO DO FRAMEWORK.
+  #     `["—", "–"]` não é gosto de ninguém, é o achado R5/SF7.2 sobre o "tell" de
+  #     IA, um fato do framework que calhou de morar num campo do dono.
+  #     SUBIR (acrescentar tokens) é livre. DESCER abaixo do piso — remover "—" ou
+  #     "–" — é ato explícito e ATRIBUÍDO (mesmo padrão de `memoryCost.acceptedBy`),
+  #     nunca efeito colateral de reset, de cópia deste placeholder ou de "voltar ao
+  #     default". Os `args` literais de `lexical-check.cjs` no `wf-*.yaml` são cópia
+  #     DERIVADA deste campo: mudou aqui, atualiza lá na mesma edição.
+  voz:
+    pessoa: "primeira"          # o dono é o AUTOR; NUNCA citado em 3ª pessoa como fonte externa (defeito R2 do benchmark)
+    lexico_proibido: ["—", "–"]  # PISO do framework (classe P) — subir é livre, descer exige atribuição explícita
+    tom: "<uma linha: registro e energia da voz do dono, ex.: direto, técnico sem jargão, sem hype>"

package/template/pods/content-carousel/knowledge/identidade-visual-mascote.md

@@ -0,0 +1,62 @@
+# Identidade visual e mascote — mecanismo validado em campo
+
+> Fonte: teste empírico de mascote do benchmark 4-braços (2026-07-28, 7 chamadas ≈ US$0,48
+> no total; hipótese confirmada) — registrado no repositório do experimento
+> (`teste-mascote/spec-personagem.md` e `transcripts/teste-mascote-A4.md`, fora deste template).
+> Este documento é o mecanismo que o pod aplica sempre que uma peça pede mascote/personagem
+> de identidade.
+
+## Heurística de ferramenta (regra dura)
+
+- **Identidade/mascote/personagem = ILUSTRAÇÃO GERADA pelo modelo de imagem. NUNCA SVG
+  desenhado por código.** O SVG-por-código produziu mascote com acabamento amador nas rodadas
+  do benchmark (reprovado pelo dono: "desenho de criança"); o teste provou que era limitação
+  de FERRAMENTA, não de capacidade — com o método abaixo, o mascote chegou a acabamento de
+  ilustrador em 3 iterações (≈US$0,21).
+- **SVG só para grafismo geométrico:** molduras, setas, ícones de traço, caixinhas, divisores
+  — nunca para personagem com apelo.
+
+## O mecanismo (5 passos, na ordem)
+
+1. **Doutrina de design antes da spec.** Princípios publicados de character design guiam cada
+   decisão: silhueta legível (teste do preto chapado — Preston Blair), shape language (formas
+   = personalidade — Tom Bancroft), appeal (Thomas & Johnston), paleta limitada (2-3 corpo +
+   1 acento), expressividade concentrada no rosto, escalabilidade (48px→500px), UMA âncora de
+   identidade (acessório memorável), material/luz consistentes.
+2. **Spec de personagem detalhada, projetada princípio a princípio.** Arquétipo, proporções
+   (ex.: chibi ~2,2 cabeças, cabeça ~60% da altura), material/textura/luz, cores com hex,
+   rosto, âncoras de identidade, pose, alvo de render ("ilustração profissional de mascote de
+   marca"), fundo chroma verde #00B140 SEM sombra, e a lista anti-cópia explícita. A spec é o
+   documento-âncora de TODAS as gerações do personagem.
+3. **Character sheet de 6-8 poses em UMA chamada + recorte local.** Pedir a grade de poses
+   sobre chroma; recortar localmente por célula (chroma key por dominância de verde + despill
+   `g→max(r,b)` + crop na bbox do alpha com margem) → um PNG com alpha real por pose. O MESMO
+   arquivo é reutilizado nos slides — consistência por reuso de asset, não por re-geração.
+4. **Peças-herói (capa/CTA) com personagem EM CENA, spec como âncora.** Para as peças de
+   maior impacto, gerar o personagem integrado à cena (sombra de contato, luz da cena) com a
+   spec embutida no prompt: integração claramente superior ao sticker rígido. Nas peças
+   internas, usar as poses do sheet.
+5. **Crítica de acabamento com iteração.** Pergunta-régua a cada geração: **"parece feito por
+   ilustrador contratado?"** Reprovar parcial com ajuste de spec (não de prompt solto) e
+   regenerar; limite de iterações definido antes (o teste usou máx. 5, aprovou na 3ª). Blob no
+   lugar de forma, proporção fora da spec, membro escondido, composição desperdiçando
+   resolução = reprova.
+
+## Nota honesta: deriva de microdetalhe entre chamadas
+
+Em gerações separadas (cenas diferentes), a IDENTIDADE se mantém (silhueta, paleta, rosto,
+âncoras), mas microdetalhes variam — no teste, o crachá-faísca rendeu quase como cruz numa
+cena e os parafusos laterais viraram pinos. **A spec embutida é âncora suficiente para
+identidade, não para microdetalhe.** Mitigação: tudo que puder vir de UMA geração única vem
+dela (o character sheet); gerações em cena ficam restritas às peças-herói, e a crítica do
+passo 5 decide se a deriva é aceitável.
+
+## Economia de chamadas
+
+- **Rascunho pré-API:** validar composição/conteúdo dos visuais em rascunho local (HTML/wire
+  ou descrição aprovada) ANTES da chamada efetiva — chamada de imagem só depois do rascunho
+  validado (sugestão do dono pós-R5, caso motivador registrado).
+- **Imagem composta + recorte:** uma chamada que rende vários assets (o character sheet é o
+  caso provado: 8 poses por ~US$0,07) supera N chamadas avulsas em custo E consistência;
+  recorte é sempre local (PIL/chroma key), nunca nova chamada.
+- Referências de custo do teste: 3 iterações de mascote ≈ US$0,21; sheet + 3 cenas ≈ US$0,27.