وثيقة التصميم الخاصة بك هي في الحقيقة وثيقة سياسية

كل وثيقة تصميم كتبتُها أو راجعتُها تعيش عند تقاطع محادثتين: التقنية التي تدّعي الوثيقة أنها عنها، والسياسية التي تخوضها المؤسسة فعلاً حول النطاق والملكية والميزانية. التظاهر بأن الأولى فقط موجودة هو كيف تُعتمد التصاميم وتشحن في دوائر على أي حال. هذا المنشور كيف تعلّمتُ الكتابة لكلا الجمهورين دون خسارة أيٍّ منهما.

جمهوران، محادثتان

كل وثيقة تصميم جيّدة تُجيب على سؤالين في آنٍ واحد:

• السؤال التقني: كيف يجب أن يعمل هذا الشيء؟
• السؤال السياسي: من يملكه، من يموّله، من يأخذ الفضل، من يخسر المرونة، من يجب أن يقول نعم لكي يحدث؟

تدّعي الوثيقة أنها عن الأول. الاجتماع يكون عادةً عن الثاني. إن كتبتَ للجمهور التقني فحسب، ستحصل على تعليقات مثل “يبدو هذا جيداً، دعنا نُقلّص النطاق” ثم تراقب نطاقك يتوسّع من جديد في خيط Slack بعد ثلاثة أسابيع، بدونك.

كيف تعلّمتُ هذا بالطريقة الصعبة

في إحدى أوائل فترات إدارتي الهندسية، كتبتُ ما ظننتُه وثيقة تصميم رائعة لتوحيد بنية تحتية. مخطّطات المعمارية: نظيفة. المقايضات: مُعدَّدة. خطّة الترحيل: ذرّية. البدائل: مدروسة.

الوثيقة اعتُمدت في المراجعة. بعد ستة أشهر، شحن المشروع ما يقارب 40% من الخطّة، فريقان مجاوران كانا يعملان على نسختيهما من نفس العمل، وكنتُ في غرفة أحاول شرح السبب لـVP. خرجتُ من تلك الغرفة وأدركتُ:

• وثيقتي لم تُسمّ قط الـVPs الثلاثة الذين لهم مطالبات متداخلة على الأنظمة التي كنت أوحّدها.
• لم تعترف بأن دورة استعداد الفريق A كانت قيداً على نافذة الترحيل.
• لم تقل ما لن نفعله عن قصد، مما جعل الفِرق الأخرى تفترض أن ميزتها المفضّلة ضمن النطاق.
• لم تُسمّ من سيملك النظام الموحَّد بعد بنائه، مما جعل الجواب “لا أحد” بحلول الوقت المهمّ.

كانت المعمارية جيّدة. الوثيقة فشلت سياسياً، وتعلّمتُ - بالطريقة الصعبة - أن السياسة هي جزء من التصميم.

القالب الذي أستخدمه الآن

كل وثيقة تصميم كتبتُها منذئذٍ تحتوي على هذه الأقسام، بهذا الترتيب. الأقسام السياسية حاملة للثقل، لا اختيارية:

1. المشكلة (فقرة واحدة، مرئية للمستخدم أو التشغيل)
2. القيود (الفِرق، الميزانيات، الجداول الزمنية، الأنظمة القائمة)
3. المقترح (ملخّص فقرة واحدة قبل التفاصيل)
4. ما ليس ضمن الأهداف (ما لا تفعله هذه الخطّة صراحةً)
5. البدائل المدروسة (اثنان على الأقل؛ لكل منها سبب خسارته)
6. التصميم التقني (مخطّطات + نثر)
7. خطّة الترحيل/الطرح
8. الملكية (أسماء بشر؛ "فريق المنصة" ليس اسماً)
9. الأسئلة المفتوحة (ما لا نعرفه بعد)
10. سجل القرارات (ما قُرّر في المراجعة، متى، بواسطة من)

الأقسام التي يتوقّعها الجميع هي 3 و6 و7. هذا حيث تعيش المعمارية. لكن الأقسام 2 و4 و8 هي حيث إما تشحن الوثيقة المشروع أو تقتله بهدوء.

القيود ليست حواشي

القسم 2 يجب أن يكون الأكثر جدلاً في المراجعة. لا التصميم التقني. القيود.

القيد يبدو هكذا:

• “دورة استعداد الفريق A لا تستطيع استيعاب مزيد من التنبيهات - أي خدمة جديدة يجب أن تحقّق معيار صفحات-صفر-إضافية قبل تحويل حركة المرور.”
• “نافذة ترحيل قاعدة البيانات هي ساعتان في الربع. أي تصميم يتطلّب أكثر لا يمكن شحنه.”
• “ميزانية هذا المشروع هي صفر إنفاق إضافي على البنية التحتية - يجب أن نتّسع ضمن الطاقة القائمة.”
• “VP X أعلن هذه الميزة للمجلس للربع الثالث. تصميم يتأخّر عن الربع الثالث مكلّف سياسياً بغضّ النظر عن جدارته الهندسية.”

إن كتبتَ تلك، تكتب المحادثة السياسية في الوثيقة. الأشخاص الذين يقرؤونها يعرفون الآن ما الذي يوافقون عليه أو يختلفون معه. البديل - ترك تلك القيود ضمنية وأمل أن الجميع يشاركك فهمها - هو كيف يخرج ستة أشخاص من مراجعة تصميم يحمل كل منهم مشروعاً مختلفاً في ذهنه.

