> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# الدين التقني Technical Debt: كيف تقيسه وتقنع الإدارة
- URL: https://arabroot.io/articles/الدين-التقني-technical-debt-كيف-تقيسه-وتقنع-الادارة/
- Published: 2026-11-16T15:12:25.000Z
- Updated: 2026-11-16T16:09:15.000Z
- Description: ما هو الدين التقني، وكيف تقيسه بأربع إشارات، وتحوله إلى حالة عمل بالريال لسنة واحدة، ثم تسدده دون أن توقف تطوير المنتج.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الفرق والمنتج, استراتيجية تقنية

إذا كنت قائد فريق أو مدير هندسة، فغالباً سمعت من فريقك جملة مثل «هذا الجزء من الكود لا أحد يجرؤ أن يلمسه»، ثم سمعت من الإدارة «لماذا تحتاج ميزة بسيطة ثلاثة أسابيع؟». والجملتان تصفان نفس المشكلة من جهتين: الدين التقني Technical Debt. والفريق يعرف أين هو، ولكنه لا يستطيع أن يشرحه بلغة يفهمها من يقرر الميزانية، فيبقى الدين ويكبر.

وهذا المقال لمن يريد أن يخرج من هذه الحلقة. سوف نشرح ما هو الدين التقني بالضبط، وكيف تقيسه بأرقام بدل الشكوى، وكيف تكتب حالة عمل Business Case بالريال يفهمها المدير المالي، ثم كيف تسدده دون أن توقف تطوير المنتج.

سوف نناقش في هذا المقال:

- من أين جاء التشبيه عند Ward Cunningham، والأصل والفائدة، ومربع Martin Fowler للأنواع الأربعة.
- أنواع الدين في الفريق التقني، وما ليس ديناً.
- أربع طرق للقياس: مقاييس التسليم DORA، والنقاط الساخنة Hotspots، والاستبيان، والوقت الضائع.
- سجل الدين Debt Register، ومثال محسوب لحالة العمل بأرقام سنة واحدة.
- طرق السداد: نسبة ثابتة من وقت الفريق، وقاعدة الكشافة Boy Scout Rule، والسبرنتات المخصصة، ومتى تعيد الكتابة.

## الخلاصة السريعة Quick Summary

💡

**التعريف:** كل اختصار في الكود أو التصميم يوفر وقتاً اليوم، ويجعل كل تعديل بعده أبطأ. الاختصار هو الأصل، والبطء المتكرر هو الفائدة.  
**ليس كله سيئاً:** الدين المقصود والمحسوب مقبول، مثل نسخة أولى سريعة لاختبار فكرة. المشكلة في الدين الذي لا يعرفه أحد ولا يسدده أحد.  
**القياس:** لا يوجد رقم واحد. اجمع أربع إشارات: زمن التسليم ونسبة فشل التغييرات، والملفات الساخنة، واستبيان المهندسين، والوقت الضائع.  
**الإقناع:** حول الدين إلى ريالات في السنة وموعد ميزات ومخاطر، لا إلى «الكود سيئ».  
**السداد:** نسبة ثابتة من كل سبرنت، وتنظيف ما تلمسه، وسبرنت مخصص للأجزاء الكبيرة. وتجنب إعادة الكتابة الكاملة إلا في حالات نادرة.

## ما هو الدين التقني Technical Debt؟

