Kif tagħmel li l-assistant AI isegwi l-konvenzjonijiet tal-kodifikazzjoni tal-proġett tiegħek?

Question

Accepted Answer

AI bi default juża medja ġenerika tad-data tal-taħriġ tiegħu, għalhekk biex tinkiseb **l-istil tiegħek** inti trid **turu u timponihom** — permezz ta' eżempji, fail ta' regoli esplisiti, u loop ta' linter li jimqabbeż dak li jaħrab. Tiddependi mhux fuq AI biex iguess il-standards tiegħek (WordPress Coding Standards, PSR-12, eċċ.).

## Tekniki (fl-ordni tal-leverage)

- **Ipprovdi l-config tal-linter u eżempji** — iltaħ il `.eslintrc`, `phpcs.xml`, jew `.editorconfig` tiegħek. Dawn huma r-regoli f'forma li tista' tiċċekkjahha l-magni, u l-AI tista' taqraho.
- **Żomm fail ta' regoli/istruzzjonijiet** — `CLAUDE.md` jew system prompt li jiddikjara b'mod esplisitu l-istandard: "Il-proġett dan isegwi **PSR-12**. Uża indentazzjoni ta' 4 spazji, parentesi tal-linja li jmiss għal funzjonijiet, snake_case għal hooks." L-istruzzjonijiet permanenti jilbsu r-ripetizzjoni ta' tiegħek kull prompt.
- **Uri l-kod eżistenti rappreżentattiv** — fajl wieħed jew tnejn nadif jgħallmu smija, struttura, u idioms aktar mgħaġġel minn xi deskrizzjoni. AI match ta' mudell dak li juri.
- **Qabbad il-linter fuq il-output tal-AI u ibgħat lura l-iżbalji** — l-isteppt l-iktar affidabbli. Il-linter hija l-verità tal-ard; iltaħ l-iżbalji tiegħu u itlob lill-AI li tislahha.

## Loop ta' 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.
```

Hal-loop dan konverġi malajr għax il-linter tagħti feedback preċiż fil-livell tal-linji li l-AI tista' taġixxi direttament, minflok li tiddeskrivi l-istil f'proza.

## Għaliex dan importanti

Il-kodiċi li jidnegħa l-konvenzjonijiet tal-proġett joħloq **frizzjoni ta' reviżjoni u inkonsistenza** anki meta jkun korrett minn aspett funzjonali — ir-revisers joqtgħu il-ħin fuq il-formattjar, u l-codebase tidderiva. L-AI m'għandha l-ebda kuxjenza tal-istil tad-dar tiegħek jekk int ma tkun jipprovduhom, għalhekk il-ħidma hija nagħmel ir-regoli **espliċiti u verifikabbli**: fail ta' regoli għall-intenzjoni, kodiċi rappreżentattiv għall-idioms, u linter bħala l-impunjatur fil-loop. L-istess dixxiplina (config + eżempji + check awtoматiku) hija kif int tintegra member ta' tim umanu għall-konvenzjonijiet tiegħek, ukoll.