এই AI Software Factory রিপোজিটরি পণ্যের উদ্দেশ্য ও একটি কাজ থেকে Archon-এর তৈরি পুল রিকোয়েস্ট পর্যন্ত পথ দেখায়। ইনস্টলেশন ও ওয়ার্কফ্লো পরীক্ষা কেবল শুরু। রক্ষণাবেক্ষণকারীর প্রথম ঘণ্টার নির্দেশিকা বলছে, বাস্তবে শুরু থেকে শেষ পর্যন্ত যাচাই এখনো বাকি। এই নির্দেশিকা ফ্যাক্টরির কমিট 9e2d85298b45497031009597a6ae0811b66fe6d6 এবং এতে নির্দিষ্ট Archon সংস্করণ fad09169ea1b43512bc7ee88470d47f960a3e0f8 অনুসরণ করে। এটি নথি ও কোড পড়ার ভিত্তিতে লেখা; BIG CHANGE-এর ইনস্টল বা চালানোর প্রতিবেদন নয়।

প্রক্রিয়াটি সেই দলের জন্য, যারা অ্যাপের রিপোজিটরি বা PRD, GitHub অনুমতি এবং মডেল সরবরাহকারীর অ্যাকাউন্ট নিয়ন্ত্রণ করে। রক্ষণাবেক্ষণকারী নিজের রিপোজিটরিতে ফ্যাক্টরি ক্লোন ও ইনস্টল করার পদ্ধতি স্পষ্টভাবে নথিভুক্ত করেছেন। নির্দিষ্ট ফ্যাক্টরির ফাইল-ট্রিতে লাইসেন্স বা নোটিশ নেই; এই নির্দেশিকা বিস্তৃত পুনর্ব্যবহার বা পুনর্বিতরণের অধিকার প্রতিষ্ঠা করে না। Archon-এর MIT লাইসেন্স আলাদা Archon উৎসের জন্য। সরবরাহকারীর গোপন তথ্য কাজের বিবরণ, প্রম্পট, লগ বা পর্যালোচনার নথিতে রাখবেন না।

বড় পরিবর্তন

  • কী বদলেছে: এই বাস্তবায়ন নির্দিষ্ট Archon ওয়ার্কফ্লো প্যাক দিয়ে পণ্যের পরিধি, কাজের পরিকল্পনা, কোড লেখা, স্বাধীন পর্যালোচনা ও রানটাইম পরীক্ষা যুক্ত করে। ফ্যাক্টরি প্রকল্প ইনপুট ও লঞ্চার দেয়; যৌথ প্যাকে AI ধাপ থাকে।
  • কেন গুরুত্বপূর্ণ: দল মার্জের আগে কাজ থেকে নির্দিষ্ট পরিবর্তন, CI ফল ও চলমান প্রার্থী পর্যন্ত প্রস্তাব অনুসরণ করতে পারে। ইনস্টলেশন পরীক্ষা একা এই যোগসূত্র পূর্ণ করে না; রক্ষণাবেক্ষণকারী বাস্তব সমন্বয়ের যাচাই এখনো বাকি বলেছেন।
  • কী দেখতে হবে: প্রথম উপযোগী প্রমাণ হলো আসল কাজ, যার সরবরাহ করা সংস্করণ অর্থপূর্ণ প্রক্রিয়া ও স্বাধীন আলাদা পরীক্ষায় সফল, এবং দলের কাছে খরচ ও পর্যালোচনার রেকর্ড দৃশ্যমান। এরপরও সময়সূচি ও স্থাপন আলাদা সিদ্ধান্ত।

১. রিপোজিটরি, অনুমতি ও নির্দিষ্ট উৎস যাচাই করুন

রক্ষণাবেক্ষণকারীর প্রস্তুতির নির্দেশনা অনুযায়ী Git, Python 3.10 বা নতুন, প্রমাণীকৃত gh, যার workflow অনুমতি আছে, GitHub রিমোট, কোডিং এজেন্ট, Bun ও uv দরকার। Git-ও ওয়ার্কফ্লো ফাইল পাঠাতে পারতে হবে (gh auth setup-git)। এজেন্ট চালানোর আগে অ্যাপের বর্তমান পরীক্ষা, চালু করা ও CI কমান্ড, ব্রাঞ্চ সুরক্ষা, GitHub প্রবেশাধিকার, সরবরাহকারীর প্রমাণীকরণ এবং মডেলের বিল যাচাই করুন। প্রয়োজনীয় রিপোজিটরি ও ওয়ার্কফ্লো অধিকারটুকুই দিন।

