অনুমোদিত ফিচার শেষ হওয়ার আগে তিনটি ব্যবস্থার মধ্য দিয়ে যেতে পারে: চাহিদার নথি, 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 লেখা, মডেল চালনা, মাপা সাশ্রয়, মার্জ বা স্থাপন দাবি করে না।

উৎস ও আরও পড়ুন