Como fazer um assistente de IA seguir as convenções de codificação do seu projeto?

Question

Accepted Answer

Uma IA padroniza para uma média genérica dos seus dados de treinamento, então para obter **seu** estilo você deve **mostrar e reforçar** — através de exemplos, um arquivo de regras explícito e um loop de linter que capte o que passa despercebido. Não confie em sua capacidade de adivinhar seus padrões (WordPress Coding Standards, PSR-12, etc.).

## Técnicas (em ordem de impacto)

- **Forneça a configuração do linter e exemplos** — cole seu `.eslintrc`, `phpcs.xml` ou `.editorconfig`. Estas são as regras em forma verificável por máquina, e a IA pode lê-las.
- **Mantenha um arquivo de regras/instruções** — um `CLAUDE.md` ou system prompt que declare o padrão explicitamente: "Este projeto segue **PSR-12**. Use indent de 4 espaços, chaves na linha seguinte para funções, snake_case para hooks." Instruções permanentes superam repetir-se a cada prompt.
- **Mostre código representativo existente** — um ou dois arquivos limpos ensinam nomenclatura, estrutura e idiomas mais rápido que qualquer descrição. A IA reconhece padrões no que vê.
- **Execute o linter na saída da IA e retorne os erros** — o passo mais confiável. O linter é a verdade fundamental; cole seus erros e peça à IA para corrigi-los.

## O loop do linter

```bash
# 1. AI generates the change, then you run the project linter on it:
phpcs --standard=phpcs.xml src/NewClass.php
# => src/NewClass.php  12 | ERROR | Expected 1 space after FUNCTION keyword; 0 found
#    src/NewClass.php  14 | ERROR | Line indented incorrectly; expected 4 spaces, found 2

# 2. Paste those exact errors back to the AI: "Fix these phpcs errors."
# 3. Re-run until clean. The linter — not the AI's claim — is the source of truth.
```

Este loop converge rapidamente porque o linter fornece feedback preciso em nível de linha que a IA pode agir diretamente, em vez de você descrever o estilo em prosa.

## Por que isso importa

Código que ignora convenções do projeto cria **fricção na revisão e inconsistência** mesmo quando está funcionalmente correto — revisores perdem tempo com formatação e a base de código diverge. Uma IA não tem consciência do seu estilo de casa a menos que você o forneça, então o trabalho é tornar as regras **explícitas e verificáveis**: um arquivo de regras para intenção, código representativo para idiomas e o linter como executor no loop. A mesma disciplina (configuração + exemplos + verificação automatizada) é como você integra um colega humano às suas convenções também.