Estrutura
Esta skill orienta onde o código de frontend deve ficar: convenções de pastas, nomenclatura e o que marca um arquivo como mal colocado. As convenções acompanham o código, portanto a lista autoritativa está em reference.md — leia antes de colocar um arquivo.
Passos
- Pergunte o que é o arquivo, não onde ele se encaixa. Componente, hook, utilitário, teste, ativo, config. O tipo determina a colocação; o tipo é uma palavra inicial para as convenções em reference.md. Feito quando: o tipo é indicado em uma palavra.
- Coloque pelas regras, unidades inteiras de cada vez. Um componente se move com seu teste, história e estilos — nunca o componente sozinho. Feito quando: a colocação corresponde exatamente às regras; qualquer desvio de nomenclatura é listado no final da execução com um motivo.
- Confirme a nomenclatura em relação aos vizinhos. O nome corresponde aos arquivos irmãos e à convenção geral: singular/plural, separação por ponto, capitalização. Feito quando: a listagem do diretório parece uniforme; nada precisa ser renomeado para se integrar.
Referência
- reference.md — as regras de colocação e convenções de nomenclatura. Atualize quando a estrutura do repositório se estabilizar; é a única fonte da verdade, e convenções declaradas em qualquer outro lugar são locais próximos deste arquivo.
- Quando duas regras parecem conflitar, a mais específica vence, e o conflito é reportado para que as regras possam ser corrigidas.