oh-my-pm اسناد محلی پروژه و زمینهٔ منتخب GitHub را به نماهای عملیاتی قطعی تبدیل میکند. مرز محصول روشن است: فایلهای محلی از دستگاه خارج نمیشوند، دسترسی سرویس فقطخواندنی است و قواعد استخراج قابلبررسیاند.
مطالعه موردی عمومی
oh-my-pm
سیستم local project intelligence برای تحویل ساختارمند محصول و پروژه.
فعال Node.js pnpm Rust WASM Vitest MCP
مطالعه موردی
ساختار پروژه
oh-my-pm جریان محصول
نمایی خلاصه از جریان کاری مستندشده در مخزن oh-my-pm.
- 1 اسناد پروژه
- 2 استخراج قطعی
- 3 Brief risks next handoff
- 4 اعتبارسنجی
- 5 مرز انتشار
روابط
- اسناد پروژه استخراج قطعی
- استخراج قطعی Brief risks next handoff
- Brief risks next handoff اعتبارسنجی
- اعتبارسنجی مرز انتشار
اسناد پروژه → استخراج قطعی → خلاصه ریسکها و گام بعدی → اعتبارسنجی → مرز انتشار
oh-my-pm معماری
نمایی خلاصه از معماری مستندشده در مخزن oh-my-pm.
- CLI
- Runtime
- Kernel
- Context providers
- اعتبارسنجی
روابط
- CLI Runtime
- Runtime Kernel
- Kernel Context providers
- Context providers اعتبارسنجی
CLI → Runtime → Kernel → Context Providerها → اعتبارسنجی
مسئله
oh-my-pm این منابع را بدون نیاز به مدل زبانی، بارگذاری محتوای محلی یا تغییر فایلهای پروژه، به نماهای عملیاتی قطعی تبدیل میکند.
نمای کلی
زمینهٔ پروژه معمولاً میان اسناد Markdown، Issueها، Pull درخواستها، چکلیستها و سوابق تصمیم پخش میشود و ساخت یک تحویل منسجم را پرهزینه میکند.
منطق محصول
بستهها از طریق خود مخزن عرضه میشوند و در npm منتشر نشدهاند. تحلیل مبتنی بر قواعد مشخص، عنوانهای شناختهشده، برچسبها، وضعیتها، محدودیت فایل و دسترسی فقطخواندنی است.
تصمیمهای محصول
برای استخراج ریسک و کار، نشانگرهای دقیق فارسی و انگلیسی جای امتیازدهی مبهم را گرفتهاند. نصب ابتدا پیشنمایش میشود و دسترسی شبکهای GitHub اختیاری و فقطخواندنی است.
معماری فنی
رابط خط فرمان و سرور MCP مبتنی بر stdio روی runtime، هستهٔ Rust/WASM، استخراجگرهای قطعی، فراهمکنندههای زمینه و لایهٔ اعتبارسنجی و انتشار قرار دارند.
اجرا و تحویل
خط منتشرشدهٔ v0.4.0 شامل جریانهای محلی و GitHub، Project Timeline قطعی روی snapshotهای ثبتشده، دوازده ابزار فقطخواندنی MCP، آرشیوهای تکرارپذیر، checksum و نصبکنندهٔ محدود به مسیر انتخابی است.
شواهد فعلی
v0.4.0 آخرین نسخهٔ پایدار منتشرشده است. خط منبع 0.5.0 یک مهاجرت سازگار namespace فرمان را آماده میکند اما هنوز منتشر نشده است.
آموختهها
اگر قواعد منبع، مرزها و قرارداد خروجی روشن باشند، هوشمندی پروژه بدون تفسیر احتمالی هم میتواند کاربردی باشد.
خروجیها
شواهد محصول
cli
چهار جریان قطعی محلی
README فرمانهای brief، risks، next و handoff را روی Markdown محلی مستند میکند؛ بدون upload، تغییر فایل پروژه، integration خارجی یا نیاز به مدل زبانی.
جریان اصلی project intelligence محلی، فقطخواندنی و از قرارداد عمومی فرمان قابلبررسی است.
documentation
استخراج signal مبتنی بر قاعده
راهنمای استخراج، عنوانها و نشانگرهای دقیق دوزبانه، اولویت labelها، ترتیب، حذف تکرار، محدودیتها، تشخیص overdue و محافظهای false-positive را تعریف میکند.
خروجی ریسک و کار بعدی با قواعد قطعی و محدود تولید میشود، نه تفسیر احتمالی.
architecture
فراهمکنندهٔ اختیاری و فقطخواندنی GitHub
راهنمای provider شبکه را به فرمان صریح، درخواست GET به مبدأ ثابت GitHub، پاسخ محدود، token فقط در environment و کدهای خطای کنترلشده محدود میکند.
دسترسی به زمینهٔ خارجی از جریانهای offline جدا و با یک مرز فقطخواندنی مستند محدود شده است.
تست و اعتبارسنجی
test
سطح اعتبارسنجی چندزبانهٔ برنامهنویسی
scriptهای package اصلی آزمون TypeScript و Rust، کنترل public surface، structure، boundary، contract، version و command، MCP smoke و تکرارپذیری release را ارائه میکنند.
مخزن اعتبارسنجی تکرارپذیر مرزهای Node.js، Rust/WASM، MCP، installer و release را در اختیار دارد.
نصب و استفاده
installation
نصب محلی با پیشنمایش اولیه
راهنمای شروع، preview بدون نوشتن را از apply صریح جدا، shimها را به prefix انتخابی محدود، PATH و تنظیمات client را دستنخورده و verifier را فقطخواندنی نگه میدارد.
تغییرات نصب به apply صریح نیاز دارند و به targetهای اعلامشده محدود میمانند.
انتشار و توزیع
release
انتشار Project Timeline در v0.4.0
نسخهٔ پایدار یک timeline مشتقشده و محدود روی snapshotهای ثبتشدهٔ Project Brain اضافه میکند؛ بدون schema، store format، migration، write path یا network path جدید.
آخرین قابلیت پایدار، تحلیل تاریخچه را گسترش میدهد و مرز اعتماد محلی و فقطخواندنی را حفظ میکند.
محدودیتهای فعلی
- v0.4.0 آخرین نسخهٔ پایدار منتشرشده میماند؛ خط منبع 0.5.0 آماده است اما اینجا بهعنوان انتشار عمومی نمایش داده نمیشود.
- بستههای workspace خصوصیاند و در npm منتشر نشدهاند؛ توزیع پشتیبانیشده از طریق مخزن و GitHub Releases است.
- استخراج، متن دلخواه یا بازگویی معنایی را استنباط نمیکند، نوشتن provider در دسترس نیست و تصویر Hero قدیمی upstream بهعنوان شاهد فعلی محصول استفاده نمیشود.
نمای کلی
- نقش من
- تعریف محصول، معماری جریان کار، مدیریت تحویل و اعتبارسنجی
- پیچیدگی
- بالا
- سطح جزئیات
- مطالعهٔ موردی
مسئولیتها
- تعریف مسئله
- تعریف محدوده
- معماری محصول
- تحویل فنی
- اعتبارسنجی
نتیجه
oh-my-pm جریانهای پایدار محلی و فقطخواندنی GitHub را برای گزارش وضعیت، ریسکها، کارهای بعدی، تحویل پروژه و دسترسی MCP فراهم میکند.