Impl: Guardrail P6-M895 — plano de intenção registra os dados literais da decisão

Status: aprovado Atualizado em: 2026-08-25 Issue: #895 Intenção: docs/plans/entrega-engenharia-p6.md Appetite restante: herdado (~0,5 dia eng, docs-only)

Leitura da intenção

Outcome: todo plano de intenção que registra uma decisão de DADOS grava os valores literais (IDs, nomes de modelo, envs, tabelas de threshold) — nunca só narrativa. O GATE de planos ganha um prompt que cobra isso.
O que NÃO negociar: classe 6 declarada judgment-only — sem detector determinístico; nada de código/teste; não fingir que doc é guarda.
O que reavaliar: pontos de aterrissagem exatos no skill (template vs SKILL.md).

Abordagem recomendada

Opções: A (só template) | B (só checklist do gate) | C (ambos) Recomendação: C. O miss tem dois lados: o escritor omitiu os IDs E o gate aprovou sem eles. Rejeitadas: A (gate cego — repete a falha onde ela escapou); B (escritores sem instrução não produzem o dado).

Componentes / mudanças

.agents/skills/plan-issue/intention-template.md: novo bloco "Dados da decisão (literais)" — tabela/lista verbatim de valores a aplicar (flag→ID, lista de modelos, strings exatas, envs). Presente SEMPRE que a intenção fixa valores de dados; "N/A" explícito quando não houver.
.agents/skills/plan-issue/SKILL.md: Checklist e Passo 4 (GATE) ganham o prompt "decisão de dados → valores literais presentes no plano?".
docs/GUARDRAILS.md: linha na tabela Ativos — origem #895, classe 6 (judgment-only declarada), mecanismo bloco "Dados da decisão (literais)" + prompt no gate.
docs/changelog/2026-08-25-audit-pass6-m895.md: entrada append-only.
Migration / Access / UI: sem migration, sem access, sem UI.

Fases verificáveis

Template — bloco + exemplo concreto do próprio miss (OPS95: tabela flag→ID do mapa).
Gate — prompt no Checklist/Passo 4 do SKILL.md.
Ledger + changelog — linha em GUARDRAILS.md; changelog append-only.
Gates — pnpm gate:fast + docs-guards; push via pnpm push.

Rabbit holes / Não escopo

Não inventar detector de "prosa sem dados" (infalsificável; viola classe 6).
Não varrer docs/plans/ retroativamente; não estender aos planos -impl; não reestruturar GUARDRAILS.md além da linha nova.

Riscos e mitigação

Convenção vira "bloco de cortesia": o prompt fica no GATE humano (Passo 4), não em automação; exemplo do miss nomeado.
Docs-only: changelog append-only em arquivo novo; nunca editar HISTORY/agregado.

Aceite de engenharia

intention-template.md com o bloco + exemplo #895 + regra N/A explícita
SKILL.md gate cobra os literais
GUARDRAILS.md linha classe 6 declarada, origem #895
Changelog append-only; pnpm gate:fast verde
Zero código/teste/migration — delta de comportamento nulo

Self-score decision-quality: 5.0 ≥ 4

2.9 KiB Raw Permalink Blame History