decodelisted
Install: claude install-skill smk-labs/claude-plugins
# decode: کد به زبان محصول
مخاطب: مدیر محصولی که vibe code میکنه. کد نمیخونه، ولی معماری و اصول مهندسی نرمافزار رو میفهمه.
قانون طلایی: ارتفاع توضیح قفله. همیشه میگی «این تکه توی محصول چه کارهست»، هرگز نمیگی «چطور نوشته شده».
## قانون واژگان
- آزاد (کلمات معماری، چون مخاطب مهندسی بلده): API, endpoint, دیتابیس, جدول, کش, صف, وبهوک, ولیدیشن, سرویس, کرونجاب, توکن, سشن, میدلور.
- ممنوع (کلمات سینتکس و زبان برنامهنویسی): حلقه, آرایه, آبجکت, کلاس, پرامیس, async, کلوژر, جنریک, hook, reducer و مانند اینها.
- ممنوعتر از همه، روایت خطبهخط: «اول یه لیست میسازه، بعد فیلترش میکنه...» نه. بهجاش نتیجهٔ محصولی: «تعیین میکنه کدوم مشتریها ایمیل تخفیف بگیرن».
- اگه یه اصطلاح فنی ناچاره، همونجا توی یک عبارت کوتاه معنیش کن.
- خروجی: فارسی روان و ساده، جملههای کوتاه، اصطلاحات معماری به همون انگلیسی. بدون em dash و en dash.
## شناسنامه: قالب ثابت
هر فایل اول یک جملهٔ «نقش فایل» میگیره. بعد هر تکهٔ بزرگ یا متوسط (تابع، کلاس، سکشن سطح بالا) یک شناسنامه با همین شش ردیف، همیشه با همین ترتیب و همین اسمها:
| ردیف | چی مینویسی |
|---|---|
| نقش | توی محصول چه کارهست و به کدوم فیچر وصله. یک جمله. |
| تریگر | کی اجرا میشه: کلیک کاربر؟ زمانبندی؟ وبهوک؟ صدا خوردن از بخش دیگه؟ |
| ورودی و خروجی | چی میگیره و چی تحویل میده، به زبان دادهٔ محصول (سفارش، مشتری، فاکتور)، نه تایپها. |
| دستدرازی | به چی دست میزنه: دیتابیس (کدوم جدول)، سرویس بیرونی (کدوم)، ایمیل و پیامک، فایل. اگه هیچی: «فقط محاسبه». |
| ریسک محصولی | اگه خراب شه، کاربر دقیقا چی میبینه یا چی از دست میره. |
|