Unawezaje kuifanya AI assistant ifuate kanuni za uandishi wa msimbo (coding conventions) za mradi wako?

Question

Accepted Answer

AI hupendelea wastani wa jumla wa data yake ya mafunzo, kwa hivyo ili upate mtindo **wako** lazima u**onyeshe na ulazimishe** — kupitia mifano, faili la kanuni lililo wazi, na mzunguko wa linter unaokamata kile kinachopita bila kukamatwa. Usitegemee ikisie viwango vyako (WordPress Coding Standards, PSR-12, n.k.).

## Mbinu (kwa mpangilio wa nguvu)

- **Toa usanidi wa linter na mifano** — bandika `.eslintrc`, `phpcs.xml`, au `.editorconfig` yako. Hizi ni kanuni katika muundo unaoweza kukaguliwa na mashine, na AI inaweza kuzisoma.
- **Weka faili la kanuni/maelekezo** — `CLAUDE.md` au system prompt inayoeleza kiwango wazi: "Mradi huu unafuata **PSR-12**. Tumia nafasi 4 za indent, braces kwenye mstari unaofuata kwa functions, snake_case kwa hooks." Maelekezo ya kudumu ni bora kuliko kujirudia kila prompt.
- **Onyesha msimbo uliopo unaowakilisha** — faili moja au mbili safi hufundisha uitaji wa majina, muundo, na nahau haraka kuliko maelezo yoyote. AI hulinganisha mifumo ya kile inachokiona.
- **Endesha linter kwenye matokeo ya AI na urudishe makosa** — hatua ya kuaminika zaidi. Linter ndio ukweli wa msingi; bandika makosa yake na uombe AI iyarekebishe.

## Mzunguko wa 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.
```

Mzunguko huu huelekea kwenye lengo haraka kwa sababu linter hutoa maoni sahihi, ya kiwango cha mstari ambayo AI inaweza kuyatekeleza moja kwa moja, badala ya wewe kuelezea mtindo kwa maandishi.

## Kwa nini ni muhimu

Msimbo unaopuuza kanuni za mradi huleta **msuguano wa ukaguzi na kutofautiana** hata ukiwa sahihi kiutendaji — wakaguzi hupoteza muda kwenye uumbizaji, na codebase hupotea njia. AI haina ufahamu wa mtindo wa nyumba yako isipokuwa uitoe, kwa hivyo kazi ni kufanya kanuni ziwe **wazi na zinazoweza kukaguliwa**: faili la kanuni kwa nia, msimbo unaowakilisha kwa nahau, na linter kama mlazimishaji katika mzunguko. Nidhamu ile ile (usanidi + mifano + ukaguzi otomatiki) ndio jinsi unavyomwingiza mwenzako wa kibinadamu kwenye kanuni zako, pia.