آپ اپنے پروجیکٹ کے کوڈنگ کنونشنز پر عمل درآمد کرنے کے لیے AI اسسٹنٹ کو کیسے مجبور کرتے ہیں؟

Question

Accepted Answer

AI بطور ڈیفالٹ اپنے ڈیٹا میں سے عام اوسط استعمال کرتا ہے، اس لیے اپنا **انداز** حاصل کرنے کے لیے آپ کو اسے **دکھانا اور نافذ کرنا** ہوگا — مثالوں، ایک واضح rules فائل، اور ایک linter loop کے ذریعے جو ان چیزوں کو پکڑے جو رہ جاتی ہیں۔ اس پر بھروسہ نہ کریں کہ یہ آپ کے معیارات کا اندازہ لگایا گا (WordPress Coding Standards، PSR-12، وغیرہ)۔

## تکنیکیں (leverage کی ترتیب میں)

- **Linter config اور مثالیں فراہم کریں** — اپنا `.eslintrc`، `phpcs.xml`، یا `.editorconfig` پیسٹ کریں۔ یہ machine-checkable شکل میں قواعد ہیں، اور AI انہیں پڑھ سکتا ہے۔
- **ایک rules/instructions فائل رکھیں** — ایک `CLAUDE.md` یا system prompt جو معیار کو واضح طور پر بیان کرے: "یہ پروجیکٹ **PSR-12** کی پیروی کرتا ہے۔ 4-space indent استعمال کریں، functions کے لیے next line پر braces، hooks کے لیے snake_case۔" Standing instructions آپ کو ہر prompt میں اپنے آپ کو دہرانے سے بہتر ہے۔
- **نمائندہ موجودہ کوڈ دکھائیں** — ایک یا دو صاف فائلیں naming، structure، اور idioms کو کسی وضاحت سے زیادہ تیزی سے سکھاتی ہیں۔ AI جو دیکھتا ہے اس سے pattern-matching کرتا ہے۔
- **AI output پر linter چلائیں اور غلطیاں واپس فیڈ کریں** — سب سے قابل اعتماد قدم۔ Linter ground truth ہے؛ اس کی غلطیاں paste کریں اور AI سے انہیں ٹھیک کرنے کو کہیں۔

## Linter loop

```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 تیزی سے converge کرتا ہے کیونکہ linter precise، line-level feedback دیتا ہے جو AI براہ راست کام کر سکتا ہے، بجائے اس کے کہ آپ style کو prose میں بیان کریں۔

## اہمیت

وہ کوڈ جو پروجیکٹ conventions کو نظر انداز کرتا ہے **review friction اور inconsistency** پیدا کرتا ہے حتیٰ کہ جب یہ functionally صحیح ہے — reviewers کو formatting پر وقت ضائع ہوتا ہے، اور codebase بہتر ہوتا ہے۔ AI کو آپ کے house style کی کوئی آگاہی نہیں ہے جب تک آپ اسے فراہم نہ کریں، اس لیے کام یہ ہے کہ rules کو **واضح اور checkable** بنایا جائے: intent کے لیے ایک rules فائل، idioms کے لیے نمائندہ کوڈ، اور loop میں linter کو enforcer کے طور پر۔ یہی discipline (config + examples + automated check) ہے جس سے آپ کسی انسانی teammate کو اپنے conventions میں onboard کرتے ہیں۔