جاء التشبيه من Ward Cunningham، وهو من صمم أول Wiki وأحد موقعي بيان Agile. ففي [تقرير قدمه في مؤتمر OOPSLA سنة 1992](https://c2.com/doc/oopsla92.html?ref=arabroot.io) عن نظام مالي كان يعمل عليه، كتب: «إطلاق الكود لأول مرة يشبه الاستدانة. والدين القليل يسرع التطوير، بشرط أن يسدد بسرعة بإعادة الكتابة… والخطر عندما لا يسدد الدين، فكل دقيقة تقضيها على كود ليس صحيحاً تماماً تحسب فائدة على هذا الدين».

والتشبيه مفيد لأن المديرين يفهمون الديون. فهناك أصل Principal، وهو العمل اللازم لإصلاح الاختصار. وهناك فائدة Interest، وهي الوقت الإضافي الذي يدفعه الفريق في كل مرة يعمل قرب هذا الاختصار. ويشرح Martin Fowler ذلك في [مقاله عن الدين التقني](https://martinfowler.com/bliki/TechnicalDebt.html?ref=arabroot.io) بمثال بسيط:

- ميزة جديدة تحتاج أربعة أيام لو كان الكود منظماً، ولكنها تحتاج ستة أيام بسبب هيكل مربك. فاليومان الإضافيان هما الفائدة.
- إصلاح الهيكل يحتاج خمسة أيام. فإذا كانت هذه آخر ميزة في هذا الجزء، فالإصلاح خسارة: تسعة أيام بدل ستة.
- أما إذا كانت هناك ميزتان أخريان قادمتان في نفس الجزء، فالإصلاح يسدد نفسه، لأنك توفر يومين في كل ميزة.

وهذا المثال يحمل أهم قاعدة في المقال كله: **الدين يستحق السداد حيث يعمل الفريق كثيراً**. فالكود القبيح في ملف لم يتغير منذ ثلاث سنوات لا يكلفك شيئاً اليوم، أما الكود المربك في ملف يتغير كل أسبوع فيكلفك فائدة كل أسبوع.

### مربع الدين التقني Technical Debt Quadrant

في أكتوبر 2009 نشر Fowler [مربعاً](https://martinfowler.com/bliki/TechnicalDebtQuadrant.html?ref=arabroot.io) يقسم الدين حسب سؤالين: هل أخذناه عن قصد أم دون أن ننتبه؟ وهل كان قراراً متهوراً أم حكيماً؟

![مربع Fowler للدين التقني Technical Debt Quadrant من أربع خانات: متهور ومقصود Reckless Deliberate مثل «لا وقت للتصميم» يعرف الفريق الصواب ويتجاهله، وحكيم ومقصود Prudent Deliberate مثل «نطلق الآن ونتحمل النتائج» قرار محسوب لموعد مهم مع خطة سداد، ومتهور وغير مقصود Reckless Inadvertent مثل «ما هو التصميم؟» فريق لا يعرف الممارسات الجيدة، وحكيم وغير مقصود Prudent Inadvertent مثل «الآن عرفنا كيف كان يجب أن نبنيه» درس يأتي بعد البناء حتى للفرق الجيدة](https://arabroot.io/content/images/2026/11/tech-debt-01-quadrant.webp)

الخانة الحكيمة المقصودة قرار عمل مشروع، والخانتان المتهورتان مشكلة في الفريق أو الضغط، والحكيمة غير المقصودة جزء طبيعي من التعلم

| الخانة                                | كيف تبدو                                           | ماذا تفعل                                                  |
| ------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------- |
| حكيم ومقصود Prudent Deliberate        | «نطلق قبل المعرض بحل مؤقت، ونصلحه في الشهر التالي» | مقبول، بشرط أن يكتب في سجل الدين مع موعد السداد            |
| متهور ومقصود Reckless Deliberate      | «لا وقت للاختبارات، اكتب بسرعة»                    | غالباً ضغط مواعيد دائم، والحل في التخطيط لا في الكود       |
| متهور وغير مقصود Reckless Inadvertent | فريق لا يعرف أن هناك طريقة أفضل                    | تدريب، ومراجعة كود، ومهندس أول Senior Engineer يوجه        |
| حكيم وغير مقصود Prudent Inadvertent   | «الآن بعد أن بنيناه، عرفنا كيف كان يجب أن نبنيه»   | طبيعي حتى في أفضل الفرق، ويسدد عندما يعود العمل لهذا الجزء |

### أنواع الدين في الفريق Types of Debt

الدين ليس في الكود وحده. وعندما تجمعه، فكر في هذه الأنواع:

| النوع                         | مثال                                                     | كيف تظهر الفائدة                                                |
| ----------------------------- | -------------------------------------------------------- | --------------------------------------------------------------- |
| الكود Code                    | دالة من 800 سطر، أو منطق مكرر في خمسة أماكن              | كل تعديل يحتاج تعديل خمسة أماكن، وينسى أحدها                    |
| التصميم Architecture          | خدمتان تشتركان في نفس قاعدة البيانات وتعدلان نفس الجداول | لا يمكن نشر واحدة دون الأخرى                                    |
| الاختبارات Tests              | جزء مهم بلا اختبارات آلية                                | كل تعديل يحتاج اختباراً يدوياً طويلاً، أو يكسر شيئاً في الإنتاج |
| الاعتماديات Dependencies      | مكتبات أو إطار عمل متأخر عدة إصدارات                     | الترقية تصبح مشروعاً كاملاً، والثغرات الأمنية تبقى مفتوحة       |
| البنية التحتية Infrastructure | سيرفر يعد يدوياً ولا أحد يعرف إعداداته                   | الاستعادة بعد العطل تأخذ أياماً                                 |
| التوثيق Documentation         | لا يوجد شرح لطريقة النشر أو لقرارات التصميم              | الموظف الجديد يحتاج أسابيع ليصبح منتجاً                         |
| المعرفة Knowledge             | شخص واحد فقط يفهم نظام الفوترة                           | إجازته تعني توقف كل عمل في هذا الجزء                            |

وما ليس ديناً تقنياً مهم بنفس القدر، لأن خلطه بالدين يضعف حجتك أمام الإدارة: الخطأ Bug الذي يراه المستخدم خطأ وليس ديناً، والميزة الناقصة طلب منتج وليست ديناً، والتقنية التي لا يحبها الفريق ليست ديناً إذا كانت تعمل ولا تبطئ أحداً.

## كيف تقيس الدين؟ How to Measure

لا يوجد مقياس واحد للدين التقني، ومن يبيع لك رقماً واحداً يبسط أكثر من اللازم. وقد نشر فريق أبحاث إنتاجية المهندسين في Google، Ciera Jaspan وCollin Green، [مقالاً في IEEE Software سنة 2023](https://research.google/pubs/defining-measuring-and-managing-technical-debt/?ref=arabroot.io) عن تجربتهم في تعريف الدين وقياسه، واعتمدوا فيه على استبيان دوري للمهندسين يسألهم أي أنواع الدين أعاقت عملهم. والطريقة العملية أن تجمع أربع إشارات، كل واحدة تغطي ما لا تغطيه الأخرى:

![أربع إشارات لقياس الدين التقني: مقاييس التسليم DORA مثل زمن التسليم Lead Time ونسبة فشل التغييرات Change Fail Rate وتقول هل يبطئ الفريق، والنقاط الساخنة Hotspots أي الملفات التي تتغير كثيراً وهي معقدة وتقول أين الدين المكلف، واستبيان المهندسين Survey ربع سنوي ويقول ما يعيقهم ولماذا، والوقت الضائع Time Lost من التذاكر المصنفة والعمل غير المخطط ويحول الدين إلى ساعات ثم ريالات، وفي الوسط أن الإشارات التي تتفق على نفس الجزء هي ما يستحق السداد أولاً](https://arabroot.io/content/images/2026/11/tech-debt-02-four-signals.webp)

كل إشارة وحدها ناقصة: الأرقام تقول أين تنظر، والمهندسون يقولون لماذا، والوقت الضائع يحول ذلك إلى مال

### الإشارة الأولى: مقاييس التسليم DORA Metrics

برنامج أبحاث DORA (الذي تديره Google Cloud اليوم) يحدد مقاييس لأداء التسليم في الفرق. وحسب [صفحة المقاييس الرسمية](https://dora.dev/guides/dora-metrics-four-keys/?ref=arabroot.io) (آخر تحديث يناير 2026)، هي خمسة:

| المقياس                                                     | ماذا يقيس                                         | كيف يكشف الدين                                             |
| ----------------------------------------------------------- | ------------------------------------------------- | ---------------------------------------------------------- |
| زمن التسليم للتغيير Change Lead Time                        | من حفظ التعديل حتى وصوله للإنتاج                  | يطول عندما يحتاج كل تعديل اختباراً يدوياً أو موافقات كثيرة |
| تكرار النشر Deployment Frequency                            | كم مرة ينشر الفريق                                | يقل عندما يخاف الفريق من النشر                             |
| زمن التعافي من النشر الفاشل Failed Deployment Recovery Time | كم يحتاج الفريق ليعود بعد نشر فاشل                | يطول عندما لا يفهم أحد الجزء المتعطل                       |
| نسبة فشل التغييرات Change Fail Rate                         | نسبة النشرات التي تحتاج تراجعاً أو إصلاحاً عاجلاً | ترتفع في الأجزاء الهشة بلا اختبارات                        |
| نسبة إعادة العمل Deployment Rework Rate                     | نسبة النشرات غير المخطط لها بسبب حادثة في الإنتاج | ترتفع عندما يقضي الفريق وقته في الإطفاء                    |

وهذه المقاييس لا تقول «هنا الدين»، ولكنها تقول «الفريق يبطئ» أو «الأعطال تزيد». وقيمتها في الاتجاه: إذا كان زمن التسليم يزيد كل ربع سنة، فشيء ما يتراكم. ولا تقارن بها الفرق ببعضها، ولا تجعلها هدفاً لأحد، فقد شرحنا في [كيف تقيم أداء المطورين](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D9%82%D9%8A%D9%85-%D8%A7%D8%AF%D8%A7%D8%A1-%D8%A7%D9%84%D9%85%D8%B7%D9%88%D8%B1%D9%8A%D9%86-%D8%AF%D9%88%D9%86-%D9%82%D9%8A%D8%A7%D8%B3-%D8%A7%D9%84%D8%A7%D8%B4%D9%8A%D8%A7%D8%A1-%D8%A7%D9%84%D8%AE%D8%B7%D8%A7/) ماذا يحدث عندما يتحول المقياس إلى هدف.

### الإشارة الثانية: النقاط الساخنة Hotspots

هذه الفكرة من Adam Tornhill في كتابه «[Your Code as a Crime Scene](https://pragprog.com/titles/atcrime2/your-code-as-a-crime-scene-second-edition/?ref=arabroot.io)» (الطبعة الثانية، 2024). والفكرة بسيطة: سجل التعديلات في Git يحفظ كل ملف تغير ومتى. فإذا جمعت عدد مرات تغير كل ملف خلال سنة، ووضعت بجانبه مقياساً لتعقيده (مثل عدد الأسطر أو عمق التفرعات)، ستجد أن عدداً قليلاً من الملفات يجمع الصفتين: يتغير كثيراً ومعقد جداً. وهذه هي النقاط الساخنة، وهي حيث يدفع الفريق الفائدة فعلاً.

ولا تحتاج أن تفهم الكود لتقرأ النتيجة. فهذا مثال افتراضي لما يخرج من هذا التحليل:

| الملف أو الجزء   | عدد التعديلات في سنة | التعقيد  | القراءة                              |
| ---------------- | -------------------- | -------- | ------------------------------------ |
| حساب الفاتورة    | 142                  | عال جداً | نقطة ساخنة: الأولوية الأولى          |
| شاشة الطلبات     | 96                   | متوسط    | راقبه                                |
| تقارير قديمة     | 3                    | عال جداً | قبيح ولكنه لا يكلف شيئاً الآن، اتركه |
| إعدادات المستخدم | 40                   | منخفض    | صحي                                  |

والصف الثالث هو ما ينقذك من أشهر خطأ: تنظيف الكود الأقبح بدل الكود الأغلى. فمهندسوك سيشتكون من التقارير القديمة لأنها قبيحة، ولكن الأرقام تقول إن الفريق لا يلمسها.

### الإشارة الثالثة: استبيان المهندسين Developer Survey

المهندسون يعرفون أين الدين قبل أي مقياس، والاستبيان طريقة منظمة لجمع ما يعرفونه. واجعله قصيراً، كل ربع سنة، بأسئلة مثل:

- في الأشهر الثلاثة الماضية، كم أعاقك الدين التقني في عملك؟ (من «لم يعقني» إلى «أعاقني كثيراً»).
- أي أنواع الدين أعاقتك؟ (اختر من قائمة: كود، اختبارات، اعتماديات، توثيق، معرفة عند شخص واحد…).
- ما الجزء من النظام الذي تتمنى ألا تعمل فيه؟ ولماذا؟
- لو كان لديك أسبوع كامل لإصلاح شيء واحد، ماذا تختار؟

والسؤال الأخير مفيد جداً، لأن الإجابات المتكررة من أشخاص مختلفين تعطيك قائمة أولويات جاهزة. وقد شرحنا طريقة بناء استبيان لا يكذب فيه الناس في [قياس صحة الفريق Team Health](https://arabroot.io/articles/%D9%82%D9%8A%D8%A7%D8%B3-%D8%B5%D8%AD%D8%A9-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82-team-health-%D9%85%D8%A4%D8%B4%D8%B1-enps-%D9%88%D9%86%D8%B3%D8%A8%D8%A9-%D8%A7%D9%84%D8%AF%D9%88%D8%B1%D8%A7%D9%86/).

### الإشارة الرابعة: الوقت الضائع Time Lost

هذه هي الإشارة التي تحتاجها لحالة العمل، لأنها تتحول إلى مال. وأشهر رقم منشور عنها من تقرير [Developer Coefficient](https://stripe.com/files/reports/the-developer-coefficient.pdf?ref=arabroot.io) الذي نشرته Stripe في سبتمبر 2018، بعد استبيان مع Harris Poll شمل أكثر من 1,000 مطور وأكثر من 1,000 مدير تنفيذي في عدة دول. فحسب التقرير، كان متوسط أسبوع المطور 41.1 ساعة، منها حوالي 13.5 ساعة على الدين التقني و3.8 ساعة على «الكود السيئ»، أي 17.3 ساعة، وهذا يقارب 42% من الأسبوع.

وهذا الرقم تقدير المشاركين أنفسهم، ومن سنة 2018، فلا تضعه في عرضك كأنه رقم شركتك. استخدمه لتقول «هذا ليس أمراً غريباً»، ثم قس رقمك أنت بطريقتين بسيطتين:

1. **صنف التذاكر:** أضف تصنيفاً «دين» للتذاكر التي سببها الدين، وتصنيفاً «غير مخطط» للأعطال والإصلاحات العاجلة. وبعد شهرين تعرف أي نسبة من وقت الفريق تذهب لها.
2. **اسأل في تخطيط كل ميزة:** «كم كانت ستأخذ لو كان هذا الجزء نظيفاً؟». والفرق بين الرقمين هو الفائدة، كما في مثال Fowler، وسجله في سجل الدين.

## سجل الدين Debt Register

الدين الذي لا يكتب لا يسدد. وسجل الدين جدول بسيط في أداة الفريق أو في صفحة الـ Wiki، يجمع كل بند مع تكلفته. وهذا قالب له مع مثال:

| الحقل                             | ماذا تكتب                             | مثال                                                          |
| --------------------------------- | ------------------------------------- | ------------------------------------------------------------- |
| البند                             | وصف قصير للمشكلة                      | حساب الفاتورة في دالة واحدة بلا اختبارات                      |
| النوع                             | كود، تصميم، اختبارات، اعتماديات…      | كود واختبارات                                                 |
| الفائدة                           | كيف يبطئ الفريق، وكم تقريباً          | كل تعديل على الفوترة يأخذ ضعف الوقت، وحادثتان في الربع الماضي |
| الإشارات                          | من أين عرفنا                          | نقطة ساخنة أولى، و7 من 9 مهندسين ذكروها في الاستبيان          |
| تكلفة السداد                      | تقدير بنطاق                           | من 6 إلى 10 أسابيع لمهندسين اثنين                             |
| ما الذي يأتي قريباً في هذا الجزء؟ | الميزات المخطط لها التي ستدفع الفائدة | الفوترة بالدفعات، والضريبة الجديدة على الخدمات                |
| المالك والقرار                    | من يتابع، وماذا تقرر                  | قائد الفريق، ويسدد في الربع القادم                            |

والحقل قبل الأخير هو الأهم عند الترتيب. فالدين في جزء ستعمل عليه الأشهر القادمة يستحق السداد أولاً، حتى لو كان أقل قبحاً من غيره. وكثير من بنود السجل سيبقى سنوات دون سداد، وهذا طبيعي إذا كان قراراً واعياً لا نسياناً.

## كيف تقنع الإدارة؟ The Business Case

جملة «الكود سيئ ونحتاج وقتاً لإصلاحه» تفشل دائماً، لأنها تطلب من المدير أن يدفع مقابل شيء لا يراه. والجملة التي تنجح تتحدث بلغته: كم ريالاً نخسر في السنة، وما الذي يتأخر من خطة المنتج، وما الخطر على العملاء.

### مثال محسوب: سنة واحدة Worked Example

لنأخذ مثالاً بأرقام افتراضية مستديرة للتوضيح، ويمكنك أن تضع أرقامك مكانها:

- فريق من 6 مهندسين، وتكلفة المهندس الكاملة على الشركة (الراتب والبدلات والتأمينات والأجهزة) 360,000 ريال في السنة. أي أن الفريق يكلف 2,160,000 ريال سنوياً.
- تصنيف التذاكر لمدة شهرين، مع الاستبيان، أظهر أن حوالي 30% من وقت الفريق يذهب للالتفاف حول مشاكل جزء الفوترة وإصلاح أعطاله.
- السداد: مهندسان لمدة ثلاثة أشهر لإعادة تنظيم الجزء وكتابة اختباراته، ونتوقع أن تنخفض النسبة إلى حوالي 10%.

| البند                                | الحساب                                                                                               | القيمة                           |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------- | -------------------------------- |
| الفائدة الحالية في السنة             | 30% × 2,160,000                                                                                      | 648,000 ريال                     |
| الفائدة المتوقعة بعد السداد في السنة | 10% × 2,160,000                                                                                      | 216,000 ريال                     |
| تكلفة السداد                         | مهندسان × 3 أشهر = نصف سنة مهندس × 360,000                                                           | 180,000 ريال                     |
| **السنة الأولى**                     | توفير 9 أشهر بعد انتهاء السداد: (648,000 ناقص 216,000) × 9 ÷ 12 = 324,000، ناقص تكلفة السداد 180,000 | **توفير صاف حوالي 144,000 ريال** |
| **كل سنة بعدها**                     | 648,000 ناقص 216,000                                                                                 | **توفير حوالي 432,000 ريال**     |

وبلغة المنتج، 432,000 ريال في السنة تعني وقت مهندس واحد وزيادة يعود للميزات. وإذا كانت خطة المنتج فيها ميزتان كبيرتان في الفوترة، فقل بوضوح كم ستتأخر كل منهما إذا بقي الدين، كما في مثال Fowler.

⚠️

كن صادقاً في الأرقام: النسب تقديرات من التذاكر والاستبيان، وليست قياساً دقيقاً. فقلها بنطاق («بين 25% و35%»)، واذكر من أين جاءت، واتفق على كيف ستقيس النتيجة بعد السداد. فالمدير الذي يكتشف أنك بالغت مرة واحدة لن يصدق حالتك التالية.

### صفحة واحدة للإدارة One-page Case

واجمع كل ذلك في صفحة واحدة، بالترتيب الذي يقرأ به المدير:

![قالب صفحة واحدة لحالة عمل سداد الدين التقني Business Case: المشكلة بلغة العمل مثل أن كل تعديل على الفوترة يأخذ ضعف الوقت وحادثتان في الربع الماضي، والتكلفة الحالية 648,000 ريال في السنة من 30% من وقت فريق من 6، والطلب مهندسان لثلاثة أشهر بتكلفة 180,000 ريال، والعائد في السنة الأولى توفير صاف حوالي 144,000 ريال وكل سنة بعدها حوالي 432,000 ريال، والأثر على خطة المنتج، والمخاطر إذا لم نفعل، وكيف نقيس النجاح بزمن التسليم ونسبة فشل التغييرات والوقت الضائع بعد ثلاثة أشهر](https://arabroot.io/content/images/2026/11/tech-debt-03-one-page.webp)

صفحة واحدة بلغة الإدارة: المشكلة، والتكلفة، والطلب، والعائد بسنة واحدة، وكيف نقيس النجاح (الأرقام من المثال الافتراضي)

ونصيحتان من الواقع: اعرض الحالة مع خطة المنتج لا ضدها، أي «نسدد هذا الدين لأن ميزات الربع القادم في هذا الجزء». واطلب شيئاً محدداً بموعد ونتيجة تقاس، لا «وقتاً للتنظيف» مفتوحاً. وإذا كان الاقتراح كبيراً ويحتاج موافقة عدة أطراف، فقد شرحنا طريقة التمهيد له في [مواءمة أصحاب المصلحة Stakeholders](https://arabroot.io/articles/%D9%85%D9%88%D8%A7%D8%A1%D9%85%D8%A9-%D8%A7%D8%B5%D8%AD%D8%A7%D8%A8-%D8%A7%D9%84%D9%85%D8%B5%D9%84%D8%AD%D8%A9-%D9%88%D8%B3%D9%8A%D8%A7%D8%B3%D8%A9-%D8%A7%D9%84%D9%85%D8%A4%D8%B3%D8%B3%D8%A9/).

## كيف تسدد الدين؟ Paying It Down

هناك عدة طرق للسداد، وأغلب الفرق تجمع بين اثنتين أو ثلاث. والجدول التالي يقارنها:

| الطريقة                          | كيف تعمل                                                                   | مناسبة لـ                                    | خطرها                                               |
| -------------------------------- | -------------------------------------------------------------------------- | -------------------------------------------- | --------------------------------------------------- |
| نسبة ثابتة من الوقت              | جزء ثابت من كل سبرنت، 20% مثلاً، يذهب لبنود سجل الدين                      | الدين المستمر الصغير والمتوسط                | يذهب الوقت لأول أزمة إذا لم تحمه الإدارة            |
| قاعدة الكشافة Boy Scout Rule     | كل من يعمل في جزء يتركه أنظف قليلاً مما وجده                               | الكود الذي يتغير كثيراً، أي النقاط الساخنة   | لا تكفي للمشاكل الكبيرة في التصميم                  |
| السداد قبل الميزة                | عندما تأتي ميزة في جزء مدين، يبدأ العمل بتنظيمه، ويحسب ذلك في تقدير الميزة | الدين الذي يعيق ميزة محددة                   | يجعل تقدير الميزة أكبر، فاشرح السبب                 |
| سبرنت أو أسبوع مخصص              | دورة كاملة للفريق على بنود محددة من السجل                                  | بنود كبيرة تحتاج تركيزاً، مثل ترقية إطار عمل | يصبح عذراً لتأجيل السداد اليومي «حتى سبرنت التنظيف» |
| الاستبدال التدريجي Strangler Fig | بناء الجزء الجديد بجانب القديم ونقل الوظائف تدريجياً                       | نظام قديم كامل يحتاج تغييراً جذرياً          | طويل، ويحتاج التزاماً لعدة أرباع                    |

وقاعدة الكشافة أصلها في حركة الكشافة: «اترك المخيم أنظف مما وجدته». ونقلها Robert C. Martin إلى البرمجة في كتابه «Clean Code» (2008): لا يطلب منك أن تعيد كتابة الملف، وإنما أن تحسن اسماً، أو تقسم دالة طويلة، أو تضيف اختباراً، في كل مرة تمر به. ولأن النقاط الساخنة هي الملفات التي يمر بها الفريق أكثر، فهذه القاعدة تسدد الدين حيث يكلف أكثر، دون أن يطلب أحد إذناً من الإدارة.

أما النسبة الثابتة فلا يوجد رقم سحري لها، والمهم أن تكون ثابتة ومعلنة ومحمية. فإذا كانت الإدارة توافق على 20% ثم تأخذها في كل سبرنت لميزة عاجلة، فهي في الواقع صفر. والطريقة الأفضل أن تتفق مع مدير المنتج على النسبة مرة واحدة في الربع، لا في كل سبرنت.

### ومتى تعيد الكتابة Rewrite؟

عندما يكبر الدين، يقترح الفريق غالباً: «لنعد كتابة النظام من الصفر». وهذا أخطر قرار في هذا الموضوع. وقد كتب Joel Spolsky في سنة 2000 مقالاً مشهوراً بعنوان «[Things You Should Never Do](https://www.joelonsoftware.com/2000/04/06/things-you-should-never-do-part-i/?ref=arabroot.io)» وصف فيه قرار Netscape بإعادة كتابة متصفحها من الصفر بأنه «أسوأ خطأ استراتيجي يمكن أن ترتكبه شركة برمجيات»، لأن الشركة قضت سنوات دون إصدار جديد بينما تقدم المنافسون، ولأن الكود القديم القبيح يحمل إصلاحات لأخطاء حقيقية اكتشفت عبر سنوات، وتضيع كلها مع إعادة الكتابة.

لذلك فالقاعدة: أعد الكتابة على أجزاء، لا دفعة واحدة، واستبدل كل جزء وهو يعمل. وقد شرحنا هذه الطريقة وطرق التحديث السبع في [تحديث الأنظمة القديمة Legacy](https://arabroot.io/articles/%D8%AA%D8%AD%D8%AF%D9%8A%D8%AB-%D8%A7%D9%84%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D9%82%D8%AF%D9%8A%D9%85%D8%A9-legacy-modernization-%D8%AA%D8%B1%D9%82%D9%8A%D8%A9-%D8%A7%D9%85-%D8%A7%D8%B3%D8%AA%D8%A8%D8%AF%D8%A7%D9%84/).

## ثلاثة مواقف شائعة Common Situations

**الموقف الأول: استلمت فريقاً جديداً، والجميع يشتكي من الدين.** لا تبدأ بخطة سداد في الأسبوع الأول. اجمع الإشارات الأربع خلال الشهر الأول: اسأل كل مهندس في الاجتماع الفردي «لو كان لديك أسبوع لإصلاح شيء واحد، ماذا تختار؟»، واطلب تحليل النقاط الساخنة، واقرأ تذاكر آخر ربعين. ثم اكتب سجل الدين الأول، ورتبه حسب ما سيعمل عليه الفريق في الأشهر القادمة. وبهذا تعرض على الإدارة في نهاية الشهر الأول خمسة بنود مرتبة بأرقام، بدل قائمة شكاوى من خمسين بنداً.

**الموقف الثاني: الإدارة تريد ميزات فقط، وترفض أي وقت للسداد.** لا تطلب «وقتاً للتنظيف». اختر بنداً واحداً يعيق ميزة تريدها الإدارة فعلاً، واحسب التأخير الذي يسببه بطريقة مثال Fowler: «الميزة تحتاج ستة أسابيع بالوضع الحالي، أو أربعة أسابيع تنظيم ثم أسبوعين للميزة، والميزة التي بعدها في نفس الجزء ستكون أسرع». وبعد أن ينجح البند الأول وتظهر نتيجته في زمن التسليم، يصبح طلب النسبة الثابتة أسهل بكثير. وفي هذه الأثناء، طبق قاعدة الكشافة، لأنها لا تحتاج إذناً.

**الموقف الثالث: الفريق يريد إعادة كتابة النظام كله.** اسأل ثلاثة أسئلة قبل أي قرار: ما المشكلة التي ستحلها إعادة الكتابة ولا يحلها الاستبدال التدريجي؟ ومن سيصلح الأخطاء ويضيف الميزات في النظام القديم أثناء سنة أو أكثر من إعادة الكتابة؟ وكيف سننقل البيانات والعملاء؟ وغالباً ستجد أن ما يريده الفريق فعلاً هو التخلص من جزءين أو ثلاثة مؤلمة، وأن استبدالها على مراحل يعطي نفس النتيجة بخطر أقل. وإذا قررتم الاستبدال الكامل رغم ذلك، فاكتبوا القرار وأسبابه في سجل قرار ADR، كما شرحنا في [القرار التقني في الفريق](https://arabroot.io/articles/%D8%A7%D9%84%D9%82%D8%B1%D8%A7%D8%B1-%D8%A7%D9%84%D8%AA%D9%82%D9%86%D9%8A-%D9%81%D9%8A-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82-adr-%D9%88%D8%A7%D9%84%D8%AE%D9%84%D8%A7%D9%81-%D8%A7%D9%84%D9%85%D8%AD%D8%AA%D8%B1%D9%85/).

## أخطاء شائعة Common Mistakes

- **«الكود سيئ» حجة:** لا يقنع أحداً. حول الشكوى إلى وقت ضائع وريالات وميزات متأخرة.
- **تنظيف الأقبح لا الأغلى:** ابدأ بالنقاط الساخنة التي يتغير فيها الكود كثيراً.
- **كل شيء دين:** عندما يصبح كل ما لا يحبه الفريق ديناً، تفقد القائمة مصداقيتها. ميز الدين عن الأخطاء والتفضيلات.
- **المبالغة في الأرقام:** قلها بنطاق ومصدر، وإلا خسرت ثقة الإدارة في الحالة التالية.
- **نسبة ثابتة غير محمية:** 20% تختفي في أول أزمة إذا لم تتفق عليها مع مدير المنتج.
- **سبرنت التنظيف بديلاً عن العادة:** سبرنت كل ستة أشهر لا يعوض قاعدة الكشافة كل يوم.
- **إعادة الكتابة الكاملة:** نادراً ما تكون الحل، والاستبدال التدريجي أقل خطراً.
- **دين مقصود بلا سجل:** «حل مؤقت» دون موعد سداد مكتوب يصبح دائماً.

## قائمة تحقق Checklist

| البند                                                           | نعم/لا |
| --------------------------------------------------------------- | ------ |
| لدينا سجل دين مكتوب، ولكل بند فائدة وتكلفة سداد ومالك           |        |
| نعرف النقاط الساخنة في الكود من سجل التعديلات                   |        |
| نتابع زمن التسليم ونسبة فشل التغييرات كل شهر، ونقرأ الاتجاه     |        |
| نسأل المهندسين كل ربع سنة عن الدين الذي يعيقهم                  |        |
| التذاكر مصنفة: ميزة، دين، غير مخطط                              |        |
| حالة العمل بالريال لسنة واحدة، بنطاق ومصدر لكل رقم              |        |
| نسبة ثابتة من الوقت للسداد، متفق عليها مع مدير المنتج للربع كله |        |
| كل دين مقصود يكتب في السجل مع موعد سداد                         |        |
| نقيس النتيجة بعد السداد بنفس الإشارات                           |        |

ومقالات مرحلة «الفريق داخل المؤسسة» تكمل هذا الموضوع:

[![](https://arabroot.io/content/images/2026/10/team-size-cover-cover.webp)دليلهل يسلم الفريق الأكبر أسرع؟ قانون Brooks والذكاء الاصطناعيماذا تقول الدراسات عن حجم فريق البرمجة وسرعة التسليم، ومتى تفيد إضافة الأشخاص، وما الذي يغيره الذكاء الاصطناعي فعلاً.](https://arabroot.io/articles/%D9%87%D9%84-%D9%8A%D8%B3%D9%84%D9%85-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82-%D8%A7%D9%84%D8%A7%D9%83%D8%A8%D8%B1-%D8%A7%D8%B3%D8%B1%D8%B9-%D9%82%D8%A7%D9%86%D9%88%D9%86-brooks/)[![](https://arabroot.io/content/images/2026/10/stakeholders-cover-cover-1.webp)دليلمواءمة أصحاب المصلحة Stakeholders وسياسة المؤسسةكيف تجعل المؤثرين في القرار شركاء في اقتراحك التقني قبل الاجتماع، وتقول لا مع خيارات، وتصعد خلافاً دون أن تخسر زملاءك.](https://arabroot.io/articles/%D9%85%D9%88%D8%A7%D8%A1%D9%85%D8%A9-%D8%A7%D8%B5%D8%AD%D8%A7%D8%A8-%D8%A7%D9%84%D9%85%D8%B5%D9%84%D8%AD%D8%A9-%D9%88%D8%B3%D9%8A%D8%A7%D8%B3%D8%A9-%D8%A7%D9%84%D9%85%D8%A4%D8%B3%D8%B3%D8%A9/)[![](https://arabroot.io/content/images/2026/11/remote-teams-cover-cover.webp)دليلالفرق عن بعد والهجينة Remote and Hybrid: ما ينجحكيف يكتب الفريق البعيد ويجتمع ويعمل عبر المناطق الزمنية ويستقبل موظفيه الجدد، بناءً على دراسات منشورة وأدلة GitLab وBasecamp.](https://arabroot.io/articles/%D8%A7%D9%84%D9%81%D8%B1%D9%82-%D8%B9%D9%86-%D8%A8%D8%B9%D8%AF-%D9%88%D8%A7%D9%84%D9%87%D8%AC%D9%8A%D9%86%D8%A9-remote-and-hybrid-%D8%A7%D9%84%D9%85%D9%85%D8%A7%D8%B1%D8%B3%D8%A7%D8%AA-%D9%88%D8%A7%D9%84%D8%A7%D8%AF%D9%88%D8%A7%D8%AA/)[![](https://arabroot.io/content/images/2026/11/blameless-postmortem-cover-cover.webp)دليلكيف تدير مراجعة الحادثة دون لوم Blameless Postmortemدليل خطوة بخطوة لمن يدير مراجعة ما بعد الحادثة: الخط الزمني والعوامل المساهمة ولغة دون لوم وإجراءات لها مالك، مع قالب جاهز.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%AF%D9%8A%D8%B1-%D9%85%D8%B1%D8%A7%D8%AC%D8%B9%D8%A9-%D8%A7%D9%84%D8%AD%D8%A7%D8%AF%D8%AB%D8%A9-%D8%AF%D9%88%D9%86-%D9%84%D9%88%D9%85-blameless-postmortem/)[![](https://arabroot.io/content/images/2026/11/estimation-cover-cover.webp)دليللماذا يفشل التقدير Estimation في البرمجيات؟لماذا يتأخر كل مشروع برمجي عن تقديره، وكيف تتوقع الموعد من بيانات فريقك وتقوله للإدارة نطاقاً بنسبة ثقة بدل رقم واحد.](https://arabroot.io/articles/%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D9%8A%D9%81%D8%B4%D9%84-%D8%A7%D9%84%D8%AA%D9%82%D8%AF%D9%8A%D8%B1-estimation-%D9%81%D9%8A-%D8%A7%D9%84%D8%A8%D8%B1%D9%85%D8%AC%D9%8A%D8%A7%D8%AA-%D9%88%D9%85%D8%A7-%D8%A7%D9%84%D8%A8%D8%AF%D9%8A%D9%84/)[![](https://arabroot.io/content/images/2026/11/legacy-modernization-cover-cover.webp)دليلتحديث الأنظمة القديمة Legacy: ترقية أم استبدال تدريجي؟كيف تقرر مصير نظام قديم ما زالت جهتك تحتاجه، ومتى يكفي تحديثه ومتى تستبدله على أجزاء دون أن يتوقف العمل.](https://arabroot.io/articles/%D8%AA%D8%AD%D8%AF%D9%8A%D8%AB-%D8%A7%D9%84%D8%A7%D9%86%D8%B8%D9%85%D8%A9-%D8%A7%D9%84%D9%82%D8%AF%D9%8A%D9%85%D8%A9-legacy-modernization-%D8%AA%D8%B1%D9%82%D9%8A%D8%A9-%D8%A7%D9%85-%D8%A7%D8%B3%D8%AA%D8%A8%D8%AF%D8%A7%D9%84/)

## الخلاصة Summary

- الدين التقني اختصار يوفر وقتاً اليوم ويبطئ كل تعديل بعده. والفائدة هي الوقت الإضافي المتكرر، وتدفعها فقط حيث يعمل الفريق.
- مربع Fowler يفرق بين الدين الحكيم المقصود، وهو قرار عمل مشروع، والدين المتهور الذي يحتاج علاجاً في الفريق أو التخطيط.
- قس بأربع إشارات معاً: مقاييس DORA، والنقاط الساخنة، واستبيان المهندسين، والوقت الضائع من التذاكر.
- حالة العمل تقال بالريال لسنة واحدة: الفائدة الحالية، وتكلفة السداد، والتوفير في السنة الأولى وكل سنة بعدها، مع أثرها على خطة المنتج.
- سدد بنسبة ثابتة محمية، وقاعدة الكشافة، والسداد قبل الميزة، وسبرنت مخصص للبنود الكبيرة. وتجنب إعادة الكتابة الكاملة.

## سجل التحديثات Changelog

- 2026-11-16: كتابة المقال، والتحقق من تقرير Ward Cunningham في OOPSLA 1992، ومقالي Martin Fowler عن الدين التقني ومربعه، وصفحة مقاييس DORA (تحديث يناير 2026)، وتقرير Stripe Developer Coefficient (سبتمبر 2018)، ومقال Jaspan وGreen في IEEE Software (2023)، ومقال Joel Spolsky (أبريل 2000). أرقام المثال المحسوب افتراضية للتوضيح.