Cadastrar e usar style guides

Style guides são documentos de padrões de código que a IA consulta ao analisar repositórios. Cadastre seus guias para que a análise não sugira mudanças que contradigam o que o time já definiu.

Cadastrar e usar style guides0:38

Cadastre um style guide

1. Abra Desenvolvimento → Style Guides.
2. Clique em Novo.
3. Faça upload de um arquivo (PDF, Markdown) ou cole o texto no editor.
4. Defina o escopo: linguagem (TypeScript, Python, etc.) e/ou repositório.
5. Salve.

Style guides ativos são consultados automaticamente quando você roda análise IA (veja rodar-analise-ia). Achados conflitantes com o guia são marcados como “fora do padrão do time”.

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.

Escopo largo demais — aplicar guia de TypeScript a um repositório Python gera ruído. Restrinja por linguagem.

Muitos guias sobrepostos — 5 guias de Python no mesmo repositório confunde o modelo. Mantenha no máximo 1 guia geral e 1 guia 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 o guia foi aplicado.