Come si fa in modo che un assistente AI segua le convenzioni di codifica del tuo progetto?

Question

Accepted Answer

Un AI utilizza per impostazione predefinita una media generica dei suoi dati di addestramento, quindi per ottenere **il tuo** stile devi **mostrarlo e applicarlo** — attraverso esempi, un file di regole esplicito e un ciclo di linter che catturi quello che sfugge. Non fare affidamento sul fatto che indovini i tuoi standard (WordPress Coding Standards, PSR-12, ecc.).

## Tecniche (in ordine di impatto)

- **Fornisci la config del linter e degli esempi** — incolla il tuo `.eslintrc`, `phpcs.xml`, o `.editorconfig`. Queste sono le regole in forma verificabile dalla macchina, e l'AI può leggerle.
- **Mantieni un file di regole/istruzioni** — un `CLAUDE.md` o un system prompt che dichiara esplicitamente lo standard: "Questo progetto segue **PSR-12**. Usa indentazione a 4 spazi, parentesi graffe sulla riga successiva per le funzioni, snake_case per gli hook." Le istruzioni permanenti battono il ripetersi ogni prompt.
- **Mostra codice esistente rappresentativo** — uno o due file puliti insegnano naming, struttura e idiomi più velocemente di qualsiasi descrizione. L'AI fa pattern-matching su quello che vede.
- **Esegui il linter sull'output dell'AI e restituisci gli errori** — il passo più affidabile. Il linter è la fonte di verità; incolla i suoi errori e chiedi all'AI di correggerli.

## Il ciclo del 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.
```

Questo ciclo converge rapidamente perché il linter fornisce feedback preciso a livello di riga su cui l'AI può agire direttamente, invece di farti descrivere lo stile in prosa.

## Perché è importante

Il codice che ignora le convenzioni del progetto crea **attrito nelle review e inconsistenza** anche quando è funzionalmente corretto — i revisori perdono tempo sulla formattazione, e la codebase si disperde. Un AI non ha consapevolezza del tuo house style a meno che non lo fornisci, quindi il lavoro è rendere le regole **esplicite e verificabili**: un file di regole per l'intento, codice rappresentativo per gli idiomi, e il linter come applicatore nel ciclo. La stessa disciplina (config + esempi + verifica automatizzata) è come si inserisce un collega umano alle tue convenzioni, anche.