القائمة
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 المهني
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
| 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.