AI Coding Agents کو ایک ہی غلطیاں کرنے سے روکیں

Claude Code یا Cursor جیسے AI coding agents اکثر ایک ہی غلطیاں دہراتے ہیں۔ وہ غلط test runner استعمال کرتے ہیں۔ وہ غلط import style استعمال کرتے ہیں۔ آپ چیٹ میں انہیں درست کرتے ہیں، لیکن وہ اگلے سیشن میں اس اصلاح کو بھول جاتے ہیں۔

چیٹ ہسٹری یادداشت نہیں ہے۔ جب ایک سیشن ختم ہوتا ہے، تو آپ کی کی گئی اصلاحات غائب ہو جاتی ہیں۔

اس کا حل سادہ ہے۔ اپنے قواعد (rules) ایک ایسی فائل میں لکھیں جسے ایجنٹ ہر بار چلتے وقت پڑھے۔

زیادہ تر ٹولز پروجیکٹ روٹ (project-root) کی انسٹرکشن فائلز کو سپورٹ کرتے ہیں: • Claude Code CLAUDE.md پڑھتا ہے۔ • Cursor .cursor/rules/*.mdc استعمال کرتا ہے۔ • بہت سے ٹولز AGENTS.md اسٹینڈرڈ استعمال کرتے ہیں۔

یہ فائلیں ماڈل کے کانٹیکسٹ (context) کے شروع میں شامل کر دی جاتی ہیں۔ ماڈل کے کوئی کوڈ لکھنے سے پہلے ہی یہ قواعد موجود ہوتے ہیں۔

مبہم مقاصد نہ لکھیں۔ ایجنٹ کو "clean code" لکھنے کا نہ کہیں۔ مبہم قواعد کام نہیں کرتے۔ اس کے بجائے مخصوص اور قابلِ آزمائش (testable) قواعد استعمال کریں۔

اپنی رولز فائل کے لیے اس ڈھانچے (structure) کا استعمال کریں:

• Commands: بالکل واضح کریں کہ tests اور typechecks کیسے چلانے ہیں۔ • Style: CommonJS کے مقابلے میں ESM یا defaults کے مقابلے میں named exports کو متعین کریں۔ • Boundaries: فولڈرز کو read-only کے طور پر نشان زد کریں یا یہ بتائیں کہ secrets کہاں محفوظ ہیں۔ • Definition of Done: یہ بیان کریں کہ ہر نئے فیچر کے لیے پہلے ایک ناکام ہونے والا ٹیسٹ (failing test) ہونا ضروری ہے۔

ایک اچھی رولز فائل 'scar log' کے طور پر کام کرتی ہے۔ جب بھی ایجنٹ کوئی غلطی کرے، اسی سیشن میں فائل میں ایک لائن کا قاعدہ شامل کر دیں۔

فائل کو مختصر رکھیں۔ اگر آپ کی رولز فائل بہت لمبی ہے، تو یہ ماڈل کی توجہ حاصل کرنے کے لیے آپ کے کوڈ کے ساتھ مقابلہ کرے گی۔ اگر کوئی قاعدہ 200 لائنوں سے زیادہ ہو جائے، تو اسے تراش لیں۔ وہ قواعد ہٹا دیں جن کی اب ضرورت نہیں ہے۔

یہ فرض نہ کریں کہ ایجنٹ فائل پڑھ رہا ہے۔ اسے ٹیسٹ کریں۔ ایک ایسا قاعدہ شامل کریں جو ایجنٹ سے کسی کام کے آغاز میں اپنا test command بتانے کا کہے۔ اگر وہ ایسا کرتا ہے، تو اس کا مطلب ہے کہ سسٹم کام کر رہا ہے۔

ایجنٹس کو چیٹ میں درست کرنا بند کریں۔ انہیں فائلوں کے ذریعے کنفیگر کرنا شروع کریں۔

اسے کیسے نافذ کریں:

  • اپنے پروجیکٹ روٹ میں CLAUDE.md یا AGENTS.md بنائیں۔
  • صرف مخصوص اور قابلِ جانچ (checkable) قواعد لکھیں۔
  • ہر غلطی کے فوراً بعد ایک قاعدہ شامل کریں۔
  • اسے مختصر رکھیں اور پرانے قواعد کو ہٹا دیں۔

ماخذ: https://dev.to/penloom_studio_829b7817d3/stop-your-ai-coding-agent-from-making-the-same-mistake-twice-a-claudemd-agentsmd-workflow-that-4k61

اختیاری لرننگ کمیونٹی: https://t.me/GyaanSetuAi