authoring-ruleslisted

# Rules — gerenciar rules do projeto Padroniza criacao e edicao de rules em `<projeto>/.claude/rules/`. Cada rule organiza conhecimento em 3 categorias canonicas. ## Quando usar - Criar nova rule num projeto (lib/area que ainda nao tem) - Adicionar Convention/Pattern/Gotcha a rule existente - Revisar/editar rules - Decidir se algo deve ser rule, CLAUDE.md, ou conversa pontual ## Estrutura obrigatoria de uma rule ```markdown --- paths: - "src/area/**/*.ts" --- # Titulo da Rule ## Conventions - Instrucao acionavel direta (1 linha) ## Patterns - **Nome do pattern**: Descricao curta ```typescript // exemplo de codigo curto e canonico ``` ## Gotchas - **Nome curto**: Explicacao concisa do problema e como evitar ``` ### Regras de cada secao | Secao | Obrigatoria | Formato | Conteudo | |-------|-------------|---------|----------| | `## Conventions` | Sim | `- Instrucao direta` | Como escrever codigo nessa area. Imperativo, 1 linha por item | | `## Patterns` | Se houver | `- **Nome**: ...` + codigo | Solucao reusavel com snippet. Adicionar so se aparece em 2+ lugares | | `## Gotchas` | Se houver | `- **Nome**: ...` | Armadilha que ja causou problema. Descreve o que NAO fazer e o que fazer | Outras secoes especificas de dominio sao permitidas, mas as 3 acima sao o padrao base. ## Frontmatter `paths:` Define quando a rule carrega — somente ao tocar arquivos que batem com os globs. ```yaml # BOM — especifico paths: - "src/components/**/*.tsx" - "src/pages/**/*