Conas a bhíonn tuiscint ag cúntóir AI ar choinbhinsiúin códúcháin do thionscadal?

Question

Accepted Answer

Tá AI ag gealadh do mheánan ghéinearálta de na sonraí oiliúna aici, agus dá bhrí sin, chun do **stíl** a fháil ní mór duit a bheith **i láthair agus a bhréagnú** — trí shampla, comhad rialacha soiléir, agus lúb linter a bhreathnaíonn ar rud a thearcéarann. Ná bíodh dóchas agat go mbéarfaidh sí do chaighdeáin (WordPress Coding Standards, PSR-12, etc.) dhuit gan tú a rá.

## Teicnící (in ord cumhachta)

- **Soláthair an chumrasc linter agus samplaí** — greamaigh do `.eslintrc`, `phpcs.xml`, nó `.editorconfig`. Is iad seo na rialacha i bhfoirm atá inchomhaireamh ag meaisín, agus is féidir leis an AI iad a léamh.
- **Coinnigh comhad rialacha/treoracha ann** — `CLAUDE.md` nó fógra córais a deir an caighdeán go soiléir: "Lean an tionscadal seo **PSR-12**. Úsáid fothógáil 4-spáis, drithinní ar an chéad líne eile do fheidhmeanna, snake_case do dheilbhí." Bítear ann do bheo isteach ionas ní bheadh ort a rá arís agus arís eile ar gach iarratas.
- **Taispeáin cód neamhdhual atá ann** — tugann comhad nó dhó glan teagasc ar ainmniúchán, struchtúr, agus idiom i bhfad níos tapa ná aon tuairisciú. Aithríonn an AI na pátrúin a fhéachann sí orthu.
- **Rith an linter ar aschur an AI agus seolann earráidí ar ais** — an chéim is iontaofa. Is é an linter an t-iomlán fírinne; greamaigh a earráidí agus iarraidh ar an AI iad a cheartú.

## An lúb 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.
```

Tagann an lúb seo le chéile go tapa toisc go soláthraíonn an linter aiseolas beacht, le fad-líne, go bhféadfaidh an AI a dhéanamh i ndiaidh a chéile, seachas thú a thuairisciú i ngnáthphrós.

## Cén fáth ar tábhachtach

Códúchán a bhréagnaíonn coinbhinsiúin an tionscadail a chruthúr **friction agus neamhréireachta i nathirt** fiú nuair is atá sé go funtúsach ceart — caithfidh na breathnóirí am a chaitheamh ar fhormáidiú, agus scaipeadh an base code. Níl aon bhraistint ag an AI ar do stíl tí mura soláthraíonn tú é, agus dá bhri sin is é an obair a bheith na rialacha **soiléir agus inphreachta**: comhad rialacha do rún, cód iomlán do idiom, agus an linter a bheidh mar chinnteachán sa lúb. Is ionann an chaoi seo (cumrasc + samplaí + seiceáil uathoibrithe) agus an dóigh a bhíonn tú a chíor do chómhghleacaí daonna do do choinbhinsiúin freisin.