منظور شدہ فیچر مکمل ہونے سے پہلے تین نظاموں سے گزر سکتا ہے: تقاضوں کی دستاویز، Jira ایشوز کی درجہ بندی اور ریپوزٹری۔ Claude Code مسودہ نویسی اور نفاذ میں مدد کر سکتا ہے، مگر ان نظاموں کے تعلقات کے لیے انسانی منظوری اور براہ راست جانچ ضروری ہے۔ یہ رہنما ڈویلپر یا ٹیم سربراہ کو ایک حقیقی فیچر کے مکمل عمل سے گزارتا ہے، جس میں ہر منظور شدہ اسٹوری، اس کے اصل ٹیسٹ، مجاز Jira اپ ڈیٹس اور منصوبے کی ہدایات پر نظرثانی شدہ فیصلہ شامل ہیں۔

یہ دستاویزات پر مبنی طریقہ ہے۔ BIG CHANGE نے Jira منصوبے تک رسائی نہیں لی، Claude Code نہیں چلایا، ریپوزٹری نہیں بدلی اور فیچر کی فراہمی کا وقت نہیں ناپا۔ درست ایشو اقسام، فیلڈز، ٹرانزیشنز، کمانڈز اور اخراجات آپ کے منصوبے اور اکاؤنٹ پر منحصر ہیں۔

بڑی تبدیلی

  • کیا بدلا: فیچر کو منظور شدہ تقاضے سے حقیقی Jira پیرنٹ اور ہر اسٹوری کے ذریعے جانچے ہوئے کوڈ، اصل پڑتالوں اور مجاز ایشو اپ ڈیٹس تک ٹریک کیا جا سکتا ہے۔
  • یہ کیوں اہم ہے: ایشو نقشہ، ٹیسٹ ریکارڈ اور Jira سے براہ راست دوبارہ پڑھی گئی معلومات بتاتی ہیں کہ کون سا منظور شدہ کام مکمل ہے اور کون سی اسٹوری ابھی کھلی ہے۔
  • کن باتوں پر نظر رکھیں: منصوبے کی مخصوص فیلڈز اور ٹرانزیشنز، غیر یقینی نتیجے والی تحریری کارروائیاں اور ناکام پڑتالیں انسانی حل چاہتی ہیں؛ Claude Code کی ہدایات بذات خود کام کا اختیار نہیں دیتیں۔

شروع کرنے سے پہلے

ایسا فیچر منتخب کریں جس کی تفصیل ذمہ دار مالک نے منظور کی ہو، جس کی ریپوزٹری آپ بدل سکتے ہوں اور جس کی اصل قبولیت پڑتال چلا سکیں۔ حقیقی کام کے لیے منتخب Jira Cloud منصوبے میں ایپک درجے کا ایک پیرنٹ، منظور شدہ اسٹوریز اور کسی اسٹوری کے تحت کم از کم ایک بامعنی ذیلی کام ضروری ہونا چاہیے۔ حقیقی ذیلی کام نہ ہو تو یہ مخصوص مکمل نتیجہ ابھی نامکمل ہے؛ نمائشی ایشو شامل کرنا منصوبے کو غلط پیش کرے گا۔ درخواست گزار، منظوری کا اختیار، ماخذ کی نظرثانی، جائز ڈیٹا، ابتدائی Git کمیٹ، علیحدگی یا واپسی کا راستہ اور کوڈ کا جائزہ لینے اور Jira حالت بدلنے کے مجاز شخص کو درج کریں۔

نصب شدہ ماحول میں Claude Code کا ورژن، توثیق اور اجازتیں جانچیں۔ تصدیق کریں کہ ریپوزٹری کی CLAUDE.md فائل منصوبے کی ہدایات دیتی ہے، ترمیم، کمانڈ چلانے یا ڈیٹا بھیجنے کی اجازت نہیں۔ طے کریں کہ Claude کو کون سے تقاضے اور کوڈ دیے جا سکتے ہیں، وہ کون سی کمانڈ چلا سکتا ہے اور اس فیچر کی استعمال کی حد کیا ہوگی۔ Claude Code کا استعمال سبسکرپشن کوٹا خرچ کر سکتا ہے یا فراہم کنندہ کی فیس بنا سکتا ہے؛ Anthropic کی اخراجات کی رہنمائی آپ کا بل پہلے سے طے نہیں کرتی۔