অ্যাপের রিপোজিটরির বাইরে ফ্যাক্টরি ক্লোন করে নির্দিষ্ট কমিটে যান। নথির ইনস্টল কমান্ড অ্যাপের মূল ফোল্ডার থেকে চালাতে হবে:

Terminal
git clone https://github.com/coleam00/ai-software-factory ~/ai-software-factory
git -C ~/ai-software-factory checkout 9e2d85298b45497031009597a6ae0811b66fe6d6
python ~/ai-software-factory/bin/factory.py init

প্রয়োজনে python3 ব্যবহার করুন। ইনস্টলার ফ্যাক্টরি ও প্রকল্পের টেমপ্লেট কপি করে pack.json-এ নির্দিষ্ট Archon উৎস ইনস্টল করে। এই কমিটের README ও প্যাক দুটিই fad09169ea1b43512bc7ee88470d47f960a3e0f8 উল্লেখ করে। ইনস্টলার সরবরাহকারীর প্রমাণীকরণ করে না, মডেলের স্তর বেছে নেয় না, সময়সূচিও চালু করে না। রিপোজিটরিতে পরিবর্তন গ্রহণের আগে বদলানো ফাইল দেখুন।

ইনস্টল করা Archon নির্দেশনা অনুযায়ী পছন্দের সরবরাহকারী ও সমর্থিত মডেল পরিচয় সেট করুন। প্রকল্পের আসল স্থির বিশ্লেষণ ও ইউনিট পরীক্ষার কমান্ড harness/harness.config.json-এ দিন। GitHub ব্রাঞ্চ সুরক্ষা জানাতে না পারলে মার্জের জন্য দরকারি CI কাজ required_checks-এ লিখুন। protected_paths পরীক্ষা করুন, যেন উদ্দেশ্য, যাচাই কাঠামো ও ফ্যাক্টরির নীতি বদলাতে মানুষ লাগে। টেমপ্লেট সাধারণ পরীক্ষার কমান্ড ও required_checks ফাঁকা রাখে; শুধু কপি করলে কার্যকর গ্রহণযোগ্যতার বাধা তৈরি হয় না।

২. বর্তমান পণ্যের উদ্দেশ্য ও পরীক্ষা লিখুন

ফাইল MISSION.md-এ পণ্যের উদ্দেশ্য, কঠোর সীমা এবং যুক্তিসংগত কিন্তু আওতার বাইরে থাকা অনুরোধ লিখুন। harness/END-TO-END.md-এ বর্তমান অ্যাপ সত্যিই সম্পন্ন করে এমন দুই থেকে পাঁচটি ব্যবহারকারী প্রক্রিয়া এবং ব্যবহারকারীর দৃশ্যমান উপকার লিখুন। এখনো তৈরি হয়নি এমন বৈশিষ্ট্যনির্ভর প্রক্রিয়া প্রথম সরবরাহ আটকে দেবে। .factory/holdout/HOLDOUT.md-এ আচরণের সমন্বয় ও সীমান্ত পরিস্থিতির জন্য আলাদা কেস লিখুন। ফোল্ডারের নাম একই চেকআউটে প্রবেশাধিকার থাকা নির্মাতার কাছ থেকে কেস লুকায় না; সত্যিকারের ব্যক্তিগত কেস বাইরে রাখুন এবং শুধু যাচাইকারীকে দিন।

রিপোজিটরিতে শুধু PRD থাকলে README নথি থেকে উদ্দেশ্য, পরিকল্পিত ব্যবহারকারী প্রক্রিয়া ও পরীক্ষার কমান্ড নিতে বলে। প্রথম প্রস্তাবিত কাজ পণ্য চালানোর উপযোগী করবে এবং শুরুর কমান্ড, সুস্থতা ও বিল্ড পরিচয় যাচাইয়ের পাথ, পরীক্ষা ও CI জানাবে। কাজ প্রকাশের অনুমতি দেওয়ার আগে প্রস্তাব পর্যালোচনা করুন।

