Cadastrar e usar style guides

As regras de código são os padrões que o seu time combinou. Cadastradas aqui, a análise de IA passa a consultá-las — e para de sugerir mudanças que contrariam o que o time já decidiu.

Cadastrar e usar style guides0:38

Cadastre um style guide

1. Abra Desenvolvimento → Regras de Código.
2. Clique em Adicionar Guia. O botão abre três caminhos:
   • Formulário — criar manualmente, preenchendo os campos.
   • Carregar arquivo — importar de um arquivo que você já tem.
   • Com IA — gerar a regra a partir do que você descrever.
3. Escolha o caminho e preencha o conteúdo da regra.
4. Salve.

Para confrontar o código com o guia, peça uma análise do tipo Conformidade com Style Guide (veja rodar-analise-ia). Os achados que contrariam o guia aparecem no relatório junto com os demais.

Dica

Comece com 1 a 3 style guides curtos e diretos. Guias longos confundem a IA. O ideal é 1 a 2 páginas por linguagem.

Erros comuns

Texto contraditório — se o guia diz “use X” e “evite X”, a IA ignora parte. Revise a coerência antes de salvar.

Categoria errada — guia cadastrado na categoria errada some na hora de procurar. Use também as tags.

Muitos guias sobrepostos — vários guias dizendo a mesma coisa de formas diferentes confundem a análise. Mantenha um guia geral e, no máximo, um específico.

Não atualizar guia após decisão do time — guia desatualizado gera achados que o time vai ignorar. Sincronize após RFCs internas.

Esquecer de referenciar no relatório — ao ler o relatório, o link para o style guide é a primeira coisa a abrir. Confirme se a análise aplicou o guia.