cocada

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

Toda query checa que o user é dono do recurso

Padrões de qualidade pra entregas de backend: logs estruturados, error envelopes, validação no boundary, idempotência, testes em camadas. Ativa quando stack detectada inclui backend (Python/Node/Go/Rust).

Comenta complexidade Big-O em loops aninhados ou hot path

Copy direto e em voz humana, sem corporativês

Prefere stack brasileira/PT-BR — Postgres, FastAPI, Vue, datas dd/mm, R$

Recusa dep nova que ultrapassa orçamento de bundle

Reduz drasticamente tokens de saída ao falar curto/direto estilo caverna. Só muda o estilo de mensagens — comportamento do código continua igual.

Comentários e docstrings no código em português brasileiro. Diferente de pt-br-estrito (que cobre comunicação do agente).

Força Conventional Commits no PR final (feat/fix/docs/refactor/test/chore)

Narra debugging como detetive noir investigando um crime

Lógica de negócio no model ou em services; views finas

Docstrings Python no padrão Google com Args/Returns/Raises

Responde gritando como sargento militar; críticas pesadas mas tecnicamente certas

Cobre fluxos críticos com Playwright em vez de unit pesado

Trata erros e edge cases primeiro, com return antecipado (guard clauses)

Identificadores em inglês, mesmo em time PT-BR

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.

FastAPI com endpoints async, Pydantic v2 e dependency injection

Usa Decimal ou inteiro em centavos pra dinheiro; nunca float

Padrões de design e qualidade pra entregas de interface: semântica HTML, acessibilidade, performance percebida e consistência com tokens do repo. Ativa quando stack detectada inclui frontend (React/Vue/Next/SPA).

Implementa export e delete de dados pessoais por padrão

Go idiomático conforme Effective Go e padrões da std lib

PII de saúde nunca em log, métrica, analytics ou prompt LLM

Trata dados como imutáveis — nunca muta argumento de função

Prefere teste de integração real a mock pesado

Prefere solução simples e óbvia em vez de abstração inteligente

Carrega rotas, imagens e libs sob demanda

Mantém linhas em até 100 colunas pra evitar scroll horizontal

Ilustra fluxo não-trivial com diagrama Mermaid no markdown. Aciona quando brief menciona fluxo, sequência, workflow, máquina de estado ou arquitetura visual.

Mensagens de erro e empty state explicam o próximo passo

Filtra todo SELECT/UPDATE por tenant_id automaticamente

Caça N+1 em toda query com relação

Next.js com App Router e Server Components por padrão

Deixa o código falar — não escreve comentário que repete o que o código já diz