عن المشروع

stepstone هي أداة CLI تقوم بتخزين خارطة طريق المشروع كملف مثبت في المستودع نفسه. يتم إضافة الأهداف من الطرفية وتُكتب في `.worklist/worklist.json` في جذر المستودع، حيث يمكن قراءتها وتغييرها من قبل الأشخاص ووكلاء البرمجة عبر نفس الأوامر. يتم توزيعها على npm ويمكن تشغيلها بدون تثبيت عبر `npx -y stepstone@latest`. كل هدف مشروع (Project Goal) له عنوان، ووصف اختياري، وحالة، ومعرف slug يتم إنشاؤه من العنوان ويُجمد لاحقاً، بحيث تظل المراجع في رسائل الـ commit أو طلبات السحب (pull requests) قائمة حتى بعد تغيير الأسماء. الحالات هي `open` و`active` و`done` و`archived`؛ ويكون هناك هدف واحد نشط كحد أقصى، ويقوم الأمر `set_active` بتخفيض رتبة الحامل السابق. يتطلب إكمال الهدف أو إعادة فتحه أو أرشفته أو حذفه تأكيداً صريحاً، إما عبر علامة `--confirm` أو ضغطة مفتاح. تسجل حواف التبعية (Dependency edges) الأهداف التي يجب إنجازها أولاً. يتم اشتقاق حالة الحظر (Blocked state) من تلك الحواف عند كل قراءة بدلاً من تخزينها. يقوم الأمر `ready` بالإبلاغ عن الجبهة الموازية الكاملة، ويحدد `next` أول هدف يجب البدء به، ويقوم `waves` بتوزيع الأهداف غير المكتملة في أقرب طبقة يمكن أن تبدأ فيها، بناءً على التبعيات وليس ترتيب الملفات. يقبل أي أمر علامة `--json` للحصول على غلاف نتيجة محدد مخصص للوكلاء والسكربتات بدلاً من النصوص النثرية. يصف ملف README خدمة تطبيق واحدة، وقفل واحد عبر العمليات (cross-process lock)، واستبدال ملف ذري واحد خلف كل واجهة، بحيث يمكن لمكالمة CLI ولوحة طرفية مفتوحة وجلسة مباشرة مشاركة مستودع واحد دون إتلاف الملف. تحول الشروط المسبقة الاختيارية، والمراجعة على مستوى الملف، و`updatedAt` الخاص بالهدف، القراءة القديمة إلى تعارض مُبلغ بدلاً من الكتابة الفوقية الصامتة. يفتح `project ui` لوحة طرفية بملء الشاشة فوق نفس الأهداف. بالنسبة لاستخدام الوكلاء، يمكن تثبيت Agent Skill مستقل باستخدام CLI الخاص بـ `skills` لتعليم الوكيل سير العمل، واستدعاء npm CLI حسب الحاجة. يضيف امتداد Pi مهام الجلسة (Session Tasks) (وهي قائمة انتظار لقطع جلسات ملموسة مدركة للفروع، تُحفظ بشكل منفصل عن خارطة الطريق)، ولوحة تحكم `/tasks` فوق القائمتين، وأداة تسمي الهدف النشط والمهام التالية غير المكتملة، وأداة `worklist` موجهة للنموذج. تحمل عمليات الـ checkout المعدة هدفاً في ملف `STEPSTONE_GOAL.md` متجاهل في الجذر، بحيث يمكن استئناف العمل دون أن تقوم Stepstone بتشغيل الهيكل؛ ويذكر المشروع أن أي كود CLI محمل لا يستورد حزمة Pi وأن CI يقوم بتعبئة ملف tarball وتشغيل الملفات الثنائية المثبتة دون وجود Pi. تغطي الوثائق استخدام CLI، ونموذج الأهداف، والتبعيات، والإرسال والمطالبة بمساحة العمل، ومخطط التخزين والترحيلات، واللوحة الطرفية، وAgent Skill وامتداد Pi. تم نشر المشروع باسم `pi-worklist` حتى الإصدار 0.17.0 ويستمر تحت الاسم الحالي. المشروع مرخص بموجب رخصة MIT.