ما ليس ضمن الأهداف هو كيف تحمي النطاق

القسم 4 - ما ليس ضمن الأهداف - هو أعلى قسم بالمردود في أي وثيقة تصميم.

يقول صراحةً: “هذا المقترح لا يشمل X أو Y أو Z. إن أردتَ تلك، فذاك وثيقة مختلفة.”

في مراجعة تصميم صحية، قسم ما ليس ضمن الأهداف هو حيث يُمسَك تضخّم النطاق مبكّراً. بدونه، يحدث تضخّم النطاق بهدوء في الأشهر التي تلي الاعتماد، حين يبدأ أصحاب المصلحة الذين لم يحضروا المراجعة في افتراض أن قلقهم المجاور مشمول.

أرفض الآن اعتماد وثيقة تصميم بلا قسم لما ليس ضمن الأهداف. وثيقة بلا أهداف منتفية وثيقة وافقت على كل شيء بالإغفال.

الملكية بأسماء، لا بألقاب

القسم 8 - الملكية - هو القسم الذي إما تُسنَد فيه المسؤولية أو تتسرّب إلى الفراغ.

جيّد:

الملكية: أمل ح. تملك الطرح. بعد الطرح، يملك فريق المخزون (DRI: بن ل.) التشغيل. SLOs مُعرَّفة في ops/inventory.md. بعد 90 يوماً من التشغيل المستقر، تنتقل الملكية إلى فريق المنصة (DRI: بريا ن.) للصيانة طويلة الأمد.

سيئ:

الملكية: سيملك فريق المنصة هذا.

النسخة السيئة تبدو كملكية لكنها ليست كذلك - “فريق المنصة” ليس لديه تقويم، ولا pager، ولا تقييم أداء. تسمية إنسان تُنشئ علاقة بين شخص ومسؤولية. تسمية فريق تخلق تشتّت المسؤولية.

الكتابة للمراجعة مقابل الكتابة للاعتماد

دقّة تُخطئها معظم وثائق التصميم: الوثيقة التي تكتبها لمراجعة صحية ليست نفس التي تكتبها لمسرح الاعتماد.

وثيقة صديقة للمراجعة:

• فيها أهداف منتفية كثيرة.
• تُعدّد البدائل بصدق، بما فيها تلك التي يعتقد المؤلّف أنها الأسوأ.
• فيها قسم “أسئلة مفتوحة” مليء بأشياء غير محسومة فعلاً.
• تنتهي بسجل قرارات يُملأ بعد المراجعة.

وثيقة مسرح الاعتماد:

• فيها “الخطّة”، مُقدَّمة كأمر لا مفرّ منه.
• ترفض البدائل بجملة واحدة لكل منها.
• لا أسئلة مفتوحة لأن المؤلّف لا يريد أن يبدو غير مستعدّ.
• سجل القرارات مُملأ مسبقاً بـ”مُعتمَد.”

إن كانت ثقافة وثائق التصميم في مؤسّستك تكافئ وثائق مسرح الاعتماد، فتلك الثقافة تفشل - لكنها أيضاً قابلة للإصلاح، بدءاً من وثائقك الخاصة. اكتب وثائق صديقة للمراجعة واقبل أن بعضها سيُرفض. هكذا كان يجب أن تعمل مراجعة التصميم دائماً. معدّل اعتماد 100% هو عملية اعتماد بنسبة 0%.

لفتة 2026

الكتابة بمساعدة الذكاء الاصطناعي تغيّر شيئاً هنا. أستطيع الآن توليد مسوّدة “تبدو كاملة” لوثيقة تصميم في 20 دقيقة. هذا رائع للأقسام التقنية - تخرج منظّمة مع مقايضات مُعدَّدة، بأسلوب نثر متسق.

إنه ضار بنشاط للأقسام السياسية. LLM لا يعرف من هم الـVPs الثلاثة ذوو المطالبات المتداخلة. لا يعرف أي استعداد الفريق هشّ. لا يعرف ما هو التظاهر بالميزانية في هذا الربع مقابل الميزانية الحقيقية.

سير عملي الحالي: أترك الذكاء الاصطناعي يُسوّد الأقسام 3 و6 و7 و9. أكتب الأقسام 1 و2 و4 و8 و10 بنفسي. يستطيع الذكاء الاصطناعي مساعدة النثر في تلك أيضاً، لكن الجوهر يجب أن يأتي مني لأنه يعيش في رؤوس الناس، لا في المستودع.

السؤال الواحد الذي أطرحه على كل وثيقة تصميم

قبل أن أعتمد أو أرفض وثيقة تصميم، أسأل المؤلّف سؤالاً واحداً بصوت عالٍ: “من سيكون غير سعيد إن شُحن هذا بالضبط كما هو مكتوب؟”

إن لم يستطع تسمية أشخاص محدّدين، الوثيقة ليست جاهزة للمراجعة. لأن أولئك الأشخاص موجودون - دائماً - وإن لم يعرف المؤلّف من هم، سيظهرون في الشهر الثالث يسألون لماذا لم يُستشاروا.

إن استطاع تسميتهم، الخطوة التالية هي “هل تحدّثتَ معهم بعد؟” إن كان الجواب لا، اذهب وتحدّث معهم. إن كان الجواب نعم، الوثيقة على الأرجح جاهزة.

هذا السؤال أنقذني من أشهر أكثر من إعادة عمل من أي عادة أخرى عندي.