Kepiye carane nggawe AI assistant nuruti konvensi koding proyek sampeyan?

Question

Accepted Answer

AI kanthi standar nggunakake rata-rata umum saka data latihan, dadi kanggo nggawe **gaya sampeyan** sampeyan kudu **nunjukake lan ngetrapake** — lumantar conto, berkas aturan eksplisit, lan loop linter sing nyekel apa sing lolos. Aja gumantung marang AI kanggo nggawe standar sampeyan (WordPress Coding Standards, PSR-12, lsp.ing).

## Teknik (miturut leverage)

- **Nekakake konfigurasi linter lan conto** — tempel `.eslintrc`, `phpcs.xml`, utawa `.editorconfig` sampeyan. Iki minangka aturan ing wujud sing bisa diperiksa mesin, lan AI bisa maca.
- **Njaga berkas aturan/instruksi** — `CLAUDE.md` utawa prompt sistem sing nyatakake standar kanthi eksplisit: "Proyek iki manut **PSR-12**. Gunakake indentasi 4 spasi, kawitan kurung ing baris sabanjuré kanggo fungsi, snake_case kanggo kait." Instruksi permanen ngalahake ngulangi dhewe saben prompt.
- **Tunjukake kode sing ana** — siji utawa rong berkas resik ngenalke jeneng, struktur, lan idiom luwih cepet tinimbang deskripsi. AI motif-cocok apa sing dideleng.
- **Mbukak linter ing output AI lan mbalekake kesalahan** — langkah paling andal. Linter minangka kasunyatan; tempel kesalahanipun lan takon AI kanggo mbenakke.

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

Loop iki konvergen kanthi cepet amerga linter menehi umpan balik tepat tingkat baris sing bisa ditindakake AI kanthi langsung, tinimbang sampeyan nerangake gaya kanthi prosa.

## Mengapa iku penting

Kode sing nglirwakake konvensi proyek nggawe **gesekan review lan ora konsisten** sanajan yen iki bener kanthi fungsional — reviewer mbuwang wektu ing format, lan codebase nyebar. AI ora ana kamanungsan babagan house style sampeyan kejaba yen sampeyan nyediakake, dadi karya yaiku nggawe aturan **eksplisit lan bisa diperiksa**: berkas aturan kanggo niyat, kode sing ana kanggo idiom, lan linter minangka penegak ing loop. Disiplin sing padha (config + conto + cek otomatis) yaiku cara onboard kanca tim manungsa marang konvensi sampeyan, uga.