ghorbani
/
aqila_panel
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
38 Commits
2 Branches
0 Tags
5.4 MiB
 
 
 
Tree: a56036b9c4
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'a56036b9c4'
${ noResults }
aqila_panel/.agents/rules/workflow_and_guardrails.md

4.4 KiB
Raw Blame History

Workflow & System Guardrails (Aqila)

این سند شامل خطوط قرمز و قوانین فرآیندی الزامی است که باید در تمامی تعاملات، توسعه‌ها و تغییرات کد با دقت رعایت شوند:

۱. محدوده صریح تسک و جراحی موضعی (Strict Scope & Surgical Edits)

  • تغییرات باید دقیقاً محدود به همان ماژول یا تسک محول‌شده باشند. از دستکاری، ریفکتور ناخواسته یا تغییر فایل‌های نامرتبط اکیداً خودداری شود.
  • تغییرات باید به صورت جراحی موضعی (Surgical Fixes) و با کمترین میزان دستکاری در ساختار تثبیت‌شده قبلی انجام شوند.
  • پیش از هر تغییر، صحت کارکرد (بیلد برنامه، رفع خطاهای کامپایل یا اعتبارسنجی سینتکس) بررسی شده و نتیجه تست به صورت شفاف گزارش گردد.

۲. محافظت ساختاری و معماری (Architectural & Structural Change Guardrail)

  • با توجه به اینکه این پروژه توسط شخص دیگری توسعه داده شده و تمرکز تسک‌ها عمدتاً بر رفع باگ‌های موضعی و اصلاحات UI است، هرگونه تغییر بزرگ (Big Changes)، دستکاری در ساختار معماری، جابجایی لایه‌بندی Clean Code، یا تغییر در ساختار پروژه در فلاتر/دارت/وب/بک‌اند، اکیداً ممنوع است مگر اینکه ابتدا جزئیات تغییر به صورت شفاف به کاربر اطلاع داده شده و تأیید صریح کاربر اخذ گردد.

۳. خط قرمز مطلق برنچ‌های گیت (Git Branch Guardrail)

  • به هیچ عنوان و تحت هیچ شرایطی، دستیار هوش مصنوعی حق تعویض شاخه (git checkout یا git switch)، ادغام شاخه‌ها (git merge)، پوش روی سایر برنچ‌ها، یا خروج از برنچ فعلی مخزن را بدون اخذ اجازه و تأیید صریح کاربر ندارد.
  • کلیه اقدامات و تغییرات باید منحصراً روی همان برنچی که کاربر پروژه را روی آن تحویل داده یا مشخص کرده انجام شود.

۴. قوانین نگارش متون فارسی و راست‌به‌چپ (RTL Text Formatting Rules)

  • استفاده همیشگی از محفظه راست‌به‌چپ (<div dir="rtl">):
    • کلیه پاسخ‌ها و توضیحات متنی فارسی که شامل اصطلاحات فنی، انگلیسی، نام شاخه‌ها، نام فایل‌ها و کدها هستند، باید داخل بلوک <div dir="rtl"> قرار گیرند تا جهت پایه متن همیشه RTL بماند.
    • از ترکیب ناهمگون کلمات انگلیسی/کد در وسط پرانتزها و علائم نگارشی پرهیز شود تا ترتیب کلمات برعکس نشود (BiDi isolation).
    • نام دستورات، برنچ‌ها و اصطلاحات انگلیسی ترجیحاً در خطوط مجزا یا بلوک کد یا با رعایت کامل جریان متنی راست‌به‌چپ نوشته شوند.

۵. ترجمه اصطلاحات و کلمات خاص مذهبی و فرهنگی (Religious & Cultural Terminology)

  • اصل آوانویسی (Transliteration): در فرآیند ترجمه به زبان‌های مقصد (مانند روسی، اندونزیایی، انگلیسی و...)، کلمات و عناوین خاص مذهبی، آیینی و فرهنگی (نظیر حسینیه، صلات و موارد مشابه) نباید به صورت معنایی یا تفسیری ترجمه شوند. این اصطلاحات باید با حفظ تلفظ اصلی و از طریق آوانویسی با الفبای زبان مقصد (مانند حروف سیریلیک در روسی نظیر Хусейния) نوشته شوند.
  • استثنا و تبصره مهم: تنها در صورتی که در زبان مقصد، یک واژه خاص، کاملاً جاافتاده، رسمی و دقیقاً معادل همان مفهوم وجود داشته باشد (مانند Мечеть یا Mosque برای مسجد)، باید حتماً از همان واژه اختصاصی استفاده شود.