Si e bëni një asistent AI që të ndjekë konvencionet e kodimit të projektit tuaj?

Question

Accepted Answer

Një AI ka një parazgjedhje të një mesatareje gjenerike të të dhënave të trajnimit, kështu që për të marrë **stilin tuaj** duhet të **tregoni dhe zbatoni** atë — përmes shembujsh, një skedari të qartë rregullash, dhe një cikli linter-i që kalon atë që kalon përmes. Mos mblidheni në të për të marrë përsipër standardet tuaja (WordPress Coding Standards, PSR-12, etj.).

## Teknikat (sipas rendit të leverit)

- **Siguroni konfigurimin e linter-it dhe shembuj** — ngjitni `.eslintrc`, `phpcs.xml`, ose `.editorconfig`. Këto janë rregullat në formë që kontrollohen me makinë, dhe AI-ja mund t'i lexojë ato.
- **Mbani një skedar rregullash/udhëzimesh** — një `CLAUDE.md` ose mesazh sistemati që thotë standardin në mënyrë të qartë: "Ky projekt ndjek **PSR-12**. Përdorni 4 hapësira të këmbyese, kllapa në rreshtin tjetër për funksionet, snake_case për hook-et." Udhëzimet në këmbim kanë efekt më të madh sesa të përsërisni veten në çdo kërkesë.
- **Tregoni kod të përfaqësuar ekzistues** — një ose dy skedar të pastër mësojnë emërimin, strukturën dhe idioma më shpejt sesa ndonjë përshkrim. AI-ja përputhet me modelet sipas asaj që sheh.
- **Ekzekutoni linter-in në rezultatin e AI-it dhe ushqeni gabimet prapa** — hapi më i besueshëm. Linter-i është e vërteta bazë; ngjitni gabimet e tij dhe kërkojuni AI-it t'i rregullojë ato.

## Cikli i linter-it

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

Este cikli konvergon shpejt sepse linter-i jep përgjigje të saktë, në nivel rreshti, që AI-ja mund të veprojë drejtpërdrejt, në vend që ju ta përshkruani stilin në prozë.

## Pse ka rëndësi

Kodi që nuk e shqyrton konvencionet e projektit krijon **frikë rishikimi dhe pasuniformitet** edhe kur është i saktë në funksionalitet — rishikuesit shpenzojnë kohë në formatim, dhe baza e kodit zhvendoset. Një AI nuk ka vetëdije të stilit tuaj të shtëpisë përveç nëse e siguroni, kështu që puna është ta bëni rregullat **të qarta dhe të kontrollueshmëjua": një skedar rregullash për qëllimin, kod të përfaqësuar për idioma, dhe linter-i si zbatues në cikël. E njëjta disiplinë (konfigurimi + shembujt + kontroll i automatizuar) është se si ju përpiloni një bashkëpunëtor njerëzor në konvencionet tuaja, gjithashtu.