# 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` برای مسجد)، باید حتماً از همان واژه اختصاصی استفاده شود.