react-code-quality
Installation
SKILL.md
Qualidade de Código React
Aplique esta skill sobre o diff relevante. Ela não é um gate automático para toda implementação;
regras detalhadas e exemplos estão em references/full-guide.md.
Hard rules
- Use TypeScript strict e nunca
anyem produção; prefiraunknowncom narrowing. - Use componentes funcionais com Hooks, uma responsabilidade clara e props tipadas por
interfaceoutype; mantenha componentes em torno de 200 linhas e abaixo de 300 quando possível. - Código, nomes e comentários ficam em inglês, salvo termos de domínio documentados.
- Use
PascalCasepara componentes,camelCasepara funções/variáveis/hooks,kebab-casepara pastas ePascalCase.tsxpara componentes. - Faça cleanup de listeners, timers, subscriptions e requests em
useEffectquando aplicável. - Use
useCallback/useMemosomente com benefício demonstrável; não por hábito. - Organize imports por padrão -> externo -> interno e use aliases configurados; evite
../../../. - Não engula erros: trate estados de loading/error/empty e mostre mensagem amigável na UI.
- Evite props drilling além de dois níveis; avalie composição, Context ou estado da feature.
- Evite falsy traps como
{items.length && ...}quando0puder ser renderizado.