Padrões de Codificação YLF
Use isso apenas para a tarefa atual. Para tornar esses padrões persistentes em um projeto, use ylf-project-instructions.
Este skill é propositalmente curto. Adapte-se lendo o projeto atual, não carregando todas as regras do projeto dentro deste arquivo.
Processo
-
Defina a conclusão.
- Declare o resultado concreto e como você irá verificá-lo.
- Para trabalhos não triviais, mantenha uma pequena lista de verificação e atualize-a conforme avança.
- Conclusão significa que o resultado solicitado está funcionando, verificado onde possível e claramente reportado.
-
Adapte-se ao projeto.
- Leia primeiro as instruções ativas do projeto:
AGENTS.md,CLAUDE.md, arquivos README, scripts de pacote, configuração de teste e código próximo. - As regras do projeto substituem este skill. Este skill preenche lacunas sobre como trabalhar.
- Siga padrões existentes, dependências, nomenclatura, layout de arquivos e comandos de verificação.
- Prefira uma dependência madura do projeto ou um pacote open-source bem mantido em vez de uma implementação personalizada quando essa for a solução normal.
- Leia primeiro as instruções ativas do projeto:
-
Esclareça apenas quando importa.
- Se a tarefa é clara e de baixo risco, prossiga.
- Pare e pergunte antes de escolhas de alto impacto: arquitetura, formato de dados, serviços externos, ações destrutivas, refatorações amplas ou escopo ambíguo.
- Ao perguntar, dê sua resposta recomendada e a compensação.
-
Mude cirurgicamente.
- Faça a menor alteração que satisfaça a solicitação.
- Não refatore, reformate, renomeie ou limpe código adjacente a menos que a tarefa exija.
- Remova apenas código não utilizado que sua própria alteração criou.
- Se uma correção começar a se propagar para arquivos não relacionados, pare e explique o limite antes de continuar.
-
Verifique de verdade.
- Bugs: reproduza primeiro quando possível, depois prove a correção.
- Scripts: execute com entrada representativa e inspecione a saída.
- Web/UI: abra a página, verifique a renderização e exercite o fluxo alterado.
- Implantações e integrações: verifique o serviço ao vivo ou o painel de controle quando houver acesso.
- Se a verificação completa for bloqueada por ruído ambiental existente, execute a verificação mais restrita que ainda prove o resultado solicitado e diga o que permanece não verificado.
-
Mantenha limites de segurança.
- Não execute ações git a menos que o usuário peça explicitamente.
- Não exclua arquivos ou diretórios em lote. Exclua apenas um caminho de arquivo explícito por vez. Se for necessária exclusão em massa, pare e peça ao usuário para lidar com isso.
- Não exponha segredos. Tudo bem verificar se um segredo existe ou se um nome corresponde.
- No Windows, separe ruídos ambientais como bloqueios de arquivo, problemas de pnpm sem TTY ou artefatos de build desatualizados da correção da alteração.
-
Reporte de forma simples.
- Diga ao usuário o que você alterou, qual é o resultado e o que foi verificado.
- Mencione apenas itens não resolvidos que realmente permanecem.
- Mantenha detalhes de implementação fora do relatório final, a menos que o usuário os solicite.
Poda
Ao atualizar este skill, mantenha cada regra se ela mudar o comportamento. Exclua exemplos longos, tutoriais de ferramentas e fatos específicos do projeto. Esses pertencem a instruções do projeto ou skills separados.