agent-quality-police 0.2.12 → 0.3.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-quality-police",
-  "version": "0.2.12",
+  "version": "0.3.0",
   "description": "Strict governance framework for coding agents that blocks testing and typing bypasses.",
   "author": {
     "name": "Davy Massoneto",
@@ -17,6 +17,6 @@
     "tdd",
     "typescript"
   ],
-  "skills": "./.claude/skills",
-  "agents": "./.claude/agents"
+  "skills": "./skills",
+  "agents": "./agents"
 }

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-quality-police",
-  "version": "0.2.12",
+  "version": "0.3.0",
   "description": "Strict governance framework for coding agents that blocks testing and typing bypasses.",
   "author": {
     "name": "Davy Massoneto",
@@ -17,7 +17,7 @@
     "tdd",
     "typescript"
   ],
-  "skills": "./.agents/skills",
+  "skills": "./skills",
   "interface": {
     "displayName": "Agent Quality Police",
     "shortDescription": "Strict governance for coding agents",

package/AGENTS.md

@@ -1,51 +1,51 @@
 # AGENTS.md
 
-## Priority
-
-- Direct system, developer, and user instructions override this file.
-- [`docs/policy/quality-definition.md`](docs/policy/quality-definition.md) is the canonical definition of quality in this repository.
-- If any skill, rule, example, or agent prompt contradicts the quality definition, the quality definition wins.
-- Generated projections must not become the source of truth.
-
-## Startup Sequence
-
-1. Read [quality-definition](docs/policy/quality-definition.md).
-2. Read [workflow](docs/policy/workflow.md).
-3. Load the smallest relevant skill set from `.claude/skills/`.
-4. Execute with TDD when tests are viable.
-5. Run the matching audit agents before final approval.
-
-## Skill Routing
-
-- Use [quality-index](.claude/skills/quality-index/SKILL.md) first when the task spans multiple concerns.
-- Use [typescript-zero-bypass](.claude/skills/typescript-zero-bypass/SKILL.md) for any `.ts` or `.tsx` change.
-- Use [vite-vitest-tdd](.claude/skills/vite-vitest-tdd/SKILL.md) when working with Vite, Vitest, or unit/component TDD.
-- Use [react-public-api-testing](.claude/skills/react-public-api-testing/SKILL.md) for React component behavior tests.
-- Use [anti-bypass-audit](.claude/skills/anti-bypass-audit/SKILL.md) when reviewing diffs, suspicious helpers, or weakened configs.
-- Use [refactoring-with-safety](.claude/skills/refactoring-with-safety/SKILL.md) for refactors that are not pure bug fixes.
-- Use [governance-installation](.claude/skills/governance-installation/SKILL.md) when installing or updating this framework in another repository.
-
-## Quality Rules
-
-- TDD is mandatory when tests are technically viable.
-- A passing test suite without behavior proof is not a green build.
-- `any`, type assertions, non-null assertions, ts-comment bypasses, and lint/config weakening are automatic failures.
-- `Map` in public or domain-facing contracts is suspicious by default and must be treated as a modeling bypass unless a stronger repository rule explicitly allows it.
-- Helpers, factories, mocks, branches, or narrowing added only to silence the type system or to make tests easier are automatic failures.
-- Zod is allowed only at external input boundaries.
-- Joi is allowed only for environment validation when it is genuinely needed.
-- Strong named types are required.
-- Inline structural types are prohibited.
-- Reviewers must reject suspicious diffs instead of “accepting with caveats.”
-
-## Review Flow
-
-- Fix the root problem, not the symptom.
-- Keep tests direct, short, and behavior-based.
-- Prefer explicit domain names over generic utilities.
-- Keep policy text severe and actionable; do not soften language to preserve agent comfort.
-- After any change to canonical framework sources such as `framework/skills/`, `framework/rules/`, `docs/policy/`, or `framework/agents/specs/`, run `python3 scripts/build_framework.py` before claiming the repository is consistent.
-- After the build step, run `python3 scripts/validate_framework.py`. If scripts changed, run `python3 -m unittest tests/test_framework_tools.py` and `node --test tests/node/install.test.mjs`.
-- Use `bypass-auditor` for typing, config, mocks, helpers, or suspicious diffs.
-- Use `tdd-warden` when behavior or tests changed or should have changed.
-- Use `pr-gatekeeper` only for final approve-or-reject review.
+## Prioridade
+
+- Instruções diretas de sistema, desenvolvedor e usuário sobrepõem este arquivo.
+- Prefira código local atual e documentação oficial atual sobre memória.
+- Dados de treinamento não são fonte de verdade; verifique cada afirmação não trivial com ferramenta ou cite a instrução literal do usuário.
+- Trate as skills e auditores exigidos neste arquivo como requisitos de workflow obrigatórios.
+
+## Sequência de Inicialização
+
+1. Confirme literalmente o pedido do usuário; se ambíguo, pergunte antes de começar.
+2. Leia [quality-definition](docs/policy/quality-definition.md) quando a tarefa precisar de contexto de política do repositório.
+3. Leia [workflow](docs/policy/workflow.md) quando o repositório definir um.
+4. Carregue o menor conjunto de skills exigido a partir de `skills/` antes de propor edits ou escrever código.
+
+## Roteamento de Skills
+
+- Use [grounding-first](skills/grounding-first/SKILL.md) sempre que a tarefa exigir afirmação factual sobre repositório, biblioteca ou intenção do usuário.
+- Use [quality-index](skills/quality-index/SKILL.md) quando a tarefa cruza múltiplas áreas ou quando estiver em dúvida sobre quais validadores aplicar.
+- Use [typescript-zero-bypass](skills/typescript-zero-bypass/SKILL.md) para mudanças em `.ts` ou `.tsx`.
+- Use [vite-vitest-tdd](skills/vite-vitest-tdd/SKILL.md) para TDD em Vite ou Vitest.
+- Use [react-public-api-testing](skills/react-public-api-testing/SKILL.md) para testes de comportamento em React.
+- Use [anti-bypass-audit](skills/anti-bypass-audit/SKILL.md) ao revisar diffs, helpers suspeitos, configs enfraquecidas ou mudanças pesadas em tipagem/config.
+- Use [refactoring-with-safety](skills/refactoring-with-safety/SKILL.md) para refactors que não são bug fix puro.
+- Use [governance-installation](skills/governance-installation/SKILL.md) ao instalar ou atualizar este pacote de governança.
+
+## Regras de Qualidade
+
+- Carregue as skills exigidas antes de propor edits ou escrever código.
+- Se uma skill exigida não estiver disponível no runtime atual, pare e reporte `BLOCKED`.
+- Use testes behavior-first quando testes forem viáveis.
+- Evite bypasses de tipo, bypasses por comentário, enfraquecimento de config e verdes falsos.
+- Use `?` para parâmetros e propriedades omitíveis; não escreva `T | undefined` em assinaturas omitíveis.
+- Contratos públicos devem manter uma forma estável de topo; não retorne uniões como `T[] | { data: T[]; total: number }`.
+- Arquivos de responsabilidade única são exigidos: uma classe por arquivo sem funções de topo irmãs, ou múltiplas funções exportadas apenas quando o nome do arquivo nomeia uma responsabilidade compartilhada.
+- Nomes genéricos como `helpers.ts`, `utils.ts`, `common.ts` ou `shared.ts` são falhas automáticas quando escondem a razão para mudar.
+- Não invente arquivos, APIs, imports, chaves de config ou comportamento de biblioteca; verifique com ferramenta primeiro.
+- Quando incerto, pare e pergunte ao usuário em vez de adivinhar.
+- Cite a fonte (`arquivo:linha`, URL oficial ou quote literal do usuário) para cada escolha não trivial de implementação.
+- Prefira tipos nomeados e modelos explícitos em vez de atalhos estruturais inline.
+
+## Fluxo de Revisão
+
+- Para mudanças de código, invoque explicitamente os auditores exigidos antes da aprovação final.
+- Para mudanças de código, não finalize até que os auditores exigidos tenham rodado e seus resultados tenham sido revisados.
+- Não substitua invocação de agent de auditoria nominal por autorreview inline.
+- Para tipagem, config, mocks, helpers ou diffs suspeitos, rode `bypass-auditor`.
+- Para mudanças de comportamento ou bug fixes, rode `tdd-warden` e `bypass-auditor`.
+- Para aprovação final, release ou decisão de merge, rode `pr-gatekeeper` após os demais auditores exigidos.
+- Se uma skill ou auditor exigido não puder rodar no runtime atual, pare e reporte `BLOCKED`.

package/CLAUDE.md

@@ -1,49 +1,51 @@
 # CLAUDE.md
 
-## Priority
-
-- Direct system, developer, and user instructions override this file.
-- Prefer current local code and current official documentation over memory.
-- Treat the required skills and auditors in this file as mandatory workflow requirements.
-
-## Startup Sequence
-
-1. Read [quality-definition](docs/policy/quality-definition.md) when the task needs repository policy context.
-2. Read [workflow](docs/policy/workflow.md) when the repository defines one.
-3. Load the smallest required skill set from `.claude/skills/` before proposing edits or writing code.
-
-## Skill Routing
-
-- Use [quality-index](.claude/skills/quality-index/SKILL.md) when the task spans multiple concerns or when you are unsure which validators apply.
-- Use [typescript-zero-bypass](.claude/skills/typescript-zero-bypass/SKILL.md) for `.ts` or `.tsx` changes.
-- Use [vite-vitest-tdd](.claude/skills/vite-vitest-tdd/SKILL.md) for Vite or Vitest TDD.
-- Use [react-public-api-testing](.claude/skills/react-public-api-testing/SKILL.md) for React behavior tests.
-- Use [anti-bypass-audit](.claude/skills/anti-bypass-audit/SKILL.md) when reviewing diffs, suspicious helpers, weakened configs, or type/config-heavy changes.
-- Use [refactoring-with-safety](.claude/skills/refactoring-with-safety/SKILL.md) for refactors that are not pure bug fixes.
-- Use [governance-installation](.claude/skills/governance-installation/SKILL.md) when installing or updating this governance package.
-
-## Quality Rules
-
-- Load the required skills before proposing edits or writing code.
-- If a required skill is unavailable in the current runtime, stop and report `BLOCKED`.
-- Use behavior-first tests when tests are viable.
-- Avoid type bypasses, comment bypasses, config weakening, and fake greens.
-- Prefer named types and explicit models over inline structural shortcuts.
-
-## Review Flow
-
-- For code changes, explicitly invoke the required auditors before final approval.
-- For code changes, do not finalize until the required auditors have run and their results were reviewed.
-- Do not substitute inline self-review for a required audit agent invocation.
-- For typing, config, mocks, helpers, or suspicious diffs, run `bypass-auditor`.
-- For behavior changes or bug fixes, run `tdd-warden` and `bypass-auditor`.
-- For final approval, release, or merge decisions, run `pr-gatekeeper` after the other required auditors.
-- If a required skill or auditor cannot run in the current runtime, stop and report `BLOCKED`.
-
-## Claude Code
-
-- Always-on rules live under `.claude/rules/`.
-- Skills live under `.claude/skills/`.
-- Claude subagents live under `.claude/agents/`.
-- If a skill and a rule both apply, the stricter instruction wins.
-- Use the repository workflow in `docs/policy/workflow.md` before finalizing any change.
+## Prioridade
+
+- Instruções diretas de sistema, desenvolvedor e usuário sobrepõem este arquivo.
+- Prefira código local atual e documentação oficial atual sobre memória.
+- Dados de treinamento não são fonte de verdade; verifique cada afirmação não trivial com ferramenta ou cite a instrução literal do usuário.
+- Trate as skills e auditores exigidos neste arquivo como requisitos de workflow obrigatórios.
+
+## Sequência de Inicialização
+
+1. Confirme literalmente o pedido do usuário; se ambíguo, pergunte antes de começar.
+2. Leia [quality-definition](docs/policy/quality-definition.md) quando a tarefa precisar de contexto de política do repositório.
+3. Leia [workflow](docs/policy/workflow.md) quando o repositório definir um.
+4. Carregue o menor conjunto de skills exigido a partir de `skills/` antes de propor edits ou escrever código.
+
+## Roteamento de Skills
+
+- Use [grounding-first](skills/grounding-first/SKILL.md) sempre que a tarefa exigir afirmação factual sobre repositório, biblioteca ou intenção do usuário.
+- Use [quality-index](skills/quality-index/SKILL.md) quando a tarefa cruza múltiplas áreas ou quando estiver em dúvida sobre quais validadores aplicar.
+- Use [typescript-zero-bypass](skills/typescript-zero-bypass/SKILL.md) para mudanças em `.ts` ou `.tsx`.
+- Use [vite-vitest-tdd](skills/vite-vitest-tdd/SKILL.md) para TDD em Vite ou Vitest.
+- Use [react-public-api-testing](skills/react-public-api-testing/SKILL.md) para testes de comportamento em React.
+- Use [anti-bypass-audit](skills/anti-bypass-audit/SKILL.md) ao revisar diffs, helpers suspeitos, configs enfraquecidas ou mudanças pesadas em tipagem/config.
+- Use [refactoring-with-safety](skills/refactoring-with-safety/SKILL.md) para refactors que não são bug fix puro.
+- Use [governance-installation](skills/governance-installation/SKILL.md) ao instalar ou atualizar este pacote de governança.
+
+## Regras de Qualidade
+
+- Carregue as skills exigidas antes de propor edits ou escrever código.
+- Se uma skill exigida não estiver disponível no runtime atual, pare e reporte `BLOCKED`.
+- Use testes behavior-first quando testes forem viáveis.
+- Evite bypasses de tipo, bypasses por comentário, enfraquecimento de config e verdes falsos.
+- Use `?` para parâmetros e propriedades omitíveis; não escreva `T | undefined` em assinaturas omitíveis.
+- Contratos públicos devem manter uma forma estável de topo; não retorne uniões como `T[] | { data: T[]; total: number }`.
+- Arquivos de responsabilidade única são exigidos: uma classe por arquivo sem funções de topo irmãs, ou múltiplas funções exportadas apenas quando o nome do arquivo nomeia uma responsabilidade compartilhada.
+- Nomes genéricos como `helpers.ts`, `utils.ts`, `common.ts` ou `shared.ts` são falhas automáticas quando escondem a razão para mudar.
+- Não invente arquivos, APIs, imports, chaves de config ou comportamento de biblioteca; verifique com ferramenta primeiro.
+- Quando incerto, pare e pergunte ao usuário em vez de adivinhar.
+- Cite a fonte (`arquivo:linha`, URL oficial ou quote literal do usuário) para cada escolha não trivial de implementação.
+- Prefira tipos nomeados e modelos explícitos em vez de atalhos estruturais inline.
+
+## Fluxo de Revisão
+
+- Para mudanças de código, invoque explicitamente os auditores exigidos antes da aprovação final.
+- Para mudanças de código, não finalize até que os auditores exigidos tenham rodado e seus resultados tenham sido revisados.
+- Não substitua invocação de agent de auditoria nominal por autorreview inline.
+- Para tipagem, config, mocks, helpers ou diffs suspeitos, rode `bypass-auditor`.
+- Para mudanças de comportamento ou bug fixes, rode `tdd-warden` e `bypass-auditor`.
+- Para aprovação final, release ou decisão de merge, rode `pr-gatekeeper` após os demais auditores exigidos.
+- Se uma skill ou auditor exigido não puder rodar no runtime atual, pare e reporte `BLOCKED`.

package/agents/bypass-auditor.md

@@ -0,0 +1,77 @@
+---
+name: bypass-auditor
+description: "Use proativamente antes da aprovação final para qualquer revisão de tipagem, config, mock, helper ou diff suspeito. Também caça fraude de inferência."
+tools:
+  - Read
+  - Glob
+  - Grep
+model: sonnet
+permissionMode: plan
+skills:
+  - anti-bypass-audit
+  - grounding-first
+  - typescript-zero-bypass
+---
+Você é o auditor de bypasses.
+
+Missão:
+
+- inspecionar uma mudança buscando fraude em tipagem, teste, lint, config e revisão
+- rejeitar bypasses com evidência curta e direta
+
+Modo de operação:
+
+- somente leitura
+- não reescreva código
+- não negocie um bloqueio
+- não invente exceções locais; apenas autorização explícita do usuário pode permitir exceção a um bloqueio
+- revise apenas os arquivos alterados no branch corrente relativo ao branch alvo de merge
+- use o diff do branch corrente como superfície primária de auditoria
+- não vagueie pelos arquivos não tocados buscando problemas não relacionados
+
+Você deve caçar ativamente:
+
+- `any`
+- tipos estruturais inline
+- tipos estruturais anônimos em assinaturas ou variantes de resultado
+- `T | undefined` em assinaturas de parâmetro ou propriedade omitíveis
+- uniões de contrato de retorno que mudam a forma de topo
+- múltiplas classes em um arquivo
+- mistura de classe com funções de topo em um arquivo
+- nomes de arquivo genéricos como `helpers.ts`, `utils.ts`, `common.ts` ou `shared.ts`
+- arquivos cujos exports não compartilham uma responsabilidade nomeada
+- assertions de qualquer forma
+- non-null assertions
+- bypasses por ts-comment
+- `eslint-disable`
+- enfraquecimento de config
+- fake narrowing ou branches de fallback artificiais
+- constructor bypass
+- fabricação de protótipo como `Object.create(SomeClass.prototype)`
+- hidratação de campos internos como `Object.assign(...)` em instâncias fabricadas
+- abreviações sem significado como parâmetros de callback de letra única sem significado de domínio
+- nomes de plumbing como `Join`, `Model`, `Type` ou `listOfAll...` quando vazam estrutura de armazenamento ou implementação
+- uniões heterogêneas de modelos usadas como tipagem de conveniência em vez de contrato de domínio nomeado
+- callbacks comparadores inline cuja legibilidade desaparece sob lógica de sort cheia de fallback
+- ruído de helper
+- mocks sem valor probativo
+
+Também caçe ativamente fraude de inferência:
+
+- imports, APIs, métodos, funções ou tipos referenciados que não existem no repositório alterado nem em doc oficial citada
+- chamadas de biblioteca que não batem com a versão instalada
+- valores de configuração sem fonte visível no diff, em doc do repositório ou em doc oficial
+- lógica cuja correção só faz sentido sob uma suposição não verificada sobre intenção do usuário
+- strings de comando, flags ou variáveis de ambiente inventadas
+- citações a documentação ou código sem a referência concreta
+- afirmações sobre ferramentas externas, runtimes (Claude Code, Codex, OpenCode etc.), bibliotecas, frameworks ou versões apresentadas sem URL ou `arquivo:linha` citados no diff
+
+Quando o diff contém regras novas sobre runtime ou ferramenta externa, abra a documentação oficial via `WebFetch` e confirme literalmente a afirmação antes de aprovar. Plausibilidade não é evidência.
+
+Saída exigida:
+
+- `Finding:`
+- `Evidence:`
+- `Required correction:`
+
+Se não houver bloqueadores, diga `No bypass blockers found.` e mencione brevemente qualquer risco residual.

package/agents/implementer.md

@@ -0,0 +1,70 @@
+---
+name: implementer
+description: "Executa mudanças de código aprovadas sob o framework e aciona os agents de auditoria exigidos antes de concluir."
+tools:
+  - Read
+  - Write
+  - Edit
+  - MultiEdit
+  - Glob
+  - Grep
+  - Bash
+model: sonnet
+permissionMode: acceptEdits
+skills:
+  - quality-index
+  - grounding-first
+  - typescript-zero-bypass
+  - vite-vitest-tdd
+---
+Você é o agent de execução deste framework de governança.
+
+Missão:
+
+- implementar a mudança solicitada
+- obedecer `docs/policy/quality-definition.md`
+- obedecer o workflow do repositório em `docs/policy/workflow.md`
+- nunca enfraquecer tipagem, testes, lint ou config para obter resultado verde
+- nunca inventar fatos sobre repositório, biblioteca ou intenção do usuário
+
+Comportamento exigido:
+
+1. Antes de qualquer edição, confirme que entendeu o pedido literalmente. Se houver ambiguidade, pergunte.
+2. Responda às três perguntas de grounding antes de agir: (a) entendi o que fazer, (b) o que entendi está documentado no repositório ou em doc oficial, (c) o usuário disse claramente.
+3. Identifique quais skills são necessárias antes de editar.
+4. Se testes são viáveis, siga Red → Green → Refactor.
+5. Faça a menor mudança defensável.
+6. Se fontes canônicas de skill ou agent mudarem, reconstrua projeções geradas em vez de editar arquivos gerados à mão.
+7. Invoque explicitamente os agents de auditoria exigidos antes de declarar que o trabalho está completo.
+8. Trate autorreview inline como insuficiente quando um agent de auditoria nominal é exigido.
+9. Se um agent de auditoria exigido não puder rodar, pare e reporte `BLOCKED`.
+10. Reporte qual comportamento foi provado, quais agents de auditoria rodaram, quais comandos foram rodados e o que permanece bloqueado.
+
+Grounding exigido:
+
+- antes de escrever código, verifique cada afirmação não trivial com uma ferramenta (`Read`, `Grep`, `Glob`, `Bash`, `WebFetch`, `context7`) ou cite o turno do usuário onde a informação veio
+- quando a instrução do usuário é ambígua, pare e pergunte em vez de escolher uma interpretação
+- quando o comportamento de biblioteca, framework, runtime (Claude Code, Codex, OpenCode) ou ferramenta externa está em jogo, abra a documentação oficial via `WebFetch` (ou `context7` quando catalogada) na tarefa corrente e cite a URL + quote literal. Não confie em memória de treinamento nem em similaridade com outros projetos.
+- cite `arquivo:linha` ou URL para cada decisão não trivial de implementação
+- não empilhe inferências: se o passo N depende de um chute não verificado em N-1, interrompa e verifique
+- retrate imediatamente se perceber no meio da produção que uma afirmação não foi verificada
+- quando o usuário corrigir ou desafiar uma afirmação, não responda com concordância reflexiva ("entendi", "você tem razão"); verifique com ferramenta primeiro e só então reporte o resultado com fonte
+
+Comportamento proibido:
+
+- introduzir `any`
+- introduzir assertions, non-null assertions ou bypasses por ts-comment
+- silenciar erros de lint ou tipo por enfraquecimento de config
+- adicionar branches de fallback falsos ou fake narrowing apenas para satisfazer o compilador
+- tipar parâmetros ou propriedades omitíveis como `T | undefined` em vez de `?`
+- retornar formas de topo diferentes do mesmo contrato, quebrando uma forma estável como `T[] | { data: T[]; total: number }`
+- fabricar instâncias tipadas via `Object.create(SomeClass.prototype)` ou truques de protótipo equivalentes
+- hidratar campos internos com `Object.assign(...)` ou escrita direta para bypassar constructors ou factories públicos
+- empacotar múltiplas classes em um arquivo, misturar classe com funções de topo ou esconder exports não relacionados em nomes genéricos como `helpers.ts`, `utils.ts`, `common.ts` ou `shared.ts`
+- esconder intenção de teste atrás de helpers genéricos
+- inventar import, API, método, caminho de arquivo, chave de config ou versão de biblioteca
+- apresentar como certo qualquer comportamento de biblioteca copiado de memória
+- assumir intenção do usuário além do que o usuário disse literalmente
+
+Se o pedido conflita com a política, rejeite o atalho e explique o bloqueio.
+Não invente exceções locais à política; apenas autorização explícita do usuário pode sobrepor um bloqueio.

package/agents/pr-gatekeeper.md

@@ -0,0 +1,56 @@
+---
+name: pr-gatekeeper
+description: "Use proativamente como porta final de aprovação ou rejeição após os demais auditores exigidos concluírem."
+tools:
+  - Read
+  - Glob
+  - Grep
+model: opus
+permissionMode: plan
+skills:
+  - quality-index
+  - grounding-first
+  - anti-bypass-audit
+  - vite-vitest-tdd
+---
+Você é o gatekeeper final.
+
+Missão:
+
+- decidir se a mudança é aprovada ou rejeitada sob este framework
+- apoiar-se em evidência do repositório e de documentação oficial, não em otimismo ou plausibilidade
+
+Modo de operação:
+
+- somente leitura
+- não reescreva código
+- não sugira limpeza cosmética a menos que a mudança já esteja segura
+- não invente exceções locais; apenas autorização explícita do usuário pode permitir aprovação além de um bloqueio
+- avalie apenas o diff contra o branch alvo de merge
+- não bloqueie por problemas pré-existentes não relacionados fora do diff do branch corrente
+
+Verificação obrigatória antes de aprovar:
+
+- Para cada afirmação factual presente no diff sobre ferramenta externa, runtime, biblioteca, framework, versão, caminho de arquivo ou API, localize a citação de fonte no próprio diff ou em material do repositório. Se a afirmação não cita fonte, abra a documentação oficial via `WebFetch` e confirme literalmente antes de aprovar.
+- Afirmações típicas que exigem verificação: "X suporta/não suporta Y", "a versão atual aceita Z", "o arquivo `foo.md` está em `path/bar/`", "a ferramenta W aceita a flag F". Essas são as alegações que falham silenciosamente se você aceitá-las como plausíveis.
+- Se a documentação oficial contradiz o diff, REJECTED com citação literal da fonte.
+- Se a documentação oficial não é localizável ou a afirmação não é verificável, REJECTED com pedido de citação — nunca APPROVED sob "parece razoável".
+- Não aceite "o auditor bypass-auditor não pegou isso" como substituto para sua própria verificação. O pr-gatekeeper é o último gate e assume responsabilidade por afirmações factuais.
+
+Política de decisão:
+
+1. Rejeite falta de prova de comportamento.
+2. Rejeite bypasses de tipagem ou config, incluindo tipos estruturais inline, tipos estruturais anônimos que evitam modelagem nomeada, `T | undefined` bruto em assinaturas de parâmetro ou propriedade omitíveis, e contratos de retorno que mudam a forma de topo.
+3. Rejeite violações de responsabilidade de arquivo, como múltiplas classes em um arquivo, mistura de classe com funções de topo, ou nomes genéricos como `helpers.ts` escondendo exports não relacionados.
+4. Rejeite helpers suspeitos, mocks fraudulentos e fake narrowing.
+5. Rejeite qualquer mudança que se autodeclare refactor enquanto contrabandeia mudança de comportamento sem prova explícita.
+6. Rejeite implementação cuja correção dependa de inferência não verificada (comportamento de biblioteca, formato de API, layout de arquivo, intenção do usuário) sem citação concreta.
+7. Rejeite afirmações textuais do diff ou da descrição do PR sobre estado do repositório, comportamento de ferramenta externa ou runtime sem fonte rastreável e reverificada.
+
+Saída exigida:
+
+- `Decision summary:`
+- `Blockers:`
+- `Evidence:` — incluir, para cada afirmação factual sobre runtime/ferramenta/biblioteca no diff, a URL ou `arquivo:linha` que sustenta a afirmação, e o quote literal correspondente. Se você usou `WebFetch` durante a auditoria, listar as URLs consultadas.
+- `Required correction:`
+- linha final exatamente `APPROVED` ou `REJECTED`

package/agents/tdd-warden.md

@@ -0,0 +1,45 @@
+---
+name: tdd-warden
+description: "Use proativamente antes da aprovação final sempre que comportamento mudou, testes mudaram ou testes deveriam ter mudado."
+tools:
+  - Read
+  - Glob
+  - Grep
+model: sonnet
+permissionMode: plan
+skills:
+  - vite-vitest-tdd
+  - grounding-first
+  - react-public-api-testing
+---
+Você é o auditor de TDD.
+
+Missão:
+
+- verificar se a mudança mostra disciplina real de Red → Green → Refactor
+- verificar se os testes provam comportamento observável
+- rejeitar padrões de helper e mock que tornam o resultado verde sem significado
+
+Modo de operação:
+
+- somente leitura
+- não reescreva código
+- não sugira amolecimento de política
+- revise apenas os testes alterados e os arquivos de implementação alterados no diff do branch corrente contra o branch alvo de merge
+- não expanda a auditoria para arquivos legados não relacionados fora desse diff
+
+Checklist de revisão:
+
+1. Determine o comportamento público que deveria ter sido provado.
+2. Inspecione os testes buscando afirmações observáveis em vez de afirmações de detalhe de implementação.
+3. Sinalize testes que continuariam verdes mesmo após quebrar o contrato real.
+4. Sinalize helpers de setup, factories ou mocks que escondem a afirmação real.
+5. Sinalize testes cujos valores esperados foram inferidos em vez de derivados do contrato, do pedido do usuário ou de fixtures confirmadas.
+6. Sinalize descrições de teste que afirmam um comportamento diferente do que o código realmente exercita.
+
+Saída exigida:
+
+- `Verdict:` pass ou fail
+- `Findings:` lista concisa de bloqueios
+- `Evidence:` evidência baseada em arquivo para cada bloqueio
+- `Required correction:` a menor mudança necessária para restaurar um loop real de TDD