Forward Implementation First کیا کرتا ہے
Forward Implementation First ایک ایجنٹ اسکل ہے جو کوڈنگ ایجنٹس کو پائپ لائن کی دفتری کارروائیوں میں پھنسنے سے روکنے کے لیے تیار کیا گیا ہے۔ یہ توجہ مطلوبہ پروڈکٹ بنانے، متاثرہ رویے کی جانچ کرنے اور آگے بڑھنے پر مرکوز رکھتا ہے، بجائے اس کے کہ بار بار ہیشز، رسیدوں، لاکس، ڈیش بورڈز یا پیش رفت کے نشانات کی مرمت کی جائے۔
یہ پروجیکٹ بنیادی طور پر تقریباً 150 سطروں پر مشتمل Markdown اسکل ہے جس میں YAML فرنٹ میٹر موجود ہے۔ یہ Agent Skills convention کی پیروی کرتا ہے اور ماڈل، ٹول اور ڈومین سے آزاد ہے۔
یہ اسکل خاص طور پر طویل مدتی ورک فلو میں مفید ہے جہاں ایک آرکیسٹریٹر ترتیب وار مراحل کے لیے میٹا ڈیٹا درج کرتا ہے۔ جب یہ میٹا ڈیٹا پرانا ہو جائے تو ایجنٹ اس عدم مطابقت کو اس بات کا ثبوت سمجھ سکتا ہے کہ پہلے درست نتائج غلط ہیں۔ Forward Implementation First ایک فیصلہ کن اصول فراہم کرتا ہے جو حقیقی درستی کے کام کو انتظامی دیکھ بھال سے الگ کرتا ہے۔
بنیادی درجہ بندی
کوئی کارروائی کرنے سے پہلے ایجنٹ اسے تین میں سے ایک زمرے میں شامل کرتا ہے۔
- معنوی نفاذ: ایسا کام جو کسی پروڈیوسر، کنزیومر، اڈاپٹر، رن ٹائم پاتھ، اسکیما، فکسچر یا حتمی آؤٹ پٹ کو بناتا یا جوڑتا ہے۔
- مرکوز توثیق: ایسی جانچ جو تبدیل شدہ انحصاری دائرے کا جائزہ رویے، اسکیما، تعداد، ترتیب وار نمونوں، تحفظ، مطابقت، عدم اختصار اور وقت یا میموری کی پیمائش کے ذریعے لیتی ہے۔
- انتظامی دفتری کارروائی: ایسا کام جو ہیشز، لاکس، رسیدوں، ڈیش بورڈز، تصدیقی نشانات، پیش رفت کے میٹا ڈیٹا یا صرف موجودگی کے ریکارڈز بناتا یا درست کرتا ہے۔
عملی اصول سادہ ہے: معنوی نفاذ اور مرکوز توثیق انجام دیں۔ انتظامی دفتری کارروائی کو چھوڑ دیں، جب تک صارف خاص طور پر اس کی درخواست نہ کرے یا وہ آرٹیفیکٹ پروڈکٹ کا حصہ نہ ہو۔ اگر صرف دفتری کارروائی پر مبنی کوئی انحصار درستگی کے تحفظ کے بغیر مفید کام کو روکے، تو اس انحصار کو ختم کریں۔
پائپ لائن کی دفتری کارروائی مسئلہ کیوں بنتی ہے
ایک ایسی پائپ لائن پر غور کریں جس میں مرحلہ 40، مرحلہ 41 کے لیے ایک فائل بناتا ہے۔ آرکیسٹریٹر ایک JSON ریکارڈ بھی لکھتا ہے جس میں تکمیل کا نشان اور ان پٹ ہیش شامل ہوتا ہے۔ اگر پروڈیوسر تبدیل ہو جائے تو ہیش مزید مطابقت نہیں رکھ سکتا، حالانکہ موجودہ مرحلے کا آؤٹ پٹ بدستور درست ہو سکتا ہے۔
واضح پالیسی کے بغیر، ایجنٹ بہت سے پہلے کے مراحل کو غیر معتبر قرار دے سکتا ہے، مرحلہ 41 کو دستی طور پر چلانے سے انکار کر سکتا ہے، غیر متعلقہ نشانات دوبارہ بنا سکتا ہے اور درست کیے گئے میٹا ڈیٹا کو پیش رفت کے طور پر رپورٹ کر سکتا ہے۔ ہر مقامی فیصلہ محتاط دکھائی دے سکتا ہے، لیکن مجموعی نتیجہ مطلوبہ آؤٹ پٹ کو بہتر بنائے بغیر وقت صرف کرتا ہے۔
انتظامی میٹا ڈیٹا اس ثبوت کا متبادل نہیں کہ آؤٹ پٹ درست ہے۔
یہ اسکل ایجنٹس سے میٹا ڈیٹا کی موجودگی یا تازگی کو ثبوت سمجھنے کے بجائے نتائج کی توثیق کا تقاضا کر کے اس ناکامی کو روکتا ہے۔
اسکل کن چیزوں میں نرمی نہیں کرتا
Forward Implementation First درستگی کو نظر انداز کرنے کی ترغیب نہیں ہے۔ یہ عارضی آرکیسٹریشن ریکارڈز کو انٹیگریٹی میکانزمز اور ایسے شواہد سے الگ کرتا ہے جو واقعی پروڈکٹ کا تحفظ کرتے ہیں۔
- پروڈکٹ کی سالمیت لازمی رہتی ہے۔ صارفین کے ذریعے تصدیق کیے جانے والے چیک سمز، مطلوبہ دستخط اور آؤٹ پٹ کنٹریکٹ میں متعین ہیشز کاغذی کارروائی نہیں بلکہ پروڈکٹ کی خصوصیات ہیں۔
- ان پٹ اور نظرثانی کی شناخت لازمی رہتی ہے۔ ایجنٹ کو معلوم ہونا چاہیے کہ وہ کس ورژن یا ہدف میں تبدیلی کر رہا ہے۔
- نتیجہ مرکوز ٹیسٹس لازمی رہتے ہیں۔ بینچ مارکس، ری پروڈکشنز، ٹیسٹس اور اینڈ ٹو اینڈ رنز اب بھی ضروری ثبوت فراہم کرتے ہیں۔
- کوریج نتیجہ نہیں ہے۔ کسی پاتھ کو چلانا اس بات کا ثبوت نہیں کہ اس پاتھ نے درست جواب پیدا کیا۔
کمانڈ، ان پٹ، نتیجے اور جانچے گئے توقعی معیار پر مشتمل ایگزیکیوشن ریکارڈ حقیقی ثبوت ہو سکتا ہے۔ اگر یہ موجود نہ ہو تو ایجنٹ وہ دعویٰ نہیں کر سکتا جس کی تائید یہ ریکارڈ کرتا۔ تاہم، اس کی عدم موجودگی پائپ لائن کے پہلے کے غیر متعلقہ مراحل کو خودکار طور پر غیر معتبر نہیں بناتی۔
انسٹالیشن
دریافت شدہ ایجنٹ اسکل ڈائریکٹریز میں انسٹال کریں
ریپوزٹری کلون کریں اور شامل کردہ انسٹالیشن اسکرپٹ چلائیں:
git clone https://github.com/Vuk97/forward-implementation-first
cd forward-implementation-first
./install.shاسکرپٹ ہر اس معاون ایجنٹ اسکل ڈائریکٹری میں SKILL.md نقل کرتا ہے جس کا اسے پتا چلتا ہے۔ دستاویزی مقامات یہ ہیں:
- Claude Code:
~/.claude/skills/forward-implementation-first/ - Codex:
~/.codex/skills/forward-implementation-first/ - مشترکہ کنونشن:
~/.agents/skills/forward-implementation-first/
ایک پروجیکٹ کے لیے انسٹال کریں
پروجیکٹ تک محدود رویے کے لیے اسکل ڈائریکٹری کو ریپوزٹری کے اندر .claude/skills/ یا .agents/skills/ میں نقل کریں۔ اس طرح پالیسی ہر ورک اسپیس میں انسٹال ہونے کے بجائے اسی پروجیکٹ سے وابستہ رہتی ہے۔
انسٹالیشن کے بعد ایجنٹ دوبارہ شروع کریں۔ موجودہ سیشنز اسکلز کو خودکار طور پر دوبارہ لوڈ نہیں کرتے۔
اسکل ایک تجویز ہے اور ماڈل فیصلہ کرتا ہے کہ اسے لوڈ کرنا ہے یا نہیں۔ اگر آپ کا ایجنٹ ہمیشہ فعال رہنے والے قواعد یا ہُکس کی معاونت کرتا ہے تو بنیادی فیصلہ کن اصول وہاں بھی رکھیں۔
بنیادی استعمال
مرحلہ 1: اگلی پروڈکٹ سے متعلق کارروائی کی شناخت کریں
موجودہ پائپ لائن کرسر یا اگلے نامکمل انحصار سے آغاز کریں۔ پوچھیں کہ آیا مجوزہ کارروائی نفاذ کو تبدیل کرتی ہے، تبدیل شدہ نتیجے کی توثیق کرتی ہے یا صرف آرکیسٹریشن میٹا ڈیٹا کی مرمت کرتی ہے۔
مجوزہ کارروائی: مرحلہ 41 کو مرحلہ 40 کے تیار کردہ آؤٹ پٹ سے جوڑیں۔
درجہ بندی: معنوی نفاذ۔
فیصلہ: کارروائی انجام دیں۔مرحلہ 2: تبدیل شدہ انحصاری دائرے کی توثیق کریں
عمل درآمد کے بعد، اس سب سے چھوٹے حصے کی جانچ کریں جو متاثر ہو سکتا تھا۔ مناسب جانچ میں اسکیما، قطاروں یا آئٹمز کی تعداد، ترتیب وار نمونے، تحفظ کی خصوصیات، مطابقت، کٹاؤ کی نشاندہی، آخر سے آخر تک رویہ، اور وسائل کے استعمال کی پیمائش شامل ہو سکتی ہے۔
مجوزہ کارروائی: اس کے پروڈیوسر کو تبدیل کرنے کے بعد مرحلہ 41 کے اسکیما، آؤٹ پٹ کی تعداد، ترتیب وار نمونوں،
اور عدمِ کٹاؤ کی تصدیق کریں۔
درجہ بندی: مرکوز توثیق۔
فیصلہ: جانچیں انجام دیں اور شواہد درج کریں۔مرحلہ 3: حسابی ریکارڈ کو طے شدہ مقصد کے طور پر مسترد کریں
اگر واحد مجوزہ کارروائی پرانی رسید یا تکمیل کے نشان کو دوبارہ بنانا ہو، تو اسے چھوڑ دیں، جب تک صارف نے اس نوادرات کی درخواست نہ کی ہو یا یہ خود فراہم کردہ نتیجے کا حصہ نہ ہو۔
مجوزہ کارروائی: غیر تبدیل شدہ مراحل 12 تا 40 کے لیے تکمیل کی رسیدیں دوبارہ بنائیں۔
درجہ بندی: انتظامی حساب کتاب۔
فیصلہ: صرف واضح درخواست یا پروڈکٹ کی ضرورت کی صورت میں انجام دیں۔مرحلہ 4: صرف انتظامی رکاوٹیں ہٹائیں
اگر کوئی پرانا نشان اگلے درست مرحلے کو چلنے سے روکتا ہو، لیکن درستگی کا تحفظ نہ کرتا ہو، تو مرحلہ دستی طور پر چلائیں، اس کے آؤٹ پٹ کی توثیق کریں، اسے شائع کریں، اور کرسر سے آگے جاری رکھیں۔ پھر صرف انتظامی انحصار کو ہٹا دیں تاکہ یہی رکاوٹ دوبارہ پیدا نہ ہو۔
آگے بڑھتے کرسر کا اصول نافذ کریں
مکمل شدہ مرحلے کو صرف اسی وقت دوبارہ چلایا یا واپس کیا جانا چاہیے جب اس کی کوئی بنیادی وجہ ہو۔ اس مہارت کے مطابق درج ذیل وجوہات قابلِ قبول ہیں:
- مرحلے کے ان پٹ کا مفہوم تبدیل ہو گیا ہو۔
- ہدف یا پن شدہ نظرثانی تبدیل ہو گئی ہو۔
- آؤٹ پٹ ناقص، کٹا ہوا، عدمِ تحفظ کا حامل، غیر مستقل، یا اپنے صارف کے ساتھ غیر مطابقت رکھتا ہو۔
- مشاہدہ شدہ رن پہلے کے جامد نتیجے کو غلط ثابت کرتا ہو۔
- تبدیل شدہ پروڈیوسر کے اعلان کردہ انحصاری دائرے میں یہ مرحلہ شامل ہو۔
غائب یا پرانا میٹا ڈیٹا بذاتِ خود کافی وجہ نہیں ہے۔ مکمل تاریخ کو دوبارہ شروع کرنے کے بجائے، متاثرہ انحصاری دائرے کے سب سے چھوٹے حصے کو دوبارہ چلائیں۔
بحالی کے فیصلے کی مثال
مشاہدہ: مرحلہ 40 کی رسید کا ہیش پرانا ہے۔
آؤٹ پٹ کی جانچ: مرحلہ 40 کا آرٹیفیکٹ درست ساخت رکھتا ہے اور مرحلہ 41 کے ساتھ مطابقت رکھتا ہے۔
انحصار کی جانچ: تبدیل شدہ پروڈیوسر مرحلہ 40 کے مفہوم کو متاثر نہیں کرتا۔
کارروائی: مرحلہ 40 کو دوبارہ نہ چلائیں۔ مرحلہ 41 تک جاری رہیں اور اس کے نتیجے کی توثیق کریں۔اگر توثیق کے دوران ناقص یا غیر مطابقت رکھنے والا آؤٹ پٹ ملے، تو دوبارہ چلانا جائز ہے کیونکہ وجہ انتظامی نہیں بلکہ معنوی ہے۔
متصادم سچائیاں پیدا کیے بغیر ورکر پولز استعمال کریں
یہ مہارت متوازی کام کے لیے ایک منظم طریقہ بھی متعین کرتی ہے۔
- ایک وقت میں صرف ایک بھاری عمل چلائیں، جیسے کمپائلر، مکمل ٹیسٹ سوٹ، بڑا ڈیٹا جاب، بینچ مارک، یا طویل اسکین۔
- غیر متداخل فائلوں پر ہلکے کام کے لیے متوازی راستے استعمال کریں۔
- جب
Nورکرز کا پول مجاز ہو، تو مکمل مرحلے کا انتظار کرنے کے بجائے راستے مکمل ہوتے ہی دوبارہ پُر کریں۔ - ہر ورکر کو مصروف رکھنے کے لیے کم قدر والے کام ایجاد نہ کریں۔
- بھاری عمل درآمد، اشاعت، کرسر کی حرکت، اور حتمی نتائج کو مرکزی راستے میں رکھیں۔
- متوازی ورکرز کو تیاری اور معائنہ کرنے دیں، لیکن ان کے آؤٹ پٹ کو استعمال کرنے سے پہلے اس کی توثیق کریں۔
- ہر راستے کا انتظار کرتے ہوئے آگے بڑھنے کی رفتار نہ روکیں۔ جب کسی راستے کا انحصار پہنچ جائے تو اس کا نتیجہ استعمال کریں۔
یہ ساخت مفید ہم وقتی کام کی اجازت دیتی ہے، جبکہ متعدد ورکرز کو سچائی کے باہم مسابقتی ذرائع بننے سے روکتی ہے۔
اعلیٰ درجے کی تجاویز
فیصلے کا اصول ہمیشہ فعال ترتیب میں منتقل کریں
چونکہ کوئی ماڈل کسی مہارت کو لوڈ نہ کرنے کا انتخاب کر سکتا ہے، اس لیے مستقل قواعد یا ہُکس والے ماحول میں مرکزی پالیسی کو وہاں بھی دہرایا جانا چاہیے: ہر کارروائی کی درجہ بندی کریں، عمل درآمد اور مرکوز توثیق انجام دیں، اور انتظامی کام سے گریز کریں جب تک کہ اس کی درخواست نہ کی گئی ہو یا وہ پروڈکٹ سے متعلق نہ ہو۔
پروڈکٹ کی سالمیت واضح طور پر متعین کریں
دستاویزی شکل میں درج کریں کہ کون سے ہیش، دستخط، مینی فیسٹ، یا آڈٹ ریکارڈ آؤٹ پٹ معاہدے کا حصہ ہیں۔ اس سے ایجنٹ حقیقی خصوصیات کو غلطی سے رد کرنے سے بچے گا، جبکہ غیر ضروری آرکیسٹریشن نشانات کو نظر انداز کرنے کی اجازت برقرار رہے گی۔
انحصاری دائرے بیان کریں
جہاں ممکن ہو، پروڈیوسر اور صارف کے تعلقات کو واضح طور پر بیان کریں۔ ایک واضح انحصاری دائرہ ایجنٹ کو صرف متاثرہ مراحل کو دوبارہ چلانے میں مدد دیتا ہے اور غیر یقینی کی بنیاد پر وسیع پیمانے کی تنسیخ سے بچاتا ہے۔
محض موجودگی نہیں، شواہد درج کریں
ایسے ریکارڈز کو ترجیح دیں جو کمانڈ، ان پٹ، نتیجے، اور متوقع شرط کی شناخت کریں۔ صرف موجودگی کا نشان بتاتا ہے کہ کچھ چلایا گیا؛ شواہد رکھنے والا ریکارڈ یہ ثابت کرنے میں مدد دیتا ہے کہ وہ کامیاب بھی ہوا یا نہیں۔
تیاری اور اختیار کو الگ رکھیں
فائلوں کا معائنہ کرنے، پیچز تیار کرنے، یا معلومات جمع کرنے کے لیے متوازی ورکرز استعمال کریں، لیکن عمل درآمد کا اختیار اور نتائج مرکزی راستے کے لیے محفوظ رکھیں۔ ورکر کے آؤٹ پٹ کو ضم یا شائع کرنے سے پہلے اس کی توثیق کریں۔
یہ مہارت کب استعمال کریں
Forward Implementation First ان صورتوں کے لیے موزوں ہے:
- ترتیب وار مراحل اور محفوظ شدہ کرسر والی پائپ لائنز۔
- بعد کے مراحل کے ذریعے استعمال کیے جانے والے تیار کردہ آرٹیفیکٹس۔
- آرکیسٹریٹر کے تیار کردہ مینی فیسٹ، لاک فائلز، یا رسیدوں والے ورک فلو۔
- ایسے رنز جو مسلسل انسانی نگرانی کے بغیر جاری رہتے ہیں۔
- متعدد ایجنٹس یا سیشنز کے ذریعے تبدیل کی جانے والی ریپوزٹریز۔
- ETL پائپ لائنز، مرحلہ وار ڈیٹا پراسیسنگ، بڑی کوڈ مائیگریشنز، بلڈ اور ریلیز ورک فلو، دستاویزات کی تیاری، بیچ تجزیہ، اور کئی روزہ روڈ میپس۔
اسے یک مرحلہ کاموں، مختصر تعاملی سیشنز، یا ایسے ورک فلو کے لیے چھوڑ دیں جہاں آڈٹ ٹریل خود فراہم کردہ نتیجہ ہو۔ اگر صارفین یا جائزہ لینے والوں سے رسیدیں استعمال کرنے کی توقع ہو، تو یہ ریکارڈز انتظامی بوجھ کے بجائے پروڈکٹ کا حصہ ہیں۔
نتیجہ
Forward Implementation First کوڈنگ ایجنٹس کو ایک محدود مگر عملی طریقۂ کار فراہم کرتا ہے: پروڈکٹ تیار کریں، متاثرہ رویے کی توثیق کریں، اور پائپ لائن کے کاغذی کام کو درستگی نہ سمجھیں۔ اس کا فارورڈ کرسر اصول غیر ضروری دوبارہ عمل درآمد کو محدود کرتا ہے، جبکہ اس کی ورکر پول رہنمائی محفوظ متوازی عمل درآمد میں مدد دیتی ہے۔ اس اسکل کو انسٹال کریں، ایجنٹ کو دوبارہ شروع کریں، اور دستیاب ہونے پر ہمیشہ فعال کنفیگریشن کے ذریعے اس کے فیصلہ سازی کے اصول کو مضبوط بنائیں۔