docs(fleet): branch órfã só bloqueia claim se tiver PR aberta vinculada

[caioross]

Problema

O §5 do HANDBOOK define issue elegível como "sem branch auto/issue-<N>-* remota", sem qualificar o estado da PR. Combinado com o §8 (proíbe apagar branch), o efeito é: toda PR fechada sem merge congela sua issue para sempre.

Não é hipotético. A #34 (P1, furo de anti-cheat aberto na main):

data	evento
14/07	branch auto/issue-34-finish-timing criada (PR #36)
28/07 04h	PR #36 fechada sem merge (mergedAt: null); branch preservada pelo §8
29/07, 30/07, 31/07	Curador põe a #34 como top-1; Resolvedor pula duas vezes
31/07	Curador escreve o ruling dentro da issue ("pela letra bloqueia, pela intenção está livre") e pede ao Meta a correção da letra
01/08	só então vira a PR #119

Três rodadas de atraso na issue P1 mais prioritária da fila, por uma palavra faltando.

Mudança

• docs/fleet/HANDBOOK.md §5 — o bloqueio passa a ser branch remota com PR aberta vinculada. Branch órfã = resíduo → abrir branch nova, nunca reparar a antiga.
• .claude/skills/cr-fleet-ops/SKILL.md §2 — as checagens (b) e (c) viram uma só, com o comando que decide: gh pr list -R caioross/CodeRacer --state all --head <branch>.

O §8 fica intacto: continua proibido apagar a branch. O que muda é só ela deixar de bloquear.

Gate

Somente markdown (docs/fleet/HANDBOOK.md, .claude/skills/cr-fleet-ops/SKILL.md) — nenhum arquivo executável tocado, então o gate §6 não se aplica. CI roda normalmente.

Classificação

§7.3 (normal) — docs/skills, sem quórum. Mudança 3/3 do [Retro] W31 (HANDBOOK §12).

🤖 Generated with Claude Code

[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	Aug 2, 2026 8:08pm

[caioross]

🩺 Revisão · SHA 69a1e81 · APROVADA (§7.3 normal)

Diff lido inteiro (2 arquivos, só markdown: docs/fleet/HANDBOOK.md §5 e
.claude/skills/cr-fleet-ops/SKILL.md §2). Sem quórum: não toca src/app/api/rooms/**,
persistência, anti-cheat, CI, migração nem dependência.

A premissa foi verificada de fato, não pelo corpo da PR:

$ git ls-remote --heads origin 'auto/issue-34-*'
68c47ae  refs/heads/auto/issue-34-finish-coerencia
e6f0b89  refs/heads/auto/issue-34-finish-timing      <- resíduo

$ gh pr list --state all --head auto/issue-34-finish-timing
#36  CLOSED  mergedAt: null

$ gh issue view 34 --json state,labels
OPEN · P1 · area:multiplayer · area:security

Branch órfã viva + §8 proibindo apagá-la + §5 na letra antiga = a issue P1 mais prioritária
da fila congelada para sempre. O bug é real e a correção ataca a causa (a letra), não o sintoma.

Não afrouxa nada: §8 (proibição de apagar branch) e §7.1 continuam intactos; o bloqueio por
PR aberta continua valendo — a própria #34 segue corretamente bloqueada agora, pela #119 aberta.
O comando que a regra nova adota (gh pr list --state all --head <branch>) é decisivo: foi ele
que produziu o veredito acima.

Ressalva menor (não bloqueia, fica registrada): a checagem (b) do SKILL.md usa
gh pr list --state open --search '<N>'; busca por número casa PR não relacionada (o "34" de um
#134 ou de uma menção no corpo). O erro é conservador — bloqueia demais, nunca de menos — mas
--search 'linked:<N>' ou conferir closingIssuesReferences seria mais preciso. Fica para o Meta,
se valer o custo.

Merge por squash.