> ## 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.

# ثقافة الكتابة في الفريق Writing Culture: RFC وADR
- URL: https://arabroot.io/articles/ثقافة-الكتابة-في-الفريق-writing-culture-rfc-و-adr/
- Published: 2026-11-18T21:46:41.000Z
- Updated: 2026-11-18T22:50:39.000Z
- Description: كيف يكتب الفريق الفكرة قبل أن يناقشها، ومتى يكتب طلب نقاش أو سجل قرار، ومتى يكون الاجتماع أفضل من الوثيقة.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, المهارات المهنية للتقنيين

إذا كان فريقك يعقد اجتماعاً Meeting لكل قرار صغير، ثم يختلف بعد أسبوعين على ما اتفق عليه في ذلك الاجتماع، فهذا المقال لك. وهو أيضاً لمن انضم إلى فريق جديد ووجد أن المعرفة كلها في رؤوس شخصين، ولمن يسأل كل شهر نفس السؤال «لماذا اخترنا هذه التقنية؟» ولا يجد من يجيب.

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

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

- لماذا تختار فرق معروفة مثل Amazon وGitLab وOxide الكتابة قبل الاجتماع، وماذا تقول مصادرها المنشورة.
- خريطة المستندات Documents التي يحتاجها فريق تقني، ومتى تكتب كل واحدة منها.
- ما هو طلب النقاش RFC وما هو سجل القرار ADR باختصار، مع روابط للمقالات التي تشرح كلاً منهما بالتفصيل.
- متى يكون الاجتماع أفضل من الوثيقة، بجدول قرار واضح.
- خطوات لبدء ثقافة الكتابة في فريق صغير، وكيف تعلق على وثيقة زميلك، والأخطاء التي تحول الكتابة إلى بيروقراطية.

## باختصار Quick Summary

💡

**الفكرة:** اكتب أولاً، ثم ناقش، ثم قرر، واترك المكتوب مرجعاً.  
**أهم مستندين:** طلب النقاش RFC قبل القرار الكبير، وسجل القرار ADR بعده في صفحة واحدة.  
**متى تجتمع:** عند الخلاف الحاد، والمشاعر، والعصف الذهني، والحادثة العاجلة. وحتى هنا اكتب ملخصاً بعد الاجتماع.  
**كيف تبدأ:** قالب واحد، وقرار واحد في الأسبوع يكتب، ومكان واحد للوثائق، وموعد ينتهي عنده التعليق.  
**أكبر خطر:** أن تصبح الكتابة شرطاً شكلياً يكتبه الناس ولا يقرؤه أحد.

## ما هي ثقافة الكتابة Writing Culture؟

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

وتصف GitLab هذا الفرق بوضوح في دليلها المنشور، فتقول إن كلمة «التوثيق» Documentation تعني عادة كتابة الشيء بعد أن يعلن عنه، وهي خطوة يتركها الناس كثيراً. أما عندهم فالترتيب معكوس: يكتبون الحل أولاً في الدليل Handbook، ثم يعلنون عنه في المحادثة أو البريد مع رابط إليه. وتسمي هذا الأسلوب «الدليل أولاً» Handbook-first.

والكلمة المهمة هنا هي «أولاً». فالفريق الذي يكتب محضراً Minutes بعد كل اجتماع ما زال فريقاً يقرر شفهياً ثم يوثق. وهذا أفضل من لا شيء، لكنه لا يعطيك أهم فائدة للكتابة، وهي أن الكاتب يفكر وهو يكتب، فيكتشف الثغرات في فكرته قبل أن يراها غيره.

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

