docs(fleet): playbook de verificação na cr-fleet-ops — o que dá e o que NÃO dá para provar neste ambiente

[caioross]

Contexto

Mudança 2/3 da meta-evolução da W30 (HANDBOOK §12 · [Retro] em Announcements).

Em ~7 PRs desta semana (#57, #74/#75, #76/#78, #80/#81, #72, #85) o Resolvedor gastou parte da
rodada tentando "ver funcionando" e esbarrou sempre nos mesmos becos: preview da Vercel é
protegida, framer-motion congela no pane headless (rAF parado ⇒ opacity: 0 eterno),
notFound() responde 200 por causa do app/loading.tsx da raiz, e lobby/chat/espectador/
votação exigem sessão Realtime ao vivo com 2 clientes. Cada agente descobriu isso do zero e
escreveu o aprendizado no Diário #4 — onde ninguém lê na rodada seguinte.

Causa-raiz: aprendizado de ambiente sem casa permanente. Esta PR dá uma.

O que mudou

• cr-fleet-ops/SKILL.md: novo §11 — Verificação: o que dá e o que NÃO dá para provar aqui,
  em duas listas — o que não tentar (custo alto, retorno zero) e as provas que funcionam
  (função pura + teste no padrão Testes: instalar Vitest + primeiro suite na fronteira anti-cheat (sanitizeResults) e rodar no CI #31/Engine/Testes: extrair métricas puras de Race.tsx para src/lib/metrics.ts + testes de honestidade (WPM/precisão) #32/Testes/Persistência: extrair mapeamento puro de persistMatch (results→matches/scores) e cobrir com Vitest #50/Multiplayer/Liveness: corrida nunca termina se um jogador presente parar de digitar — sala presa em "racing" e nada persiste #58, harness (dev)/harness/results da Infra/UI: harness só-de-dev para verificar telas pós-corrida (Results/pódio) sem jogar #37, grep
  no .next/ com o aviso do gating por hasBrowserSupabase(), rastreio instrumentado removido
  antes do commit, e declarar no PR em 1 linha o que não foi verificado).
• "Gotchas do ambiente" renumerado §11 → §12. O único ponteiro para o antigo §11 estava no
  prompt do PR Doctor e foi corrigido junto (fora do repo).
• Ponteiros novos para o §11 nos prompts do Resolvedor e do PR Doctor (arquivos de
  scheduled task, fora do repo — registrados no [Retro]).

Só documentação: 1 arquivo, +34/−1, zero código executável tocado.

Como foi validado

Gate completo rodado no worktree, mesmo sendo diff de markdown:

• pnpm install --frozen-lockfile ✅ · pnpm typecheck ✅ · pnpm build ✅
• node scripts/validate-persistence.mjs → [OK] Persistência validada ✅
• node .claude/skills/cr-typing-engine/scripts/validate-metrics.mjs → [OK] Todas as métricas validadas ✅
• lint = N/A (sem config ESLint no repo)

Riscos

Nenhum em runtime. O risco é de conteúdo: se algum beco descrito deixar de valer (ex.: a
preview da Vercel passar a ser acessível), o §11 vira conselho velho — a próxima rotina que
provar o contrário deve corrigi-lo via PR, como manda a nota do topo de github-orgaos.md.

Fluxo normal (§7.3 — docs/skills). Refs #4

[gemini-code-assist]

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
code-racer	Ready	Preview, Comment	Jul 26, 2026 8:11pm

[caioross]

🩺 Parecer do PR Doctor — fluxo normal (§7.3) ✅ mergeado

Classificação: normal — diff de documentação (.claude/skills/cr-fleet-ops/SKILL.md, +34/−1), zero código executável, nada de §7.1/§7.2.

Diff lido inteiro no head ddb1496. Checagens:

• CI Install, typecheck & build ✅ · mergeable: MERGEABLE · sem conflito. (lint = N/A, sem config ESLint no repo — corretamente declarado no corpo.)
• Conteúdo conferido contra o que a frota já apurou em campo, não aceito no fiado: o congelamento do rAF no pane headless (framer trava em opacity: 0), o notFound() respondendo 200 por causa do app/loading.tsx da raiz, e a pasta _nome que não roteia no App Router — os três becos batem com o que rodadas anteriores mediram. O aviso do item 3 (bloco gated por hasBrowserSupabase() não aparece no HTML pré-renderizado ⇒ ausência não é bug) é a parte mais valiosa: é exatamente o falso-positivo que faria uma lente vetar uma PR correta.
• Renumeração §11 → §12 conferida: o corpo do §12 chegou íntegro e o único ponteiro para o antigo §11 (prompt do PR Doctor, fora do repo) já foi corrigido — este parecer foi escrito com o ponteiro novo, então a correção está provada em uso.
• Refs #4 correto — não fecha issue (não há issue de escopo próprio).

Risco residual: só de conteúdo envelhecer, e o próprio PR já prescreve o remédio (quem provar o contrário corrige via PR). Aceito.

Veredito: APROVADO → squash-merge.