Kuinka saat AI-avustajan noudattamaan projektisi koodauskäytäntöjä?

Question

Accepted Answer

AI käyttää oletuksena koulutustietojensa yleistä keskiarvoa, joten saadaksesi **oman** tyylisi sinun on **näytettävä ja pakotettava** se — esimerkkien, eksplisiittisen sääntötiedoston ja linter-silmukan avulla, joka ottaa kiinni sen, mikä pääsee läpi. Älä luota siihen, että se arvaa standardeja (WordPress Coding Standards, PSR-12, jne.).

## Tekniikat (vaikutuksien mukaan järjestettynä)

- **Toimita linter-konfiguraatio ja esimerkit** — liitä `.eslintrc`, `phpcs.xml` tai `.editorconfig`. Nämä ovat sääntöjä koneellisesti tarkistettavassa muodossa, ja tekoäly voi lukea ne.
- **Pidä sääntö-/ohjeiden tiedosto** — `CLAUDE.md` tai järjestelmä-prompt, joka ilmaisee standardin nimenomaisesti: "Tämä projekti noudattaa **PSR-12**. Käytä 4-välilyönnin sisennystä, aaltosulkeita funktioden seuraavalle riville, snake_case for hooks." Pysyvät ohjeet ovat parempia kuin itsensä toistaminen jokaisen kehottamisella.
- **Näytä edustava olemassa oleva koodi** — yksi tai kaksi siistä tiedostoa opettavat nimeämisen, rakenteen ja idiomeja nopeammin kuin mikään kuvaus. Tekoäly vertaa malleja siihen, mitä se näkee.
- **Suorita linter AI-tuloksissa ja syötä virheet takaisin** — luotettavin vaihe. Linter on totuuden perusta; liitä sen virheet ja pyydä tekoälyä korjaamaan ne.

## Linter-silmukka

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

Tämä silmukka lähentyy nopeasti, koska linter antaa tarkkaa rivin tason palautetta, johon tekoäly voi toimia suoraan sen sijaan, että kuvailet tyyliä proosassa.

## Miksi se on tärkeää

Koodi, joka jättää huomiotta projektin käytäntöjä, luo **katsaukseen liittyvää kitkaa ja epäjohdonmukaisuutta** vaikka se olisi toiminnallisesti oikein — arvioijat tuhlaa aikaa muotoiluun ja koodikanta ajautuu. Tekoälyllä ei ole tietoisuutta talon tyylista, ellei sinä toimita sitä, joten työ on tehdä säännöistä **eksplisiittiset ja tarkistettavat**: sääntötiedosto tarkoitukselle, edustava koodi idiomeille, ja linter pakottajaksi silmukassa. Sama kurinalaisuus (config + esimerkit + automaattinen tarkistus) on myös kuinka otat ihmisen tiimikumppanin mukaasi käytäntöihin.