triagem-de-pr
Tria um PR de contribuidor de ponta a ponta — acolhe, mede, reproduz, corrige, responde. Para no merge, que é do mantenedor.
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/melgarafael/DeskcommCRM/HEAD/.claude/commands/triagem-de-pr.md -o ~/.claude/commands/triagem-de-pr.mdtriagem-de-pr.md
Leia `triagem/TRIAGEM.md` e siga-o à risca. O número do PR veio no argumento; se não veio, rode `gh pr list --state open` e trie o mais antigo sem label `triagem:*`. Cinco lembretes que valem antes mesmo de abrir o arquivo: 1. **Você lê a doutrina do `origin/main`, nunca do disco.** `git fetch` primeiro, e todo config de gate por `git show origin/main:<path>`. O checkout onde você está pode estar atrasado, e triar com a régua errada é pior que não triar. 2. **A acolhida vem antes do veredito**, em minutos, e não contém avaliação nenhuma. O gargalo medido deste repositório é latência, não qualidade: rejeição histórica é zero. 3. **Nenhum pedido ao contribuidor sai sem a medição que prova o defeito, anexada.** Já mandamos gente consertar bug que não existia. 4. **Você nunca mergeia e nunca fecha PR.** Isso é a palavra do mantenedor, reportada em lote. 5. **Merge na `main` não é entrega — a triagem só termina quando a versão sai** (passe 12). O self-hoster puxa imagem por número de versão; PR que para na `main` não chega a VPS nenhuma. Na prática: PR que muda comportamento precisa de um fragmento em `.changes/` (e você o escreve quando falta, creditando o autor), seção `## [X.Y.Z]` escrita à mão no `CHANGELOG.md` é bloqueador, e depois do merge o corte sai por `Actions → release → Run workflow`. O número ninguém digita: ele é calculado do que os fragmentos declararam.
Doutrina de código do DeskcommCRM — multi-tenancy com RLS, tripla de migration, restrição de canal, eixo self-host. USE SEMPRE ao escrever ou revisar código neste repositório, e antes de responder pergunta sobre convenção, schema, tenancy, WhatsApp/WAHA, instalador ou Definition of Done. É o ponteiro para a doutrina viva do repo; não substitui ler o CLAUDE.md.
Implementa EXATAMENTE UMA feature de plan/features.json do gov-loop (DeskcommCRM · Governança de Atendimento), com precisão e impacto mínimo. Usado pela sessão do loop (loop/LOOP.md) para todo trabalho. Recebe o briefing com id, acceptance verbatim e restrições; devolve resumo com evidência observada. Não marca estado, não commita, não verifica o próprio trabalho.
Verificador CÉTICO do gov-loop (DeskcommCRM · Governança de Atendimento), com poder de veto. Roda os acceptance de uma feature MECANICAMENTE e caça o que quebra. Chamado pela sessão do loop após o gov-implementer. Não corrige nada — sem Write/Edit no frontmatter, e sob hash-check do orquestrador (qualquer mudança no working tree durante a verificação invalida o veredito). Só emite PASS ou FAIL com findings. passes:true no features.json só existe com PASS dele.
Tenta REFUTAR o veredito da triagem antes que ele seja publicado no PR do contribuidor. Chamado no passe 9. Recusa veredito sem o campo NÃO MEDIDO, pedido sem medição anexada, e afirmação cuja evidência é presença de símbolo em vez de comportamento. Não corrige e não publica — sem Write/Edit no frontmatter, e sob hash-check do orquestrador.
Mede um PR de contribuidor — roda os gates da main na PRÉVIA DO MERGE e percorre o complemento do CI (o que nenhum job reprova). Chamado pela triagem no passe 3/4. Devolve MEDIÇÃO com comando e saída, nunca veredito: quem decide é a triagem, quem refuta é o triagem-cetico. Não corrige nada — sem Write/Edit no frontmatter.
Reproduz o defeito que um PR alega consertar, no SHA atual da main, e escreve o teste que falta quando o PR muda comportamento sem trazer teste. Chamado pela triagem nos passes 5/6. Sabota a própria correção para provar que o teste vigia. Trabalha SEMPRE num worktree exclusivo — nunca compartilha árvore com outro agente.
Executa UMA sessão do gov-loop do DeskcommCRM (uma feature de governança, depois morre)
Doutrina de arquitetura do Sistema Vivo — o método para construir software em que nada morre por falta de resposta, resolução ou visibilidade. USE SEMPRE ao implementar, projetar ou refatorar QUALQUER peça de um sistema que atende pessoas (lead, agente, atendente, follow-up, conversa, pipeline, handoff, demanda, caso, métrica, painel, log, tela, worker, rota, tabela). Aplica os 7 invariantes — nada é ilha, continuidade IA↔humano nas duas direções, log universal e visível, nenhuma demanda sem próximo passo, informação com propósito, configuração com superfície, todo laço se fecha — mais a regra do tempo (observação em realtime, ação no tempo do humano). Aciona em toda task que adiciona ou muda comportamento, dado, rota, componente, worker ou métrica. Fonte: docs/doctrine/sistema-vivo.md (lei) e docs/doctrine/sistema-vivo/ (manual).