Jira میں متعلقہ ایشو اقسام دیکھنے اور بنانے، پھر مجاز صارف کے طور پر تبصرہ یا ٹرانزیشن کرنے کی اجازت لیں۔ نجی اسکرپٹ Atlassian کی دستاویز کردہ ای میل اور API ٹوکن کی ترکیب استعمال کر سکتی ہے؛ انضمام کو OAuth درکار ہو سکتا ہے۔ اسناد نجی رازوں کے ذخیرے میں رکھیں۔ انہیں پرامپٹس، ایشو متن، CLAUDE.md، لاگز یا ورژن کنٹرول میں شامل نہ کریں۔ تقاضے Jira بھیجنے سے پہلے ایشوز کی نمائش طے کریں۔

کام کے دوران سات نجی ریکارڈ رکھیں: docs/feature-prd.md، ticket-plan.json، ایشو لکھنے کا صرف اضافے کی اجازت والا روزنامچہ، ticket-map.json، ہر اسٹوری کا ایک نفاذی ثبوت، Jira اپ ڈیٹ روزنامچہ اور بعد از عمل جائزے کا فیصلہ۔ یہ آپ کے فیچر کے ریکارڈ ہیں، BIG CHANGE کی فراہم کردہ یا چلائی ہوئی فائلیں نہیں۔

1. ایک عین متعین PRD منظور کریں

Claude Code کو فیچر کی واقعی منظور شدہ تفصیل دیں اور docs/feature-prd.md کا مسودہ لکھنے سے پہلے حل طلب سوال پہچاننے کو کہیں۔ دستاویز میں درخواست گزار اور منظوری دینے والا مالک، ان پٹ کی نظرثانی، مسئلہ اور مطلوب صارف، دائرہ اور استثنا، نمبر وار تقاضوں کی ID، قبولیت کی پڑتالیں اور ان کے ثبوت کے ماخذ، غیر فعلی پابندیاں، Jira منصوبہ اور کھلے سوال ہونے چاہییں۔ ذمہ دار شخص مسودے کا اصل تفصیل سے موازنہ کرکے مواد کی ایک عین نظرثانی اور ہیش منظور کرے۔ ایشوز بنانے یا کوڈ بدلنے سے پہلے بنیادی سوال حل کریں۔

ہیش بعد کے ریکارڈ کو درست ماخذ دیتا ہے۔ PRD بدلے تو متاثرہ ٹکٹ منصوبہ اور پڑتالیں دوبارہ دیکھیں؛ نفاذ کی ناکامی قبولیت کے معیار اس طرح بدلنے کی وجہ نہیں کہ نتیجہ پاس ہو جائے۔

2. اس منصوبے کی Jira درجہ بندی اور فیلڈز معلوم کریں

مجاز اور صرف پڑھنے والی Jira REST API v3 درخواستوں سے GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes کے تمام صفحات پڑھیں۔ ہر مجوزہ ایشو قسم کے لیے GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId} کے تمام صفحات پڑھ کر تخلیق کی لازمی فیلڈز اور جائز اقدار معلوم کریں۔ Atlassian وسیع GET /issue/createmeta کارروائی کو اپنی ایشو API حوالہ دستاویز میں متروک قرار دیتا ہے۔

اس منصوبے میں ایپک کے مساوی حقیقی پیرنٹ، اسٹوری درجے کے چائلڈ اور معاونت یافتہ ذیلی کاموں کی تصدیق کریں۔ Atlassian پہلے سے طے شدہ درجہ بندی اور اس کی ترتیب بیان کرتا ہے؛ اقسام کے نام اور ID ہر جگہ ایک نہیں۔ دیکھیں کہ منصوبے کی Parent فیلڈ ہر ذیلی درجے پر کیسے کام کرتی ہے اور تخلیق کے لیے کون سی مخصوص فیلڈز یا نمائش کی ترتیبات درکار ہیں۔ منصوبہ منظور شدہ ساخت نہ دکھا سکے تو گم شدہ قسم، فیلڈ یا اجازت درج کرکے تخلیق روکیں۔ عام ایشو ربط کسی ایشو کو چائلڈ نہیں بناتا۔

