refactor(guidelines): update guidelines and add mandatory Grill section for all skills

2026-08-07 20:03:49 +03:30
parent 9b9a7500e2
commit a4a24c51af
6 changed files with 28 additions and 4 deletions
@@ -1,6 +1,6 @@
-# راهنمای مشترک `prompt-writer` و `run-prompt`
+# راهنمای مشترک اسکیل‌های این پروژه

-این فایل مرجع کیفیت هر دو اسکیل است. هر دو اسکیل باید در ابتدای بدنهٔ خود این خط را داشته باشند:
+این فایل مرجع کیفیت همهٔ اسکیل‌های پروژه است. هر اسکیل باید در ابتدای بدنهٔ خود این خط را داشته باشد:

 > قبل از شروع، فایل `.claude/guidelines.md` را بخوان و همهٔ بخش‌های آن را اعمال کن.

@@ -8,6 +8,24 @@

 ---

+## ۰. Grill — قبل از هر تغییر (اجباری)
+
+قبل از نوشتن کد، ساختن فایل یا اجرای هر تغییر:
+
+1. ابزار Skill را با `skill: "mattpocock-skills:grilling"` صدا بزن.
+2. طبق آن اسکیل، سؤال‌ها را **یکی‌یکی** بپرس و بعد از هر سؤال منتظر جواب بمان.
+3. هر چیزی که با ابزار قابل کشف است را نپرس. خودت پیدا کن.
+4. اول `graphify query "<سؤال>"` بزن، بعد فایل بخوان.
+5. فقط **تصمیم‌ها** را از کاربر بپرس، نه **واقعیت‌ها**.
+6. برای هر سؤال، پاسخ پیشنهادی خودت را هم بنویس.
+7. تا وقتی کاربر «تأیید» نداده، هیچ فایلی را تغییر نده.
+
+خروجی این مرحله یک درک مشترک است. بعد از تأیید، برو سراغ §۱.
+
+**استثنا:** اگر کاربر گفت «بدون grill»، «مستقیم انجام بده» یا «سؤال نپرس»، این بخش را رد کن.
+
+---
+
 ## ۱. درک مسئله — قبل از هر خط کد

 هیچ چیز گران‌تر از پیاده‌سازیِ درستِ مسئلهٔ اشتباه نیست. به همین دلیل: