Descrição de PR para TDAH
Formato de corpo de PR padrão para este repositório. Revisores devem terminar a descrição em uma única olhada. O diff já está no GitHub — não reafirme movimentações de arquivos.
Agentes: carregue esta skill ao compor ou reescrever uma descrição de PR do Nakama (inclusive via ce-commit-push-pr). O formato do corpo vem daqui; ainda colete os fatos reais do diff (resultado, risco, o que você verificou).
Formato (obrigatório)
## Resumo
<uma linha: quem faz o quê → resultado. Sem névoa de jargão, a menos que a mudança seja jargão.>
**Antes:** <uma linha — comportamento antigo ou custo>
**Depois:** <uma linha — novo comportamento; nomeie a função/caminho principal se ajudar a avaliar o risco>
Por que é seguro:
1. <motivo>
2. <motivo>
3. <motivo> <!-- 2–3 itens no máximo; remova #3 se não houver o que dizer -->
Re-adicionar / acompanhar apenas se <um risco residual ou gatilho de reversão>.
## Plano de teste
- [x] <comando já executado> (<N> passaram)
- [ ] <uma verificação manual que um humano pode fazer em <2 min>
Opcional após o plano de teste (mantenha se o fluxo de trabalho esperar os selos do Compound Engineering):
---
[](https://github.com/EveryInc/compound-engineering-plugin)
Regras
- Resultado em primeiro lugar. A primeira linha do Resumo é o novo mundo, não "Este PR remove…".
- Antes/Depois = duas linhas. Rótulos em negrito. Sem parágrafos ao redor.
- Por que é seguro = numerado, ≤3. Máximo de 5 marcadores no corpo inteiro; se houver mais, mantenha apenas os que mudam a decisão.
- Um resíduo. Cite o caso que o faria desfazer isso. Pule se realmente não houver.
- Sem turismo de diff. Não liste arquivos, contagens de linhas como a história, ou "também limpei exportações" a menos que isso seja o risco.
- Plano de teste = executável. Prefira comandos verificados com contagens de passagens; um probe manual não verificado.
- Título permanece convencional.
tipo(escopo): imperativo— curto. O corpo carrega este formato; o título não precisa de emojis ou ensaios. - Aplique com
gh. Escreva o corpo em um arquivo temporário;gh pr edit <n> --body-file …ough pr create --body-file …. Nunca--body "$(cat …)".
Exemplo dourado
Corresponda a esta densidade:
## Resumo
Aprovar uma proposta de memória da organização → marcador vai para `MEMORY.md`. Nenhuma chamada de LLM.
**Antes:** merge determinístico, então reescrita opcional do modelo do arquivo inteiro.
**Depois:** apenas merge determinístico (`applyApprovedOrgMemoryBullet`).
Por que é seguro:
1. Dedup + substituir já estão ativos nessa função
2. Caminho do LLM já falhou de forma segura para o resultado determinístico
3. −230 linhas, mesmo resultado de aprovação
Re-adicionar uma reescrita do LLM apenas se marcadores contraditórios começarem a sobreviver à aprovação.
## Plano de teste
- [x] `bun test packages/agent/src` (80 passaram)
- [x] `bun test apps/server/src/services/org-memory-service.test.ts` (15 passaram)
- [ ] Aprovar uma proposta pendente (fixada + log recente) — marcador chega como antes
Anti-padrões
| Não faça | Faça |
|---|---|
| Resumo com múltiplos parágrafos | Uma linha de resultado + Antes/Depois + Por que é seguro |
| "Este PR tem como objetivo…" / "A fim de…" | Comece com o verbo ou ação do usuário |
### aninhados sob Resumo | Apenas ## Resumo + ## Plano de teste |
| Reafirmar cada arquivo excluído | Apenas risco residual |
| "testes passaram" vago | Comando exato + contagem de passagens |
Fluxo de trabalho
- Leia o diff / commits do PR (
gh pr view,git diff base...HEAD) - Nomeie: resultado, antes, depois, ≤3 motivos de segurança, um resíduo
- Preencha o modelo — corte qualquer frase que o diff já prova
- Aplique via
--body-file - Responda com a URL do PR (mais "diga se quiser que o título seja ajustado" apenas se for útil)