3. لکھنے سے پہلے پورا ٹکٹ منصوبہ جانچیں

ہر PRD تقاضہ اور قبولیت پڑتال ticket-plan.json میں مربوط کریں۔ اس کا planVersion، PRD ہیش، Jira سائٹ اور منصوبے کی کلید، مقامی رن ID، منصوبہ منظور کرنے والا اور وقت درج کریں۔ ہر مجوزہ ایشو کے لیے منفرد مقامی ID، مطلوب پیرنٹ کی مقامی ID، معلوم ایشو قسم کی ID، منصوبے کی لازمی فیلڈز، خلاصہ، تفصیل، تقاضوں اور قبولیت کی ID، مالک اور جائز نمائش درج کریں۔ منظور شدہ کام اسٹوریز اور ذیلی کاموں کی تعداد طے کرتا ہے۔ ہر ذیلی کام اپنی حقیقی اسٹوری کے تحت اصل کام کرے۔

Jira REST v3 کئی سطروں والی ایشو تفصیل اور تبصروں کے لیے Atlassian Document Format (ADF) نامی منظم JSON دستاویز استعمال کرتا ہے۔ منظور شدہ مواد سے دستاویزات تیار کریں اور ہر درخواست بنانے سے پہلے سائٹ کا واپس کیا ہوا فیلڈ میٹاڈیٹا جانچیں۔ ایشو API تخلیق کی کارروائی بیان کرتا ہے؛ نامعلوم منصوبے کے لیے تیار فیلڈ آبجیکٹ نہیں دیتا۔ کسی بھی POST سے پہلے انسان مکمل ساخت، تمام تقاضوں کی شمولیت، پیرنٹ تعلقات اور لکھنے کی عین منزل منظور کرے۔

4. پہلے پیرنٹ بنائیں اور ہر ایشو دوبارہ پڑھیں

منظور شدہ پیرنٹ POST /rest/api/3/issue کے ذریعے بنائیں، پھر اس کی اسٹوریز، پھر ہر حقیقی ذیلی کام۔ ہر درخواست سے پہلے نجی روزنامچے میں رن ID، مقامی ایشو ID، جہاں لازم ہو مصدقہ پیرنٹ کلید، منزل، عین منظور شدہ درخواست کا ہیش، کوشش کا UTC وقت اور pending حالت درج کریں۔ ٹوکن شامل نہ کریں۔ HTTP 201 پر Jira کی واپس کردہ ایشو ID اور کلید لکھیں، پھر براہ راست GET /rest/api/3/issue/{issueIdOrKey} چلائیں۔ منصوبہ، قسم، خلاصہ، تفصیل یا PRD حوالہ اور پیرنٹ منظور شدہ منصوبے سے ملائیں۔ دوبارہ پڑھنے کے بعد ہی سطر کو confirmed نشان زد کریں۔ مصدقہ پیرنٹ اس کے چائلڈ بنانے کی اجازت دیتا ہے۔

درخواست کا وقت ختم ہو یا جواب کھو جائے تو اسے unknown نشان زد کریں۔ منصوبے، وقت، منظور شدہ خلاصے اور منصوبے کے حوالے سے Jira دیکھیں، ممکنہ مماثلت براہ راست کھولیں اور مجاز مالک سے شناخت طے کرائیں۔ Atlassian خبردار کرتا ہے کہ لکھنے کے بعد تلاش میں تاخیر ہو سکتی ہے۔ تلاش میں نتیجہ نہ ملنا تخلیق ناکام ہونے کا ثبوت نہیں۔ رن ID اور روزنامچہ مطابقت میں مدد دیتے ہیں مگر سرور کو نقل تخلیق مسترد کرنے پر مجبور نہیں کرتے۔ غیر یقینی POST کبھی اندھا دھند دوبارہ نہ بھیجیں۔