ব্যবহারকারী প্রক্রিয়াগুলো Archon-এর রানটাইম ওয়ার্কফ্লোর প্রত্যাশিত দৃশ্যপট ইনপুটে বদলান। ইনস্টল করা factory/RUNTIME_HOST.md অনুসারে সরবরাহ করা কমিটের অ্যাপ স্ন্যাপশট, নতুন অবস্থা, সুস্থতা ও বিল্ড পরিচয়ের পরীক্ষা এবং অনুমোদিত Python বা Node চালুর কমান্ড প্রস্তুত করুন। নথির হোস্ট দূরের ডেটাবেস, কনটেইনার বা ক্লাউড সম্পদকে নিজের নিয়ন্ত্রিত রানটাইম সম্পদ হিসেবে সমর্থন করে না। এগুলো ব্যবহারকারী অ্যাপের আলাদাভাবে যুক্তিসংগত যাচাই ব্যবস্থা দরকার; স্থানীয় হোস্টের সফল পরীক্ষা সেগুলোর বিচ্ছিন্নতা প্রমাণ করে না।

মূল্যায়নকারীর ওপর নির্ভর করার আগে প্রকৃত ব্যবহারকারী উপকার পরীক্ষা করে এমন সফল ভিত্তি তৈরি করুন, দেখান যে প্রাসঙ্গিক ইচ্ছাকৃত ত্রুটি ব্যর্থ হয় এবং ভুল প্রার্থী পরিচয়ে অনির্ণায়ক ফল আসে। হোস্ট নির্দেশিকায় পরীক্ষাগুচ্ছের ইনপুট ও সঠিক প্রত্যাশিত ফিল্ড আছে, যার মধ্যে expectations_passed: true ও baseline_verified: true রয়েছে। আসল প্রত্যুত্তর এবং প্রার্থীর পরিচয় প্রমাণ হিসেবে রাখুন। শুধু পৃষ্ঠা খুলছে কি না দেখা, অথবা পরীক্ষার শেষ অবস্থা সরাসরি তৈরি করা যথেষ্ট নয়।

৩. ইনস্টলেশন পরীক্ষা করে একটি কাজ বেছে নিন

অ্যাপের মূল ফোল্ডার থেকে চালান:

Terminal
python factory/consumer.py doctor
python factory/consumer.py list

doctor নির্দিষ্ট উৎস, কমান্ডের ক্ষমতা ও উপলব্ধ ওয়ার্কফ্লো পরীক্ষা করে। list পাওয়া ওয়ার্কফ্লো দেখায়। কোনোটিই প্রমাণ করে না যে সরবরাহকারী কাজ শেষ করতে পারবে, CI সফল হবে বা অ্যাপ চলবে। সরবরাহের আগে জানানো সমস্যা সমাধান করুন; সময়সূচি বন্ধ রাখুন।

বিদ্যমান কোডের জন্য স্পষ্ট ফল ও গ্রহণযোগ্যতার পরীক্ষা থাকা ছোট একটি কাজ লিখুন। শ্রেণিবিন্যাস, সরবরাহ ও পর্যালোচনা হয়ে পুল রিকোয়েস্ট পর্যন্ত যাওয়ার জন্য README এই কমান্ড দেয়:

Terminal
python factory/consumer.py run archon-ship --input target=https://github.com/OWNER/REPO/issues/1 --input discovery_publication=preview --detach --json

কাজের URL আপনার নিয়ন্ত্রণে থাকা কাজ দিয়ে বদলান। স্পষ্ট discovery_publication=preview দিলে পর্যালোচনার সংশ্লিষ্ট আবিষ্কারগুলো কাজ হিসেবে প্রকাশিত হয় না; নির্দিষ্ট archon-ship-এর স্বাভাবিক মান auto। রানটাইম দৃশ্যপট ও আলাদা রাখা পরীক্ষার ইনপুট প্রস্তুত হলে তবেই archon-lifecycle ব্যবহার করুন। কাজ target হিসেবে, পাথগুলো scenario ও holdout হিসেবে দিন, সঙ্গে merge_mode=approve এবং discovery_publication=preview। প্রকল্প-অনুমোদিত merge_method-ও দিন: merge, squash বা rebase। যেমন, রিপোজিটরি অনুমতি দিলেই merge_method=squash নিন। এই প্রবাহে রানটাইম ও আলাদা কেস যাচাই, মেরামত এবং মার্জের বাধা আছে। অনুমোদন মোডে মার্জের আগে মানুষের সিদ্ধান্ত থাকে; ওয়ার্কফ্লোর প্রস্তুত চিহ্ন সেই সিদ্ধান্ত নয়। ফ্যাক্টরি হোস্টের নথিভুক্ত --runtime-host শুধু সামনের প্রক্রিয়ায় চলে, --detach বা --resume-এর সঙ্গে নয়।

