DeskcommCRM — doutrina de código

A fonte da verdade é o CLAUDE.md da raiz, lido do origin/main e não de um resumo. Esta skill existe para te fazer abri-lo na hora certa e para carregar as três regras que mais custam caro quando esquecidas.

1. Leia antes de escrever

Não confie em resumo de doutrina — nem neste arquivo. A Definition of Done já foi de 13 para 14 itens; cópia congelada ensina a regra de ontem. Abra o CLAUDE.md.

2. As três que mais custam

Multi-tenancy. Toda tabela tenant-aware leva organization_id uuid not null e RLS com policy tenant_isolation_<tabela>_all via fn_user_org_ids(). Service role bypassa RLS — handler que o usa filtra organization_id manualmente, resolvido de fonte confiável (cookie, JWT, segredo de webhook, token de path), nunca do body. No backend é sempre getUser(), nunca getSession().

Schema sai em tripla. Arquivo em supabase/migrations/, apêndice idempotente no supabase/baseline.sql, e linha -- manifest: <o quê e por quê> no cabeçalho do .sql (o MANIFEST.md é histórico; não recebe linha nova). O kit self-host aplica só o baseline — o que não chega lá não chega em quem instalou numa VPS, que é o cliente que paga. Constraint nova exige corrigir os dados antes, senão o update.sh do clone quebra.

Nenhuma feature nomeia um provider. Provider vive em lib/channels/. pnpm lint:channels é catraca com lista de dívida: arquivo novo sujo reprova — e arquivo que ficou limpo e não saiu da lista também reprova.

3. O eixo que não é técnico

A monetização é self-host em VPS, não assinatura: quem instala é o cliente. Então uma mudança pode ser tecnicamente impecável e ainda assim ser recusada — env var nova sem default quebra instalação fresca, dependência de serviço pago obrigatório quebra o modelo, e a pior de todas é a falha-em-verde: a sonda que declara sucesso medindo caminho diferente do que o usuário usa. Num produto que a pessoa instala sozinha, ela não descobre que está quebrado.

4. Antes de dizer "pronto"

Verde de teste não é prova de comportamento. Sabote a linha que você corrigiu e confirme que a suíte fica vermelha — teste que não reprova não guarda nada. E declare o que não mediu: é o campo que separa medição de relato.

E se o caminho de usuário que você provou passa por um agente de IA, o verde do agente não é prova da camada de baixo: todo caso de aceite que atravessa o agente vem em par com a medição direta da ferramenta, com o mesmo texto cru — o par é a unidade — e as duas medições só contam quando concordam. Discordância entre os dois significa que você mediu o modelo. Lei em docs/doctrine/prova-em-par.md.

Não-objetivos

Não lista comandos de fluxo — não existem /fix-bug nem /add-module neste repo. Não descreve estrutura de pastas nem convenção de nome de arquivo: a versão anterior deste arquivo era gerada automaticamente e ensinava snake_case com imports relativos, quando o repo usa kebab-case com alias @/. Detalhe correto mora no CLAUDE.md, que está atualizado — o que este arquivo não pode prometer.