Bagaimana Anda membuat asisten AI mengikuti konvensi pengkodean proyek Anda?

Question

Accepted Answer

AI secara default menjadi rata-rata generik dari data pelatihan mereka, jadi untuk mendapatkan **gaya Anda** Anda harus **menunjukkan dan memberlakukannya** — melalui contoh, file aturan eksplisit, dan loop linter yang menangkap apa pun yang terlewat. Jangan andalkan untuk menebak standar Anda (WordPress Coding Standards, PSR-12, dll.).

## Teknik (sesuai urutan dampak)

- **Sediakan konfigurasi linter dan contoh** — tempel `.eslintrc`, `phpcs.xml`, atau `.editorconfig` Anda. Ini adalah aturan dalam bentuk yang dapat diperiksa mesin, dan AI dapat membacanya.
- **Simpan file aturan/instruksi** — `CLAUDE.md` atau prompt sistem yang secara eksplisit menyatakan standar: "Proyek ini mengikuti **PSR-12**. Gunakan indentasi 4 spasi, kurung kurawal di baris berikutnya untuk fungsi, snake_case untuk hook." Instruksi berdiri menghemat Anda dari mengulangi diri setiap prompt.
- **Tunjukkan kode yang ada wajar** — satu atau dua file bersih mengajar penamaan, struktur, dan idiom lebih cepat daripada deskripsi apa pun. AI cocok dengan pola yang dilihatnya.
- **Jalankan linter pada keluaran AI dan umpankan kesalahan kembali** — langkah paling andal. Linter adalah kebenaran dasar; tempel kesalahannya dan minta AI untuk memperbaikinya.

## 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 ini bertemu dengan cepat karena linter memberikan umpan balik presisi tingkat baris yang dapat diambil AI secara langsung, alih-alih Anda mendeskripsikan gaya dalam prosa.

## Mengapa ini penting

Kode yang mengabaikan konvensi proyek menciptakan **gesekan ulasan dan ketidakkonsistenan** bahkan ketika secara fungsional benar — pengulas membuang waktu pada pemformatan, dan basis kode menyimpang. AI tidak memiliki kesadaran tentang gaya rumah Anda kecuali Anda menyediakannya, jadi pekerjaan ini adalah membuat aturan **eksplisit dan dapat diperiksa**: file aturan untuk niat, kode representatif untuk idiom, dan linter sebagai penegak dalam loop. Disiplin yang sama (config + contoh + pemeriksaan otomatis) adalah cara Anda mengarahkan rekan tim manusia ke konvensi Anda.