پرامپت ریفکتور کد قدیمی

## راهنمای پکیج ریفکتور کد قدیمی (Legacy Code Modernization)

دست زدن به کدی که سال‌ها کار کرده اما هیچ‌کس از جزئیات درونی آن باخبر نیست، شبیه خنثی‌سازی بمب ساعتی است. کوچک‌ترین دستکاری بدون استراتژی می‌تواند باگ‌های خاموش در بیزنس ایجاد کند که ماه‌ها بعد در محیط عملیاتی کشف شوند. این پکیج بر پایهٔ متدولوژی «تغییر ایمن و تدریجی» طراحی شده تا شما کدهای موسوم به اسپاگتی، فاقد تست، بدهی‌های فنی انباشته و ساختارهای منسوخ را به کدی تمیز، مقیاس‌پذیر و کاملاً تست‌پذیر تبدیل کنید.

رویکرد این پکیج، بازنویسی یک‌باره (Big Bang Rewrite) نیست؛ بلکه زنجیره‌ای متوالی از ۶ مرحله مهندسی است که در آن هوش مصنوعی مانند یک دستیار ارشد ریفکتورینگ در کنار شما عمل می‌کند. خروجی هر پرامپت مبنای محاسباتی و تصمیم‌گیری پرامپت بعدی خواهد بود.

### نقشهٔ مسیر پرامپت‌ها
۱. **پرامپت ۱: کالبدشکافی و استخراج رفتار موجود:** شناسایی ورودی‌ها، خروجی‌ها، عوارض جانبی (Side Effects) و استخراج نیازمندی‌های اعلام‌نشدهٔ بیزنس.
۲. **پرامپت ۲: تولید تست‌های ویژگی (Characterization Tests):** ایجاد یک توری نجات مطمئن جهت مهار رفتارهای فعلی سیستم بدون تغییر در آن.
۳. **پرامپت ۳: برنامه‌ریزی ریفکتور اتمیک:** تقسیم کدهای حجیم به ریزواحدهای مستقل و اولویت‌بندی مراحل بازنویسی بر اساس کاهش ریسک.
۴. **پرامپت ۴: بازنویسی اتمیک هسته:** بازنویسی هر تکه از کد طبق استراتژی و اتصال به تست‌های مرحله دوم.
۵. **پرامپت ۵: مدرن‌سازی و استانداردسازی کد:** افزودن تایپ‌های استاتیک، دپندنسی اینجکشن، مدیریت تمیز خطا و اصول کدنویسی پاک.
۶. **پرامپت ۶: ارزیابی رگرسیون و راهنمای مهاجرت:** مقایسه قراردادها، کشف گپ‌ها و تدوین سند گام‌به‌گام انتقال در سرور عملیاتی.

---

## پرامپت شماره ۱: کالبدشکافی عمیق و نقشه‌برداری رفتار پنهان
این پرامپت گام نخست است. هرگز پیش از استخراج رفتارهای پنهان و متغیرهای سراسری نباید کدی را بازنویسی کرد.

[ادامهٔ پرامپت‌های ۱ تا ۶، راهنمای عیب‌یابی و چک‌لیست کیفیت در نسخهٔ کامل آمده است.]