المصدر: GitLab Handbook، صفحة [The importance of a handbook-first approach to communication](https://handbook.gitlab.com/handbook/company/culture/all-remote/handbook-first/?ref=arabroot.io).

## لماذا الكتابة قبل الاجتماع؟ Why Write First

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

![مقارنة بين مسارين لنفس القرار: في المسار الأول يبدأ الفريق باجتماع لسماع الفكرة ثم اجتماع ثان لأن بعض الأعضاء غابوا ثم خلاف بعد شهر على ما اتفقوا عليه، وفي المسار الثاني يكتب صاحب الفكرة صفحتين ثم يعلق الفريق خلال يومين ثم اجتماع قصير لحسم الخلاف المتبقي ثم سجل قرار يبقى مرجعاً](https://arabroot.io/content/images/2026/11/writing-culture-01-meeting-vs-doc.webp)

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

### الكتابة تكشف الفكرة الناقصة Clarity

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

### الكتابة تحترم وقت الفريق وتركيزه Focus

القارئ يقرأ الوثيقة في الوقت الذي يناسبه، وليس في الساعة التي اختارها المنظم. وهذا مهم للمبرمج الذي يحتاج ساعات متصلة دون مقاطعة، وشرحنا لماذا في مقال [التركيز العميق Deep Work](https://arabroot.io/articles/%D8%A7%D9%84%D8%AA%D8%B1%D9%83%D9%8A%D8%B2-%D8%A7%D9%84%D8%B9%D9%85%D9%8A%D9%82-deep-work-%D9%84%D9%85%D8%A7%D8%B0%D8%A7-%D9%8A%D8%AD%D8%AA%D8%A7%D8%AC-%D8%A7%D9%84%D9%85%D8%A8%D8%B1%D9%85%D8%AC-%D8%B3%D8%A7%D8%B9%D8%A7%D8%AA-%D9%87%D8%A7%D8%AF%D8%A6%D8%A9/). وهو أهم للفرق الموزعة على أكثر من منطقة زمنية Time Zone، حيث لا توجد ساعة يناسب فيها الاجتماع الجميع.

### الكتابة تبقى بعد أن ينسى الناس Memory

بعد ستة أشهر لن يتذكر أحد لماذا اخترتم قاعدة البيانات Database هذه. وإذا لم يكن السبب مكتوباً فسيحدث أحد أمرين ذكرهما Michael Nygard في مقاله عن سجلات القرار عام 2011: إما أن يقبل المهندس الجديد القرار كما هو دون أن يفهمه، فلا يستطيع تغييره حين يجب أن يتغير، وإما أن يغيره دون أن يفهم سببه، فيعيد مشكلة حلها الفريق من قبل.

### الكتابة تعطي صوتاً لمن لا يتكلم في الاجتماع Inclusion

في الاجتماع يكسب غالباً من يتكلم أسرع وأعلى. وفي الوثيقة يكسب من يكتب تعليقاً أوضح. والمهندس الهادئ، أو الجديد، أو من يفكر ببطء ويكتب بعمق، يشارك في الوثيقة أكثر مما يشارك في الاجتماع. وهذا يتصل مباشرة بالأمان النفسي Psychological Safety في الفريق، أي أن يشعر كل عضو أنه يستطيع أن يقول رأيه دون أن يدفع ثمناً، وشرحناه في مقال [الأمان النفسي Psychological Safety](https://arabroot.io/articles/%D8%A7%D9%84%D8%A7%D9%85%D8%A7%D9%86-%D8%A7%D9%84%D9%86%D9%81%D8%B3%D9%8A-psychological-safety-%D9%85%D8%A7-%D9%88%D8%AC%D8%AF%D8%AA%D9%87-google-%D9%81%D9%8A-project-aristotle/).

### الكتابة تكبر مع الفريق Scale

في فريق من أربعة أشخاص يكفي أن تلتفت وتسأل. وفي فريق من أربعين يصبح السؤال الشفهي مقاطعة يدفع ثمنها أكثر الناس معرفة. وتقول GitLab في نفس الصفحة إن الحاجة إلى التوثيق تزيد مع كبر الفريق، وتزيد معها تكلفة عدم التوثيق، وإن الشركة التي لا توثق تجد موظفيها يسألون نفس الأسئلة مرة بعد مرة في حلقة من المقاطعات والاجتماعات.

### الكتابة تجعل عملك مرئياً Visibility

الوثيقة التي كتبتها وغيرت قراراً مهماً تبقى باسمك، ويقرؤها من لم يحضر. وهذا من أهم ما يجعل عمل المهندس مرئياً Visible لمن يقيمه، وهو موضوع مرحلة كاملة في هذا المسار عن السجل اليومي وملف الإنجازات.

## ماذا تقول الفرق التي جربت هذا؟ Real Practices

الأفكار السابقة ليست نظرية، فقد كتبت عنها فرق كبيرة ومشاريع مفتوحة المصدر Open Source في مصادر منشورة نستطيع أن نقرأها. والجدول التالي يجمع أهمها:

| الجهة          | الممارسة                                                                     | ما نأخذه منها                            | المصدر                |
| -------------- | ---------------------------------------------------------------------------- | ---------------------------------------- | --------------------- |
| Amazon         | مذكرة سردية من ست صفحات Six-page Memo بدل الشرائح، تقرأ بصمت في أول الاجتماع | القراءة داخل الاجتماع تضمن أن الجميع قرأ | رسالة المساهمين 2017  |
| GitLab         | الدليل أولاً Handbook-first، والمحادثة تحذف بعد 90 يوماً                     | اكتب ثم أعلن، ولا تجعل المحادثة مرجعاً   | GitLab Handbook       |
| Google         | وثيقة التصميم Design Doc قبل البرمجة للمشكلات التي فيها خيارات               | لا تكتب وثيقة لمشكلة حلها واضح           | Malte Ubl، 2020       |
| Oxide Computer | طلب النقاش RFD بحالات واضحة من الفكرة إلى التنفيذ                            | اكتب مبكراً، ولا تنتظر أن تكتمل الفكرة   | RFD 1                 |
| مشروع Rust     | طلب النقاش RFC مفتوح مع فترة تعليقات أخيرة                                   | موعد معروف ينتهي عنده النقاش             | مستودع rust-lang/rfcs |
| Michael Nygard | سجل القرار المعماري ADR من صفحة أو صفحتين                                    | سجل القرار وسببه ونتائجه، لا التصميم كله | مقاله عام 2011        |

### مذكرة Amazon والقراءة الصامتة Silent Reading

كتب Jeff Bezos في [رسالته إلى المساهمين لعام 2017](https://www.aboutamazon.com/news/company-news/2017-letter-to-shareholders?ref=arabroot.io) أن Amazon لا تستخدم العروض بالشرائح PowerPoint، وإنما تكتب مذكرات سردية Narrative Memos من ست صفحات. ويقرأ الحاضرون المذكرة بصمت في أول الاجتماع، ويصف ذلك بأنه نوع من «قاعة الدراسة» Study Hall.

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

والدرس لفريقك: الوثيقة التي تغير قراراً تحتاج وقتاً حقيقياً، فخطط له كما تخطط لمهمة برمجية. ولا تطلب من زميل وثيقة جيدة «للاجتماع غداً».

### GitLab: المحادثة ليست مرجعاً

تذكر GitLab في صفحة «الدليل أولاً» أنها تحتفظ بسجل Slack تسعين يوماً فقط، ثم يحذف. والسبب الذي تذكره أن الناس إذا عرفوا أنهم يستطيعون البحث في المحادثة القديمة فلن يكتبوا القرار في مكان يصل إليه الجميع. فالحذف عندهم أداة تجبر الفريق على نقل المعرفة إلى المرجع الواحد Single Source of Truth.

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

### من أين جاء اسم RFC؟

اسم «طلب التعليقات» Request for Comments قديم، فقد بدأ مع مهندسي شبكة ARPANET عام 1969\. وفي الوثيقة [RFC 3](https://datatracker.ietf.org/doc/html/rfc3?ref=arabroot.io) التي كتبها Steve Crocker في أبريل 1969 جملة ما زالت تصلح قاعدة لكل فريق: الملاحظات يفضل أن تكون في وقتها وليست مصقولة، أي «timely rather than polished». وما زالت Oxide تقتبس هذه الجملة في وثيقتها RFD 1.

والمعنى العملي: لا تنتظر أن تكتمل فكرتك لتكتبها. اكتبها وهي نصف جاهزة، وقل ذلك في أولها، ودع الفريق يكملها معك.

## خريطة المستندات Document Map: أي وثيقة لأي موقف؟

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

![خريطة المستندات في الفريق التقني موزعة على ثلاث مراحل: قبل القرار طلب النقاش RFC ووثيقة التصميم Design Doc ومقترح الصفحة الواحدة One-pager، وعند القرار سجل القرار ADR ومحضر الاجتماع، وبعد التنفيذ ملف README ودليل التشغيل Runbook وتقرير ما بعد الحادثة Postmortem والتحديث الأسبوعي](https://arabroot.io/content/images/2026/11/writing-culture-02-document-map.webp)

كل موقف له مستند واحد: قبل القرار، وعنده، وبعد التنفيذ

| الموقف                                       | المستند                                    | الطول المعتاد     | من يكتبه                  |
| -------------------------------------------- | ------------------------------------------ | ----------------- | ------------------------- |
| فكرة تريد أن تعرف هل تستحق العمل             | مقترح صفحة واحدة One-pager                 | صفحة              | صاحب الفكرة               |
| قرار كبير فيه أكثر من خيار ويمس أكثر من فريق | طلب النقاش RFC أو وثيقة التصميم Design Doc | من 2 إلى 10 صفحات | المهندس الذي سينفذ غالباً |
| قرار اتخذ ويجب أن يبقى سببه                  | سجل القرار ADR                             | صفحة أو صفحتان    | صاحب القرار               |
| اجتماع انتهى بقرارات ومهام                   | محضر الاجتماع Meeting Notes                | نصف صفحة          | شخص يحدد قبل الاجتماع     |
| خدمة أو مستودع Repository يستخدمه غيرك       | ملف README                                 | صفحة أو صفحتان    | الفريق المالك             |
| إجراء يتكرر أو ينفذ عند عطل                  | دليل التشغيل Runbook                       | حسب الإجراء       | من يعرف الإجراء أكثر      |
| حادثة أثرت على العملاء                       | تقرير ما بعد الحادثة Postmortem            | من 2 إلى 5 صفحات  | قائد الحادثة مع الفريق    |
| تقدم العمل لمن يتابعه                        | التحديث الأسبوعي Status Update             | من 3 إلى 10 أسطر  | صاحب العمل                |

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

وكل مستند في الجدول له مقال يشرحه بالتفصيل في الموقع أو في هذا المسار. فكتابة ملف README ودليل التشغيل ووثيقة التصميم لها مقال مستقل في نفس المرحلة، وكذلك رسائل العمل اليومية، وتجد [دليل التشغيل Runbook](https://arabroot.io/articles/%D8%AF%D9%84%D9%8A%D9%84-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84-runbook-%D9%88%D8%AB%D9%82-%D8%A7%D9%84%D8%A7%D8%AC%D8%B1%D8%A7%D8%A1-%D9%82%D8%A8%D9%84-%D8%A7%D9%86-%D8%AA%D8%AD%D8%AA%D8%A7%D8%AC%D9%87/) و[مراجعة الحادثة دون لوم 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/) في مسارات أخرى.

## طلب النقاش RFC باختصار

طلب النقاش RFC وثيقة يكتبها صاحب فكرة قبل قرار كبير، ويطلب فيها تعليق الفريق في مدة محددة. ويسمى في Google «وثيقة التصميم» Design Doc، وفي Oxide «طلب النقاش» Request for Discussion واختصاراً RFD، والفكرة واحدة.

وأهم ما يميز طلب النقاش الجيد ثلاثة أشياء:

1. **مشكلة قبل الحل:** يبدأ بما يحدث اليوم ولماذا يجب أن يتغير الآن، بأرقام إن وجدت، قبل أن يقول ما الحل.
2. **خيارات حقيقية:** يذكر خيارين أو ثلاثة جديرة بالنقاش، ولماذا رفض كل واحد، وليس خياراً واحداً وأمامه خيارات ضعيفة وضعت للشكل.
3. **موعد وقرار:** يقول من يقرر، ومتى ينتهي التعليق. ففي مشروع Rust مثلاً تبدأ «فترة التعليقات الأخيرة» Final Comment Period بعد موافقة الفريق المختص، ثم يدمج الطلب أو يغلق.

ولكل طلب نقاش حالة يعرفها القارئ من النظرة الأولى. والشكل التالي يبين الحالات كما تكتبها Oxide في وثيقة RFD 1:

![حالات الوثيقة عند Oxide بالترتيب: قبل النقاش Prediscussion مسودة غير جاهزة، ثم الفكرة Ideation تحدد النطاق فقط، ثم النقاش Discussion في طلب دمج مفتوح، ثم منشورة Published بعد أن يتفق النقاش، ثم منفذة Committed بعد التنفيذ الكامل، وقد تصبح متروكة Abandoned إذا ثبت أن الفكرة غير مناسبة](https://arabroot.io/content/images/2026/11/writing-culture-03-rfd-states.webp)

حالات الوثيقة في Oxide: كل قارئ يعرف هل الوثيقة مفتوحة للنقاش أم حسمت

أما القالب الكامل لوثيقة التصميم، وكيف تدير مراجعة التصميم Design Review قبل الاجتماع وأثناءه وبعده، فشرحناه خطوة خطوة في مقال [القرار التقني في الفريق](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/)، فلا نعيده هنا.

المصدر: [Oxide RFD 1: Requests for Discussion](https://rfd.shared.oxide.computer/rfd/0001?ref=arabroot.io)، و[مستودع rust-lang/rfcs](https://github.com/rust-lang/rfcs?ref=arabroot.io)، و[Design Docs at Google](https://www.industrialempathy.com/posts/design-docs-at-google/?ref=arabroot.io) لـ Malte Ubl (2020).

## سجل القرار ADR باختصار

سجل القرار المعماري Architecture Decision Record واختصاراً ADR صفحة قصيرة تكتب بعد القرار وليس قبله. ولا تشرح التصميم كله، وإنما قراراً واحداً: ما هو، ولماذا اتخذ، وما نتائجه. واقترح Michael Nygard هذه الفكرة في [مقاله عام 2011](https://www.cognitect.com/blog/2011/11/15/documenting-architecture-decisions?ref=arabroot.io) بخمسة أقسام، وقال إن الوثيقة كلها يجب أن تكون صفحة أو صفحتين.

ويبين الجدول التالي الأقسام الخمسة مع مثال افتراضي لفريق يقرر طريقة إرسال الإشعارات Notifications:

| القسم                | ماذا تكتب                                     | مثال افتراضي                                                                  |
| -------------------- | --------------------------------------------- | ----------------------------------------------------------------------------- |
| العنوان Title        | عبارة اسمية قصيرة برقم متسلسل                 | ADR 7: إرسال الإشعارات عبر طابور رسائل Message Queue                          |
| السياق Context       | الظروف التي فرضت القرار، بلغة محايدة          | الإشعارات ترسل اليوم من داخل الطلب، وعندما يتأخر مزود الرسائل يتأخر الطلب كله |
| القرار Decision      | ما قررناه، بصيغة «سوف نفعل»                   | سوف نضع كل إشعار في طابور، وترسله خدمة منفصلة                                 |
| الحالة Status        | مقترح، أو مقبول، أو ملغى، أو استبدل بقرار آخر | مقبول                                                                         |
| النتائج Consequences | كل النتائج، الجيدة والسيئة والمحايدة          | الطلب لا ينتظر المزود، ولكن نحتاج مراقبة الطابور، والإشعار قد يصل بعد ثوان    |

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

وأين تحفظ هذه السجلات، وما الأدوات التي تساعدك، وقالب MADR الذي يضيف الخيارات المرفوضة، كل ذلك في مقال [توثيق المعمارية بمخططات C4 وADR](https://arabroot.io/articles/%D8%AA%D9%88%D8%AB%D9%8A%D9%82-%D8%A7%D9%84%D9%85%D8%B9%D9%85%D8%A7%D8%B1%D9%8A%D8%A9-%D9%85%D8%AE%D8%B7%D8%B7%D8%A7%D8%AA-c4-%D9%88-adr/).

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

## كتابة أم اجتماع؟ جدول القرار Decision Table

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

![شجرة قرار من أربعة أسئلة: هل الموضوع عاجل يحتاج تنسيقاً الآن مثل حادثة، إذا نعم فاتصال مباشر ثم ملخص مكتوب، وهل فيه مشاعر أو خلاف شخصي، إذا نعم فحديث مباشر، وهل تحتاج أفكاراً كثيرة بسرعة، إذا نعم فجلسة عصف ذهني ثم وثيقة، وإلا فاكتب أولاً ثم اجتمع فقط إذا بقي خلاف](https://arabroot.io/content/images/2026/11/writing-culture-04-write-or-meet.webp)

اسأل الأسئلة بالترتيب: العجلة، ثم المشاعر، ثم الحاجة إلى أفكار كثيرة، وإلا فاكتب أولاً

| الموقف                                     | الأفضل                           | والسبب                                        |
| ------------------------------------------ | -------------------------------- | --------------------------------------------- |
| قرار تقني بين خيارات                       | اكتب أولاً                       | يحتاج تفكيراً ويجب أن يبقى سببه               |
| تحديث عن تقدم العمل                        | اكتب فقط                         | لا يحتاج نقاشاً، والاجتماع له يضيع وقت الجميع |
| حادثة Incident تؤثر على العملاء الآن       | اتصال مباشر، ثم ملخص مكتوب       | الدقائق مهمة، والتنسيق بالكتابة بطيء          |
| خلاف حاد استمر في التعليقات أكثر من جولتين | اجتماع قصير على الوثيقة          | الكتابة هنا تزيد التوتر، والصوت يوضح النية    |
| ملاحظة صعبة Feedback لزميل                 | حديث مباشر وخاص                  | النص يفقد النبرة، وقد يقرأ أقسى مما قصدت      |
| عصف ذهني Brainstorming في بداية فكرة       | جلسة قصيرة، ثم وثيقة             | الأفكار تولد من الحوار، والوثيقة تختار منها   |
| تعريف شخص جديد بالفريق                     | لقاء مباشر، مع صفحة ترحيب مكتوبة | العلاقة لا تبنى بالوثائق                      |

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

وفي الحالات التي يكون فيها الاجتماع هو الأفضل، لا تنس أن ثقافة الكتابة تعود بعده: سطران بالقرار، ومن ينفذ، ومتى. وتقول GitLab في دليل الاجتماعات إن الاجتماع الذي ليس له جدول أعمال Agenda مشكلة، وإن الاجتماع الذي له جدولان مشكلة أيضاً، وإن الاجتماع وملاحظاته يحتاجان مرجعاً واحداً.

المصدر: GitLab Handbook، [All-Remote Meetings](https://handbook.gitlab.com/handbook/company/culture/all-remote/meetings/?ref=arabroot.io).

## قبل وبعد: قرار في المحادثة وقرار مكتوب Before and After

لنأخذ مثالاً افتراضياً يحدث في أغلب الفرق. نقاش في قناة المحادثة Chat Channel عن الحد الأقصى لحجم الملفات التي يرفعها المستخدم:

| قبل: ما بقي في المحادثة                                                                    | بعد: ما كتب في سجل القرار                                                                                                                                                                                                                                               |
| ------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| «خلاص نخليها 10 ميجا؟» ثم «تمام» ثم «بس الفيديو؟» ثم «نشوف بعدين» ثم 40 رسالة عن موضوع آخر | **ADR 12: حد رفع الملفات 10 MB للصور والمستندات.** السياق: 3 أعطال في الشهر الماضي سببها ملفات كبيرة ملأت الذاكرة. القرار: الحد 10 MB، والفيديو خارج النطاق الآن. الحالة: مقبول. النتائج: بعض العملاء سيرون رسالة رفض، وفريق الدعم أبلغ بها. يراجع عند طلب دعم الفيديو. |

لاحظ ما تغير. القرار المكتوب يقول ما اتفقنا عليه، ولماذا، وما تركناه عمداً (الفيديو)، ومن تأثر (الدعم)، ومتى نعود إليه. والمهندس الذي ينضم بعد سنة ويسأل «لماذا 10 MB بالذات؟» يجد الجواب في دقيقة، بدل أن يبحث في مئات الرسائل أو يسأل من غادر الشركة.

ومثال آخر من الاجتماعات. هذا محضر يكتبه كثيرون، ثم المحضر الذي يفيد:

| قبل                                                              | بعد                                                                                                                                                                                                                                                     |
| ---------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| «ناقشنا موضوع الأداء وتم الاتفاق على تحسينه، وتحدثنا عن الإطلاق» | **القرارات:** نؤجل الإطلاق أسبوعاً حتى يصبح زمن الاستجابة Latency أقل من ثانية في الصفحة الرئيسية.**المهام:** قياس الصفحات الخمس الأبطأ (صاحب المهمة محدد، الخميس).**أسئلة مفتوحة:** هل نبلغ العميل بالتأجيل الآن أم بعد القياس؟ يقرر مدير المنتج غداً. |

المحضر الأول يصف أن اجتماعاً حدث. والمحضر الثاني يجيب عن ثلاثة أسئلة يحتاجها من غاب: ماذا قررنا، ومن يفعل ماذا ومتى، وما الذي لم يحسم بعد.

## كيف تبدأ ثقافة الكتابة في فريقك؟ ثماني خطوات Steps

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

### الخطوة 1: اختر مكاناً واحداً للوثائق Single Source of Truth

قبل أي قالب، اتفقوا على مكان واحد تعيش فيه الوثائق: قاعدة المعرفة Wiki، أو مجلد في المستودع، أو أداة مستندات مشتركة. المهم أن يكون واحداً، وأن يبحث فيه الجميع. فالوثيقة التي لا يجدها أحد تساوي وثيقة لم تكتب. وشرحنا كيف تنظم هذا المكان في مقال [قاعدة معرفة الفريق Wiki](https://arabroot.io/articles/%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-%D9%85%D8%B9%D8%B1%D9%81%D8%A9-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82-wiki-%D8%AA%D9%86%D8%B8%D9%8A%D9%85%D9%87%D8%A7-%D9%88%D8%A7%D9%84%D8%A8%D8%AD%D8%AB-%D9%81%D9%8A%D9%87%D8%A7/).

الوقت: اجتماع واحد قصير. التكلفة: لا شيء غالباً، فأغلب الفرق تملك أداة مناسبة.

### الخطوة 2: ابدأ بنوع واحد من المستندات Start Small

لا تطلب طلبات نقاش وسجلات قرار ومحاضر وأدلة تشغيل في نفس الشهر. اختر نوعاً واحداً يحل ألماً يشعر به الفريق الآن. وأغلب الفرق تبدأ بسجل القرار ADR لأنه قصير، ولأن سؤال «لماذا اخترنا هذا؟» مؤلم في كل فريق.

### الخطوة 3: ضع قالباً قصيراً Template

القالب يزيل أصعب لحظة في الكتابة، وهي الصفحة الفارغة. واجعله قصيراً: خمسة عناوين لسجل القرار، وسبعة أو ثمانية لطلب النقاش. والقالب الطويل يخيف الكاتب، فيكتب أقل أو لا يكتب.

### الخطوة 4: اكتب أنت أول ثلاث وثائق Lead by Example

إذا كنت قائد الفريق Team Lead أو مهندساً أول Senior Engineer فابدأ بنفسك. اكتب أول ثلاث وثائق، واجعلها قصيرة وواضحة، وأرسلها مع طلب صريح للتعليق. والفريق يتعلم من المثال أكثر مما يتعلم من القاعدة.

### الخطوة 5: حدد موعداً ينتهي عنده التعليق Comment Deadline

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

### الخطوة 6: اجعل الاجتماع يبدأ بالوثيقة Read First

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

### الخطوة 7: أجب عن الأسئلة المتكررة برابط Answer with a Link

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

### الخطوة 8: راجع بعد ثلاثة أشهر Quarterly Review

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

## كيف تعلق على وثيقة زميلك؟ Document Review

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

| نوع التعليق       | معناه                           | مثال                                                               |
| ----------------- | ------------------------------- | ------------------------------------------------------------------ |
| مانع Blocking     | لا أوافق على القرار حتى يحل هذا | «مانع: الخطة لا تذكر كيف نرجع إذا فشل الترحيل Migration في منتصفه» |
| سؤال Question     | لم أفهم، وقد يكون الجواب بسيطاً | «سؤال: هل الرقم 2,000 طلب في الدقيقة من أعلى يوم أم من المتوسط؟»   |
| اقتراح Suggestion | فكرة قد تحسن الحل، والقرار لك   | «اقتراح: يمكن أن نبدأ بالعملاء الداخليين أسبوعاً قبل الجميع»       |
| صياغة Nit         | تفصيل صغير في اللغة أو الشكل    | «صياغة: الجدول الثاني يكرر الأول، يمكن حذفه»                       |

وهذه أمثلة لتعليقات تضر، وما تكتبه بدلها:

| قبل                                 | بعد                                                                                      |
| ----------------------------------- | ---------------------------------------------------------------------------------------- |
| «هذا لن ينجح»                       | «مانع: أخشى أن الحل لا يتحمل ضعف الطلبات في موسم العروض. هل جربناه على رقم قريب من ذلك؟» |
| «لماذا لم تستخدم X؟»                | «سؤال: هل نظرنا في X؟ أظنه يحل مشكلة التكرار. إذا رفض لسبب أضفه إلى قسم الخيارات الأخرى» |
| «الوثيقة طويلة جداً»                | «اقتراح: القسم 3 و4 يمكن أن يدمجا، والملحق يمكن أن ينقل إلى رابط»                        |
| تعليق في المحادثة الخاصة عن الوثيقة | تعليق على الوثيقة نفسها، حتى يراه الجميع ويبقى مع القرار                                 |

ولاحظ أن التعليق الجيد ينتقد الفكرة وليس الكاتب، ويقترح طريقاً للحل، ويبقى في الوثيقة. وإذا كان عندك ملاحظة على طريقة الزميل في الكتابة نفسها، فمكانها حديث خاص وهادئ وليس هامش الوثيقة، وشرحنا ذلك في مقال [الملاحظات الصعبة Feedback](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B9%D8%B7%D9%8A-%D8%A7%D9%84%D9%85%D9%84%D8%A7%D8%AD%D8%B8%D8%A7%D8%AA-%D8%A7%D9%84%D8%B5%D8%B9%D8%A8%D8%A9-feedback-%D9%88%D8%AA%D8%AA%D9%84%D9%82%D8%A7%D9%87%D8%A7/).

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

## كيف تكتب وثيقة يقرؤها الفريق فعلاً؟ Readable Documents

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

وأبسط طريقة لذلك رأس ثابت Header في أعلى كل وثيقة، يعرف منه القارئ في عشر ثوان ما المطلوب منه:

| السطر                 | مثال                                                 | لماذا                                 |
| --------------------- | ---------------------------------------------------- | ------------------------------------- |
| الحالة Status         | مسودة، مفتوحة للتعليق، حسمت، متروكة                  | يعرف القارئ هل رأيه ما زال يغير شيئاً |
| المطلوب منك           | «أحتاج رأي فريق البيانات في القسم 4 فقط»             | لا يقرأ الجميع كل شيء                 |
| صاحب القرار والموعد   | «يقرر قائد المنصة، والتعليقات حتى الأربعاء»          | النقاش له نهاية معروفة                |
| الخلاصة في ثلاثة أسطر | المشكلة، والحل المقترح، والثمن                       | من لا يكمل يعرف الفكرة على الأقل      |
| الروابط               | التذكرة Ticket، والقرارات السابقة، واللوحة Dashboard | السياق في مكان واحد                   |

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

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

## ما دور قائد الفريق؟ The Lead's Role

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

وهذه أشياء صغيرة يفعلها القائد وتصنع الفرق:

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

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

## بأي لغة يكتب الفريق العربي؟ Language Choice

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

ولا توجد إجابة واحدة، لكن هناك قواعد تقلل المشكلة:

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

## متى تتحول الكتابة إلى بيروقراطية؟ Writing Theater

كل عادة جيدة يمكن أن تصبح شكلاً فارغاً. والفريق الذي يفرض وثيقة لكل تغيير صغير سيكتب وثائق لا يقرؤها أحد، ثم يكره الكتابة كلها. ويقول Malte Ubl في مقاله عن Google إن الوثيقة تكتب لمشكلة فيها غموض وخيارات حقيقية، وإنها لا تفيد إذا كان الحل واضحاً أو كانت الوثيقة دليل تنفيذ ليس فيه موازنة بين خيارات.

وهذه علامات أن الكتابة عندكم أصبحت عبئاً:

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

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

ومن الأمثلة الواضحة على هذا الربط ما كتبه Will Larson في مقاله [Writing an engineering strategy](https://lethain.com/eng-strategies/?ref=arabroot.io) عام 2023: إذا أردت أن تكتب استراتيجية هندسية Engineering Strategy، فاكتب خمس وثائق تصميم، واستخرج ما يتشابه فيها. أي أن الوثائق الصغيرة عن قرارات حقيقية هي الأساس، والوثائق الكبيرة تبنى منها لاحقاً، وليس العكس.

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

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

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

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

## مقالات المرحلة Related Posts

هذا المقال هو الأول في مرحلة الكتابة والتواصل. وتكملها مقالات عن رسائل العمل اليومية في البريد والمحادثة والتذاكر، وعن شرح العمل التقني لمن لا يعرف التقنية، وعن كتابة توثيق يعود إليه القارئ مثل ملف README ودليل التشغيل ووثيقة التصميم. وفي مسار القيادة تجد كيف يدار القرار التقني نفسه.

[![](https://arabroot.io/content/images/2026/11/work-messages-cover-cover.webp)دليلرسائل العمل التي تقرأ فعلاً: Email وChat والتذاكركيف تكتب بريداً ورسالة محادثة وتذكرة يفهمها القارئ من أول سطرين ويرد عليها بسرعة، مع أمثلة قبل وبعد.](https://arabroot.io/articles/%D8%B1%D8%B3%D8%A7%D8%A6%D9%84-%D8%A7%D9%84%D8%B9%D9%85%D9%84-%D8%A7%D9%84%D8%AA%D9%8A-%D8%AA%D9%82%D8%B1%D8%A7-%D9%81%D8%B9%D9%84%D8%A7-email-%D9%88-chat-%D9%88%D8%A7%D9%84%D8%AA%D8%B0%D8%A7%D9%83%D8%B1/)[![](https://arabroot.io/content/images/2026/11/explain-to-non-tech-cover-cover.webp)دليلكيف تشرح عملك التقني لغير المختصين Non-technicalكيف تشرح عملك التقني للعميل والإدارة والمبيعات والقانوني وأهلك بطبقات وتشبيهات ولغة واضحة، مع أمثلة قبل وبعد.](https://arabroot.io/articles/%D9%83%D9%8A%D9%81-%D8%AA%D8%B4%D8%B1%D8%AD-%D8%B9%D9%85%D9%84%D9%83-%D8%A7%D9%84%D8%AA%D9%82%D9%86%D9%8A-%D9%84%D8%BA%D9%8A%D8%B1-%D8%A7%D9%84%D9%85%D8%AE%D8%AA%D8%B5%D9%8A%D9%86-non-technical/)[![](https://arabroot.io/content/images/2026/11/technical-docs-writing-cover-cover.webp)دليلكتابة توثيق يعود إليه القارئ: README ودليل التشغيلكيف تكتب ملف README ودليل تشغيل ووثيقة تصميم يجد فيها القارئ جوابه، ويبقى صحيحاً بعد أن يتغير النظام.](https://arabroot.io/articles/%D9%83%D8%AA%D8%A7%D8%A8%D8%A9-%D8%AA%D9%88%D8%AB%D9%8A%D9%82-%D9%8A%D8%B9%D9%88%D8%AF-%D8%A7%D9%84%D9%8A%D9%87-%D8%A7%D9%84%D9%82%D8%A7%D8%B1%D8%A6-readme-%D9%88%D8%AF%D9%84%D9%8A%D9%84-%D8%A7%D9%84%D8%AA%D8%B4%D8%BA%D9%8A%D9%84/)[![](https://arabroot.io/content/images/2026/11/technical-decisions-cover-cover.webp)دليلالقرار التقني في الفريق: سجل ADR والخلاف المحترمكيف تحدد حجم القرار التقني ومن يملكه، وتديره بوثيقة تصميم ومراجعة وسجل قرار 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/)[![](https://arabroot.io/content/images/2026/11/architecture-docs-cover-cover.webp)دليلتوثيق المعمارية: مخططات C4 وسجلات القرارات المعمارية ADRكيف ترسم نظامك بمخططات C4 يفهمها المطور الجديد، وتحفظ سبب كل قرار مهم في سجل ADR داخل المستودع.](https://arabroot.io/articles/%D8%AA%D9%88%D8%AB%D9%8A%D9%82-%D8%A7%D9%84%D9%85%D8%B9%D9%85%D8%A7%D8%B1%D9%8A%D8%A9-%D9%85%D8%AE%D8%B7%D8%B7%D8%A7%D8%AA-c4-%D9%88-adr/)[![](https://arabroot.io/content/images/2026/11/team-wiki-basics-cover-cover.webp)دليلقاعدة معرفة الفريق Wiki: نظمها ليجد الناس ما يبحثون عنهلماذا تضيع معرفة الفريق في المحادثة، وكيف تبني Wiki لها مالك ومراجعة وبحث يفهم الكلمات العربية، مع مختبر يقيس البحث العربي في PostgreSQL.](https://arabroot.io/articles/%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-%D9%85%D8%B9%D8%B1%D9%81%D8%A9-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82-wiki-%D8%AA%D9%86%D8%B8%D9%8A%D9%85%D9%87%D8%A7-%D9%88%D8%A7%D9%84%D8%A8%D8%AD%D8%AB-%D9%81%D9%8A%D9%87%D8%A7/)

## الخلاصة

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

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

- 2026-11-19: كتابة المقال، والتحقق من رسالة Amazon لعام 2017، ودليل GitLab، ووثيقة Oxide RFD 1، ومقال Nygard، ووثيقة RFC 3، ومقالي Malte Ubl وWill Larson من مصادرها في نفس التاريخ.