Decoded · 11 mai 2026

As 12 regras do CLAUDE.md
Template + mapa + 3 variantes

Template PT-BR pronto pra colar na raiz do projeto. Cada regra documentada com o erro real que previne. Variantes pra prototype, production e monorepo. Mistake rate documentado caiu de 41% (vanilla) pra 3% com as 12 regras.

Decifrado de Karpathy (4 regras originais, 26.01.2026) + Forrest Chang (extensão para 12 regras).

Arquivos · 6 docs

O que tem aqui dentro

comece pelo README

◆

README.md

Instruções de uso

Como aplicar as 12 regras, mecânica do arquivo CLAUDE.md, fontes e o benchmark de mistake rate.

→

01-CLAUDE.md

Template padrão · 4 regras Karpathy + 8 estendidas

≤200 linhas PT-BR. Cola na raiz do projeto. Cada regra responde a "que erro específico isso previne?".

→

02-mapa-regra-erro.md

Mapa regra ↔ erro concreto

Cada uma das 12 regras com um exemplo real do erro que ela previne. Marca as que mapeiam pra erros que você já viu.

→

03-versao-prototype.md

Variante · Projeto em fase inicial

Pesos ajustados pra prototype: prioriza velocidade de iteração sem comprometer princípios não-negociáveis.

→

03-versao-production.md

Variante · Código em produção

Inclui 4 regras adicionais (13-16): feature flag, rollback, monitoring, never break Friday.

→

03-versao-monorepo.md

Variante · Monorepo com múltiplos estilos

Hierarquia de CLAUDE.md raiz + por pacote, regras de boundary entre módulos, padrões compartilhados vs locais.

→