مکمل ساخت براہ راست پڑھ کر ticket-map.json میں درج کریں: ہر مقامی ID، حقیقی Jira ID اور کلید، ایشو کا بنیادی URL، منصوبہ، قسم، پیرنٹ کلید، PRD اور قبولیت کی ID، دوبارہ پڑھنے کا وقت اور روزنامچے کا حوالہ۔ تمام منظور شدہ ایشوز اور معیار PRD سے ملائیں۔ ایشو غائب ہو یا غلط پیرنٹ کے تحت ہو تو مزید لکھنا روکیں؛ منصوبے کا جانچا ہوا اصلاحی عمل استعمال کریں۔

5. ہر منظور شدہ اسٹوری نافذ اور آزادانہ طور پر جانچیں

منظور شدہ اسٹوریز انحصار کی ترتیب سے کریں۔ ہر ایک کی Jira کلید، ابتدائی Git کمیٹ اور برانچ یا ورک ٹری، اصل قبولیت کمانڈ، جائز پاتھ اور کمانڈ درج کریں۔ Claude Code سے Plan mode استعمال کرکے اس اسٹوری کے معیار ریپوزٹری سے ملانے کو کہیں۔ ڈویلپر منصوبہ جانچتا اور محدود ترمیم کی اجازت دیتا ہے۔ اسٹوری کی حد تبدیلی کو قابل جائزہ رکھتی ہے؛ باقی منظور شدہ اسٹوریز فیچر سے نہیں نکالتی۔

ترمیم کے بعد عین diff، اصل پڑتال کمانڈ کے مکمل آؤٹ پٹ اور خروج کی حالت، متعلقہ مخصوص ٹیسٹ اور ہر تقاضے کی ID کا فیصلہ محفوظ کریں۔ حقیقی کوڈ اور لاگز دیکھیں۔ تحریری منصوبہ، تیار فائلیں یا Claude کا یہ کہنا کہ ٹیسٹ پاس ہیں کام کرتی تبدیلی ثابت نہیں کرتا۔ ناکام پڑتال، غیر متوقع راز، انحصار میں تبدیلی، بیرونی لکھائی یا وسیع ری فیکٹرنگ پر اسٹوری روکیں؛ منظور شدہ دائرے میں درست کرکے اصل پڑتال دوبارہ چلائیں۔ الگ کوڈ جائزہ کار طے کرے کہ نتیجے کا کمیٹ قبول کرنا ہے یا diff روکنا ہے۔ ہر اسٹوری کا فیصلہ درج کریں۔ ایک جانچی ہوئی Claude Code تبدیلی پر ہماری پچھلی رہنمائی کوڈ جائزے کے محدود مرحلے تک ہے؛ یہاں PRD اور مکمل Jira ساخت فیچر کی وسیع حد طے کرتے ہیں۔

6. مجاز Jira اپ ڈیٹس کی تصدیق کریں

ہر جانچی ہوئی اسٹوری کی موجودہ Jira حالت پڑھیں اور GET /rest/api/3/issue/{key}/transitions?expand=transitions.fields مانگیں۔ اس صارف کو واقعی دستیاب ٹرانزیشن، اس کی منزل، لازمی فیلڈز اور جائز اقدار دیکھیں۔ مجاز مالک پھر منصوبے کے لیے طے کردہ فیلڈ اقدار کے ساتھ POST /rest/api/3/issue/{key}/transitions کے ذریعے منتخب ٹرانزیشن بھیج سکتا ہے۔ ایشو براہ راست دوبارہ پڑھ کر نئی حالت کی تصدیق کریں۔ کوڈ پڑتال پاس ہونا بذات خود Done، انضمام یا تعیناتی کی اجازت نہیں۔

