প্রকল্প সম্পর্কে

Specrails Core হল একটি Node.js CLI এবং স্পেসিফিকেশন-চালিত সফটওয়্যার ডেভেলপমেন্টের জন্য এজেন্ট ওয়ার্কফ্লো ফ্রেমওয়ার্ক। এটি একটি প্রজেক্টে বেসলাইন ভূমিকা—আর্কিটেক্ট, ডেভেলপার এবং রিভিউয়ার—ইনস্টল করে এবং Claude Code, Codex CLI, Gemini CLI এবং Kimi Code-এর জন্য প্রোভাইডার-নেটিভ কমান্ড প্রকাশ করে। উদ্দেশ্যপ্রণোদিত ফ্লো হল স্পেসিফিকেশন → আর্কিটেকচার → বাস্তবায়ন → রিভিউ → ডেলিভারি; আর্কিটেক্ট একটি OpenSpec প্রস্তাবনা, ডিজাইন এবং টাস্ক তৈরি করে, ডেভেলপার সম্মত কাজ বাস্তবায়ন করে, এবং রিভিউয়ার স্পেক এবং প্রজেক্ট ভেরিফিকেশন কমান্ডের বিপরীতে ফলাফল পরীক্ষা করে। একটি প্রজেক্ট থেকে ইনস্টলেশন: npx specrails-core@latest init --provider claude (claude, codex, gemini বা kimi বেছে নিন)। নন-ইন্টারঅ্যাকটিভ: npx specrails-core@latest init --yes --provider claude। প্রোভাইডাররা /specrails:implement, $implement, এবং /skill:specrails-implement-এর মতো নেটিভ কমান্ড ব্যবহার করে। Kimi ইন্টিগ্রেশন Kimi Code 0.27.0+ টার্গেট করে এবং হেডলেস অ্যাক্টিভেশনের জন্য .kimi-code/specrails/run-skill.mjs ব্যবহার করে। Core 5 এনরিচমেন্ট ফেজের জন্য মডেলকে আহ্বান না করে সরাসরি ভূমিকা এবং ওয়ার্কফ্লো ইনস্টল করে। ইনস্টল করা সারফেসগুলির মধ্যে রয়েছে প্রোভাইডার ডিরেক্টরি (.claude, .codex, .gemini, .kimi-code), openspec/ স্পেকস এবং পরিবর্তন আর্টিফ্যাক্ট, .specrails/config.yaml এবং install-config.yaml, .specrails/rules/ এবং agent-memory/, .specrails/runtime/ এবং pipeline/, ঐচ্ছিক .specrails/local-tickets.json, এবং .specrails/profiles/। স্ট্যান্ডঅ্যালোন ইনস্টলেশন সাধারণত কমিটেবল আর্টিফ্যাক্টগুলিকে রেপোতে কপি করে এবং ~/.specrails/ এর অধীনে একটি শেয়ার্ড ফ্রেমওয়ার্ক স্টোর ব্যবহার করে; স্থানান্তরিত বা ডেস্কটপ-ম্যানেজড ওয়ার্কস্পেস ফ্রেমওয়ার্ক লিঙ্ক এবং প্রজেক্ট আর্টিফ্যাক্টগুলিকে চেকআউটের বাইরে রাখতে পারে। ম্যানেজড ফাইলগুলি আপডেট দ্বারা পুনর্গঠিত হতে পারে; ব্যবহারকারী এক্সটেনশনগুলিকে .specrails/profiles/** এবং custom-* ভূমিকার মতো নথিভুক্ত পথ ব্যবহার করা উচিত। আপডেটগুলি এক্সিকিউটেবল রিফ্রেশ থেকে আলাদা: npx specrails-core@latest update --dry-run, update, doctor। বিদ্যমান প্রোভাইডার নির্বাচনগুলি বর্তমান আপডেট বাস্তবায়ন দ্বারা সংরক্ষিত থাকে; বর্তমান উৎস একটি পুরানো CLI-কে একটি নতুন ইনস্টল করা ফ্রেমওয়ার্ক ওভাররাইট করতে বাধা দেয়। Core 4 থেকে মাইগ্রেশন এনরিচ কমান্ড, দ্রুত/পূর্ণ ইনস্টলেশন স্তর এবং বান্ডিল করা নন-কোর বিশেষজ্ঞ এজেন্টগুলিকে সরিয়ে দেয়; কাস্টম এজেন্টগুলিকে সুরক্ষিত custom-* ভূমিকা এবং প্রোফাইল রেফারেন্সগুলিতে আপডেট করা উচিত। একটি অপ্ট-ইন প্রোগ্রাম্যাটিক এজেন্ট রানিটাইম অন্তর্ভুক্ত রয়েছে: একটি শেয়ার্ড LangGraph ওয়ার্কফ্লো প্রতি-ভূমিকা প্রোভাইডার, টেকসই রিকভারি এবং স্থানীয় OpenAI-সামঞ্জস্যপূর্ণ মডেল সহ, একটি TypeScript API এবং CLI-এর মাধ্যমে প্রকাশিত। স্ট্যান্ডঅ্যালোন স্বয়ংক্রিয় ডেলিভারি শাখা, কমিট, পুশ এবং পুল রিকোয়েস্ট তৈরি করতে পারে যখন সক্ষম করা হয়; GitHub পুল রিকোয়েস্টগুলির জন্য একটি প্রমাণীকৃত gh CLI প্রয়োজন। Specrails Desktop-এর মতো হোস্ট SPECRAILS_GIT_AUTO=false সেট করতে পারে এবং ওয়ার্কট্রি এবং ডেলিভারি মালিক হতে পারে। মাল্টি-রেপোজিটরি প্রেক্ষাপটগুলিকে স্পষ্টভাবে নির্বাচিত রেপোজিটরি এবং OpenSpec/ব্যাকলগ মালিককে চিহ্নিত করতে হবে। কনফিগারেশন, স্পেকস এবং রান স্টেট স্থানীয় ফাইল, কিন্তু প্রোভাইডার CLI-গুলি কনফিগার করা মডেল পরিষেবাগুলিতে সরবরাহ করা প্রসঙ্গ পাঠায়, এবং প্যাকেজ ইনস্টলেশন, GitHub/Jira এবং MCP ইন্টিগ্রেশন নেটওয়ার্ক ব্যবহার করতে পারে। মডেল ব্যবহার প্রোভাইডার দ্বারা বিল করা হয়। প্রজেক্টটি MIT লাইসেন্সযুক্ত এবং Node.js 20.19.0+ এর সাথে Git এবং অন্তত একটি প্রমাণীকৃত AI CLI প্রয়োজন; সোর্স থেকে ডেভেলপমেন্ট npm ci, npm test, npm run build, typecheck এবং coverage কমান্ড ব্যবহার করে।