PRD-এর জন্য নথিভুক্ত ব্যাকলগ কমান্ড:

Terminal
python factory/consumer.py run archon-backlog --input 'prd=docs/PRD.md' --input publication=approve

উদ্ধৃতিচিহ্নের docs/PRD.md-এর জায়গায় অ্যাপ চেকআউটের তুলনায় PRD-এর আসল পাথ দিন। প্রকাশের আগে প্রস্তাবিত কাজের ক্রম পর্যালোচনা করুন। প্রথম কাজের ঘোষিত অ্যাপ চালু করা ও পরিচয়ের চুক্তি অনুযায়ী রানটাইম হোস্ট জুড়ে দিন; এরপর প্রস্তুত প্রক্রিয়া ও আলাদা পরীক্ষা দিয়ে কাজটি archon-lifecycle-এ নিন। প্রথম কাজ পরেরগুলোর মতোই সতর্কভাবে যাচাই করতে হবে।

৪. অনুমোদনের আগে পরিবর্তন ও চলমান ফল বিচার করুন

ফেরত পাওয়া রান ID রাখুন। নিয়ন্ত্রণ প্রোগ্রামে অগ্রগতি ও প্রমাণের জন্য get <run-id> --json --events এবং status --all --json আছে। কাজ ও পরিকল্পনা MISSION.md-এর সঙ্গে মেলান; আসল PR পার্থক্য ও সর্বশেষ সংস্করণের স্বাধীন পর্যালোচনা পড়ুন; প্রয়োজনীয় CI ফল এবং সুরক্ষিত পাথের প্রতিবেদন দেখুন। সরবরাহ করা সংস্করণে ব্যবহারকারী প্রক্রিয়া চালিয়ে প্রার্থী পরিচয়সহ আসল রানটাইম ও আলাদা পরীক্ষার ফল পরীক্ষা করুন। দেখা ফল গ্রহণযোগ্যতার শর্তের সঙ্গে মেলান। অসম্পূর্ণ PR মেরামতের জন্য ফেরত দিতে হবে; মার্জ সারিতে আটকে থাকা সরবরাহের জন্য README archon-deliver --adopt <run id> বর্ণনা করে।

পরীক্ষা সফল হলে শুধু রিপোজিটরির অধিকার থাকা মানুষ মার্জ অনুমোদন করবেন। স্থাপনের জন্য প্রকল্পের নিজস্ব স্থাপন, সুস্থতা ও পরিচয় কমান্ড এবং পরে সংস্করণ আবার পড়ে নিশ্চিত করা দরকার। মার্জ হওয়া PR নিজে স্থাপনের প্রমাণ নয়। প্রথম কাজ চলাকালে সময়সূচি বন্ধ রাখুন এবং পুনরাবৃত্ত রান চালু করবেন কি না আলাদা সিদ্ধান্ত নিন।

রক্ষণাবেক্ষণকারীর খরচের নির্দেশনা প্রতি রানের নির্দিষ্ট দাম দেয় না। প্রথম দিন থেকে টোকেন মাপতে এবং লুপ চালুর আগে ছোট কাজে মডেল কল দেখতে বলে। খরচ সরবরাহকারী, মডেল ও অ্যাকাউন্টের শর্তের ওপর নির্ভর করে। BIG CHANGE এই ফ্যাক্টরির ব্যয় মাপেনি।

সক্রিয় রান থামানোরও স্পষ্ট সিদ্ধান্ত দরকার। নিয়ন্ত্রণ কোডে কমান্ড halt নতুন চালু ও ধারাবাহিকতা আটকায়, আর cancel <run-id> সক্রিয় কাজ লক্ষ্য করে। pause টাইমারের নতুন শুরু বন্ধ করে, তবে চলমান কাজ জাগানোর অনুমতি দেয়। কোনো কমান্ড বর্তমান রান অবস্থা ও দূরের রিপোজিটরি পরিবর্তন পরীক্ষা করার বিকল্প নয়।

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