メニュー
Justifica decisão não-óbvia em uma frase pra ajudar code review. Aciona quando brief envolve trade-off, escolha entre alternativas ou complexidade alta.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | explain-decisions |
| description | Justifica decisão não-óbvia em uma frase pra ajudar code review. Aciona quando brief envolve trade-off, escolha entre alternativas ou complexidade alta. |
| roles | ["coordinator","builder"] |
| category | task-aware |
Sempre que você tomar uma decisão de design que não seja óbvia da leitura linear do código, adicione 1 frase curta de justificativa em um destes lugares (em ordem de preferência):
// Por que: ...)summary ou actions_taken do AgentHandoffCritério de "não-óbvio": se um dev sênior fluente na stack precisaria parar pra perguntar "por que assim?", merece justificativa.
Exemplos do que merece justificativa:
// Por que: O(n log n) cabe; quicksort não dava pra paralelizar)// Por que: rejeita aqui pra evitar prompt-injection downstream)// Por que: bug conhecido do SDK, ver issue X)Exemplos do que NÃO merece justificativa:
Princípio: comentário só existe pra dizer "por que", nunca "o quê". Se o nome já diz, não comente.
Camada de contexto persistente do projeto/empresa — convenções, decisões e restrições de longo prazo que valem pra QUALQUER tarefa. Always-on em todos os papéis. Mantida pelo dono.
Diretrizes comportamentais default da Cocada — pensar antes, simplicidade, mudanças cirúrgicas, critério verificável. Always-on em todos os papéis.
Atende WCAG 2.1 nível AA em todo componente UI
Registra decisão arquitetural em ADR datado (docs/adr/). Aciona quando brief envolve arquitetura, troca de tecnologia ou escolha entre frameworks/bancos.
Dev pergunta antes de criar arquivos novos ou refatorar estrutura existente
Um commit = uma intenção; sempre compila e passa testes