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

stepstone হলো একটি CLI টুল যা প্রজেক্ট রোডম্যাপকে রিপোজিটরির ভেতরেই একটি কমিটেড ফাইল হিসেবে সংরক্ষণ করে। গোলসগুলো টার্মিনাল থেকে যুক্ত করা হয় এবং রিপো রুট-এ `.worklist/worklist.json` ফাইলে লেখা হয়, যা মানুষ এবং কোডিং এজেন্ট উভয়ই একই কমান্ডের মাধ্যমে পড়তে এবং পরিবর্তন করতে পারে। এটি npm-এ ডিস্ট্রিবিউট করা হয়েছে এবং `npx -y stepstone@latest` এর মাধ্যমে ইনস্টলেশন ছাড়াই চালানো সম্ভব। প্রতিটি Project Goal-এর একটি শিরোনাম, একটি ঐচ্ছিক বিবরণ, একটি স্ট্যাটাস এবং শিরোনাম থেকে তৈরি একটি স্ল্যাগ আইডি থাকে যা পরবর্তীতে ফ্রিজ করা হয়, যাতে কমিট মেসেজ বা পুল রিকোয়েস্টে থাকা রেফারেন্সগুলো রিনেম করার পরেও টিকে থাকে। স্ট্যাটাসগুলো হলো `open`, `active`, `done` এবং `archived`; সর্বোচ্চ একটি গোল অ্যাক্টিভ থাকতে পারে এবং `set_active` কমান্ড পূর্ববর্তী অ্যাক্টিভ গোলটিকে ডিমোট করে। কোনো গোল সম্পন্ন করা, পুনরায় খোলা, আর্কাইভ করা বা মুছে ফেলার জন্য `--confirm` ফ্ল্যাগ বা কি-স্ট্রোকের মাধ্যমে স্পষ্ট নিশ্চিতকরণের প্রয়োজন হয়। Dependency edges রেকর্ড করে যে কোন গোলগুলো আগে সম্পন্ন হতে হবে। ব্লকড স্টেট প্রতিবার রিড করার সময় এই এজ থেকে ডেরিভ করা হয়, আলাদাভাবে স্টোর করা হয় না। `ready` কমান্ড পুরো প্যারালাল ফ্রন্টিয়ার রিপোর্ট করে, `next` শুরু করার জন্য প্রথম গোলটির নাম বলে এবং `waves` ফাইল অর্ডারের পরিবর্তে ডিপেন্ডেন্সির ভিত্তিতে অসম্পূর্ণ গোলগুলোকে তাদের শুরু করার সম্ভাব্য দ্রুততম লেয়ারে সাজায়। এজেন্ট এবং স্ক্রিপ্টের জন্য প্রোজ-এর পরিবর্তে ডিটারমিনিস্টিক রেজাল্ট এনভেলপ পেতে যেকোনো কমান্ডে `--json` ব্যবহার করা যায়। README-তে একটি সিঙ্গেল অ্যাপ্লিকেশন সার্ভিস, একটি ক্রস-প্রসেস লক এবং প্রতিটি ইন্টারফেসের পেছনে একটি অ্যাটমিক ফাইল রিপ্লেসমেন্টের কথা বলা হয়েছে, যাতে একটি CLI কল, একটি ওপেন টার্মিনাল বোর্ড এবং একটি লাইভ সেশন ফাইলটি করাপ্ট না করে একই রিপোজিটরি শেয়ার করতে পারে। ঐচ্ছিক প্রি-কন্ডিশন, ফাইল-ওয়াইড রিভিশন এবং গোলের `updatedAt` একটি স্টেল রিড-কে সাইলেন্ট ওভাররাইটের পরিবর্তে কনফ্লিক্ট হিসেবে রিপোর্ট করে। `project ui` একই গোলগুলোর ওপর একটি ফুল-স্ক্রিন টার্মিনাল বোর্ড খোলে। এজেন্ট ব্যবহারের জন্য, `skills` CLI-এর মাধ্যমে একটি স্ট্যান্ডঅ্যালোন Agent Skill ইনস্টল করা যেতে পারে যা এজেন্টকে ওয়ার্কফ্লো শেখায় এবং প্রয়োজন অনুযায়ী npm CLI ইনভোক করে। একটি Pi এক্সটেনশন Session Tasks (রোডম্যাপ থেকে আলাদা, ব্রাঞ্চ-অ্যাওয়ার কনক্রিট সেশন চাঙ্কসের একটি কিউ), উভয় তালিকার ওপর একটি `/tasks` ড্যাশবোর্ড, অ্যাক্টিভ গোল এবং পরবর্তী অসম্পূর্ণ টাস্কগুলোর নাম দেখানোর একটি উইজেট এবং মডেল-ফেসিং `worklist` টুল যুক্ত করে। প্রিপেয়ারড চেকআউটগুলোতে একটি ইগনোরড রুট `STEPSTONE_GOAL.md` ফাইলে গোল থাকে, যাতে Stepstone হারনেস লঞ্চ করা ছাড়াই কাজ শুরু করা যায়; প্রজেক্টটি উল্লেখ করেছে যে লোড করা কোনো CLI কোড Pi প্যাকেজ ইমপোর্ট করে না এবং CI তারবল প্যাক করে এবং Pi ছাড়াই ইনস্টল করা বিনগুলো পরিচালনা করে। ডকুমেন্টেশনে CLI ব্যবহার, গোল মডেল, ডিপেন্ডেন্সি, ডিসপ্যাচ এবং ওয়ার্কস্পেস ক্লেইমিং, স্টোরেজ স্কিমা এবং মাইগ্রেশন, টার্মিনাল বোর্ড, Agent Skill এবং Pi এক্সটেনশন কভার করা হয়েছে। প্রজেক্টটি ০.১৭.০ সংস্করণ পর্যন্ত `pi-worklist` নামে প্রকাশিত হয়েছিল এবং বর্তমানে বর্তমান নামে চলছে। এটি MIT লাইসেন্সপ্রাপ্ত।