لکھنے سے پہلے کی حالت، مطلوب ٹرانزیشن، صارف، درخواست اور جواب Jira اپ ڈیٹ روزنامچے میں درج کریں۔ POST /rest/api/3/issue/{key}/comment سے حقیقت پر مبنی ADF ثبوتی تبصرہ پوسٹ کریں: منظور کمیٹ یا روکا گیا diff، اصل پڑتال اور مخصوص ٹیسٹ، باقی ناکامیاں اور جائزہ کار کا فیصلہ۔ بنائے گئے تبصرے کی ID اور متن Jira کے تبصرہ API سے دوبارہ پڑھیں۔ کسی لکھائی کا جواب غیر یقینی ہو تو دوسری درخواست سوچنے سے پہلے حالت یا تبصرے براہ راست دیکھیں۔ خالی ٹرانزیشن فہرست یا غیر دستیاب لازمی فیلڈ کام کے بہاؤ یا اجازت کی کمی ہے جسے منصوبے کے مالک کے ساتھ حل کرنا ہے، ID گھڑنے کی دعوت نہیں۔

7. طے کریں کہ CLAUDE.md بدلنا چاہیے یا نہیں

حقیقی PRD، ٹکٹ، diff، ٹیسٹ، جائزے اور Jira ریکارڈ ملائیں۔ Claude سے مختصر بعد از عمل جائزہ مانگیں جو دیکھی گئی غلط فہمیوں یا غائب پڑتالوں کی نشاندہی کرے۔ انسان ہدایات میں مخصوص ترمیم منتخب کرے یا تبدیلی نہ کرنے کا فیصلہ، جائزہ کار اور وقت سمیت درج کرے۔ منظوری ہو تو صرف اس CLAUDE.md کے diff اور ہیش کو جانچ کر کمیٹ کریں۔ Anthropic کی میموری رہنمائی منصوبے کی ہدایات بیان کرتی ہے؛ یہ جائزہ آئندہ کام کی خودکار اجازت نہیں دیتا۔ راز شامل نہ کریں اور قیاسی سبق کو منصوبے کا اصول نہ بنائیں۔

تکمیل اور بحالی

فیچر صرف تب مکمل ہے جب منظور شدہ PRD نظرثانی براہ راست مصدقہ ایپک، اسٹوری اور ذیلی کاموں کی ساخت سے ملے؛ ہر منظور شدہ اسٹوری کی ابتدائی حالت، قبول شدہ diff، اصل پڑتال اور مخصوص ٹیسٹوں کے ثبوت اور آزاد جائزہ موجود ہوں؛ ہر مجاز Jira ٹرانزیشن اور ثبوتی تبصرہ براہ راست دوبارہ پڑھا گیا ہو؛ اور انسان نے بعد از عمل جائزے پر فیصلہ کیا ہو۔ کچھ غائب ہو تو باقی عین مرحلہ درج کریں۔ پہلا AI کام منتخب کرنا اس سے پہلے، کام کے انتخاب اور مجوزہ پڑتال پر ختم ہوتا ہے؛ اس نفاذی نتیجے کو ثابت نہیں کرتا۔

غیر یقینی Jira تخلیق unknown رہتی ہے جب تک انسان شناخت نہ ملا لے۔ غلط پیرنٹ چائلڈ کی تخلیق روکتا ہے۔ ناکام ٹیسٹ اپنے اصل معیار برقرار رکھتے ہیں۔ غائب ٹرانزیشن یا ختم استعمال حد پر مالک کے لیے تاریخ والا جزوی ریکارڈ چھوڑیں۔ Claude اور Jira کو کم سے کم منظور شدہ تقاضے اور گاہک ڈیٹا دیں، موجودہ اکاؤنٹ اخراجات اور اجازتیں جانچیں اور انسانی کوڈ جائزے کا بجٹ رکھیں۔ رہنما اوزاروں سے گزرنے کا مشروط راستہ بتاتا ہے؛ BIG CHANGE کے مکمل کردہ فیچر، Jira لکھائی، ماڈل رن، ناپی گئی بچت، انضمام یا تعیناتی کی اطلاع نہیں دیتا۔

ماخذ اور مزید مطالعہ