الذكاء الاصطناعي لا يصلح التفكير الفوضوي. إنه يسرّعه.
أعطِ نموذجًا لغويًا كبيرًا (LLM) فكرة غامضة فتحصل على إجابة غامضة. أعطه وثيقة منظَّمة بمصطلحات واضحة ومشكلات محدَّدة النطاق وفجوات متتبَّعة، فيصبح أكثر شريك عمل إنتاجية عرفته في حياتك.
عنق الزجاجة في 2026 ليس كتابة الشيفرة. الذكاء الاصطناعي يكتب الشيفرة بسرعة. عنق الزجاجة هو أن تعرف ما الذي تبنيه، وأن تستطيع التعبير عنه بوضوح كافٍ ليتمكن البشر والذكاء الاصطناعي من تنفيذه.
يقدّم هذا المقال إطارًا يفعل ذلك تحديدًا. لا يتعلق الأمر بأدوات الذكاء الاصطناعي. يتعلق بكيفية تنظيم أفكارك بحيث تصبح أي مشكلة معقدة قابلة للمعالجة.
Dream → Concrete → Divide → Gaps → Fix → Realize → Share
↑ |
└───────────────── feedback loop ────────────────────┘كل مرحلة تحوّل تفكيرك. وكل مرحلة تنتج أثرًا ملموسًا. وهذه هي طريقة عملها.
لديك فكرة. هي نصف مكتملة، طموحة، وغالبًا غير واقعية بشكلها الحالي. لا بأس.
اطلب من الذكاء الاصطناعي بأي شيء يدور في رأسك، حتى لو جملة واحدة، ودعه يولّد وثيقة حلم. هذه الوثيقة تطلّعية وليست دقيقة. الهدف أن تُخرج الفكرة من رأسك إلى وثيقة تراها فيها وتتفاعل معها وتبدأ في تشكيلها.
مثال على الطلب:
I want to build an AI-powered medical diagnosis platform
that helps doctors catch rare diseases earlier. A patient
describes symptoms, the system triages, suggests possible
diagnoses, and routes to the right specialist.
Generate a dream document with:
- The vision (what does this look like when it's done?)
- Current landscape (what exists today and what's missing?)
- Key concepts I'll need to define
- Open questionsما تحصل عليه:
وثيقة حلم منظَّمة. ربما من صفحتين أو ثلاث. تلتقط نيّتك، وترسم خريطة للمشهد القائم (UpToDate وIsabel Healthcare وAda Health: ما الذي تجيده وأين تقصّر)، وتطرح أسئلة لم تفكر فيها بعد. «ماذا يعني "اكتشاف مبكر"؟ فرزًا أسرع؟ تشخيصًا تفريقيًا أفضل؟ رصد أنماط عبر تاريخ المريض؟»
لم تكن بحاجة إلى تنظيم أفكارك أولًا، فقد قام الذكاء الاصطناعي بالمسودة الأولى. صار لديك الآن شيء تتفاعل معه.
وثيقة الحلم ليست خطة. إنها بوصلة. تخبرك بالاتجاه لا بالخطوات.
المُخرَج: dreams/ai-diagnosis-platform.md
الآن تأخذ الحلم وتحوّله إلى وثيقة مرجعية ملموسة. هي منظَّمة ودقيقة ومحدَّدة النطاق. عرّف مصطلحاتك. ارسم معمارية نظامك. حدّد ما هو داخل النطاق وما هو خارجه.
هنا يثبت الذكاء الاصطناعي قيمته. أعطه وثيقة الحلم:
Here's my dream doc: [paste].
Turn this into a concrete reference document with:
- Defined terms and concepts
- Architecture sections with clear boundaries
- Scope (what this covers, what it doesn't)
- Open questions marked as [GAP] placeholdersمثال على النتيجة:
ما بدأ بعبارة «أريد أن يساعد الذكاء الاصطناعي الأطباء على اكتشاف الأمراض النادرة» يصبح وثيقة مرجعية تغطي:
صارت هذه الوثيقة الآن مصدر الحقيقة الوحيد. ليس الشيفرة. ليس سجل المحادثات. ليس ذاكرة شخص ما. الوثيقة.
المُخرَج: docs/Diagnosis_Platform.md
وثيقتك الملموسة تطول. بعض الأقسام وحدها عشر صفحات. هذه هي الإشارة إلى أن وقت التقسيم قد حان.
قسّم الوثيقة الملموسة إلى وثائق تقسيم مركّزة، كل واحدة عميقة بما يكفي لتقوم بذاتها لكنها مرتبطة بالكل.
Here's my concrete doc: [paste].
Which sections are complex enough to deserve their own
focused document? For each, suggest a title and scope.مثال:
الوثيقة المرجعية لمنصة التشخيص الطبي تنقسم بشكل طبيعي إلى:
| وثيقة التقسيم | تغطي |
|---|---|
Symptom_Engine.md | مسار الإدخال، توحيد صيغة الأعراض، تحليل عدة لغات |
Diagnosis_Model.md | الترتيب التفريقي، عتبات الثقة، قابلية التفسير |
Specialist_Routing.md | مطابقة التخصصات، مستويات الاستعجال، مسارات الإحالة |
Patient_Records.md | التكامل مع السجلات الصحية الإلكترونية، صيغ FHIR/HL7، الاحتفاظ بالبيانات |
Compliance.md | ضوابط HIPAA، تصنيف SaMD، مسار التدقيق |
Clinical_UI.md | لوحة الطبيب، إدخال المريض، التجاوب مع الجوال |
هذه ليست مجرد تقسيمات للمعرفة، إنها وحدات شيفرتك. كل وثيقة تقسيم تقابل مباشرة وحدة حقيقية من الشيفرة: خدمة مصغّرة، أو حزمة في مستودع أحادي (monorepo)، أو وحدة في تطبيق متكامل (monolith)، أو سياق محدود (bounded context) في التصميم الموجَّه بالنطاق. الوثيقة تصف ما تفعله الوحدة، والشيفرة تنفّذه.
Division Doc → Code Module
─────────────────────────────────────────────
Symptom_Engine.md → packages/symptom-engine/
Diagnosis_Model.md → packages/diagnosis-model/
Specialist_Routing.md → packages/specialist-routing/
Patient_Records.md → packages/patient-records/
Compliance.md → packages/compliance/
Clinical_UI.md → apps/clinical-dashboard/وعندما تقابل الوثائقُ الشيفرةَ، تنشئ وثيقة فهرس: ملفًا واحدًا يقع في جذر مشروعك ويربط كل وثيقة بوحدة الشيفرة الخاصة بها. فكّر فيه على أنه جدول محتويات نظامك كله. حين يحتاج وكيل ذكاء اصطناعي (أو عضو جديد في الفريق) إلى العمل على التوجيه، ينظر في الفهرس، ويجد Specialist_Routing.md → packages/specialist-routing/، ويحصل على السياق الكامل قبل أن يلمس سطرًا واحدًا من الشيفرة.
## Project Index
| Working In | Primary Doc | Gaps |
|---|---|---|
| `packages/symptom-engine/` | [Symptom_Engine.md](docs/Symptom_Engine.md) | [Symptom_Engine_Gaps.md](docs/Symptom_Engine_Gaps.md) |
| `packages/diagnosis-model/` | [Diagnosis_Model.md](docs/Diagnosis_Model.md) | [Diagnosis_Model_Gaps.md](docs/Diagnosis_Model_Gaps.md) |
| `packages/specialist-routing/` | [Specialist_Routing.md](docs/Specialist_Routing.md) | [Specialist_Routing_Gaps.md](docs/Specialist_Routing_Gaps.md) |
| `packages/patient-records/` | [Patient_Records.md](docs/Patient_Records.md) | [Patient_Records_Gaps.md](docs/Patient_Records_Gaps.md) |
| `packages/compliance/` | [Compliance.md](docs/Compliance.md) | [Compliance_Gaps.md](docs/Compliance_Gaps.md) |
| `apps/clinical-dashboard/` | [Clinical_UI.md](docs/Clinical_UI.md) | [Clinical_UI_Gaps.md](docs/Clinical_UI_Gaps.md) |يصبح هذا الفهرس أهم ملف في المستودع. إنه الجسر بين الفكر المنظَّم والشيفرة المنظَّمة.
المُخرَج: docs/DX_Symptom_Engine.md وdocs/DX_Compliance.md وفهرس CLAUDE.md في الجذر
هنا يعمل الإطار فعلًا. بمجرد أن تكون لديك الوثائق الملموسة ووثائق التقسيم، تستطيع أن ترى ما ينقص.
الفجوات ليست إخفاقات. إنها الإطار وهو يؤدي عمله. لا يمكنك أن ترى ما ينقص حتى تكتب ما هو موجود.
تتبّع الفجوات بـرموز الفجوات: معرّفات قصيرة تجعلها قابلة للبحث والإحالة:
### GAP-DX004: Model suggests diagnosis but doesn't explain reasoning
- **Phase**: Diagnosis output
- **Area**: Diagnosis model — result presentation layer
- **Impact**: Doctor sees "Possible: Lupus (82% confidence)"
but no explanation of which symptoms contributed or why
alternatives were ruled out. Doctor can't trust or verify
the suggestion. Useless in clinical practice.
- **Root Cause**: Model outputs a ranked list with scores
but no reasoning chain. Explainability was never specified
in the architecture — it was assumed to be a UI concern.
- **Fix**: Add an explainability module that maps each
diagnosis to contributing symptoms, relevant patient
history, and ruled-out alternatives. Display as
"evidence for / evidence against" in the clinical UI.
- **Priority**: Critical
- **Status**: Openيمنحك تنسيق رمز الفجوة:
| الحقل | الغرض |
|---|---|
| الرمز (Code) | معرّف قابل للبحث (GAP-DX004، GAP-C001) مع بادئة الفئة |
| المرحلة (Phase) | متى تظهر الفجوة في النظام |
| المجال (Area) | أي وحدة أو مفهوم تتأثر |
| الأثر (Impact) | ما يعيشه المستخدمون عند وجود هذه الفجوة |
| السبب الجذري (Root Cause) | لماذا توجد الفجوة: أسباب لا أعراض |
| الإصلاح (Fix) | الحل المقترح (يمكن أن يكون خطة مرحلية) |
| الأولوية (Priority) | حرجة / عالية / متوسطة / منخفضة |
| الحالة (Status) | مفتوحة / قيد التنفيذ / أُصلحت (مع التاريخ) |
بادئات الفئات تُبقي الفجوات منظَّمة: GAP-DX للتشخيص، وGAP-SE لمحرّك الأعراض، وGAP-C للامتثال، وGAP-UI للواجهة السريرية. وستطوّر فئاتك الخاصة مع نمو مشروعك.
المُخرَج: docs/DX_Diagnosis_Gaps.md
أصلح الفجوات. لكن ليس دفعة واحدة.
اطلب دائمًا خطة تنفيذ مرحلية. للفجوات اعتماديات. بعضها شرط مسبق لغيره. محاولة إصلاح كل شيء في وقت واحد تصنع فوضى.
Here are my open gaps: [paste gap doc].
Here's the main concrete doc for context: [paste relevant section].
Create a phased implementation plan:
- Phase 1: Critical gaps that unblock other work
- Phase 2: High-priority gaps
- Phase 3: Medium-priority improvements
For each phase, estimate scope and list dependencies.عندما تُصلَح فجوة:
Fixed (2026-02-22) ودوّن ما تمarchive/. لا تحذفها. إنها تاريخ تفكيركالوثيقة الملموسة تتطور. في النسخة الأولى 20 فجوة. النسخة الثانية تغلق 15 وتكتشف 5 جديدة. النسخة الثالثة تغلقها وتستقر الوثيقة. هذا هو التقارب: كل دورة تقرّبك من وصف كامل وصادق لنظامك.
المُخرَج: docs/Diagnosis_Platform.md المحدَّثة، وarchive/gaps/DX_Diagnosis_Gaps_v1.md المؤرشفة
ابنِ أشياء حقيقية من وثائقك. المشاريع دليل على أن الإطار يعمل.
كل مشروع يختبر إطارك أمام الواقع. وعندما يتعطل شيء، يكون السؤال: أي وثيقة هي الخاطئة؟ المشكلة تعود إلى فجوة في الوثائق، لا إلى مجرد علّة في الشيفرة.
مثال:
من مجموعة واحدة من وثائق منصة التشخيص، تبني نشرات تجريبية: واحدة لعيادة رعاية عاجلة (فرز سريع، حجم مرتفع، حالات شائعة)، وواحدة لمستشفى ريفي (اختصاصيون محدودون في الموقع، توجيه للطب عن بُعد)، وواحدة لعيادة أطفال (تفسير للأعراض حسب العمر، ونطاقات مرجعية مختلفة).
كل نشر يختبر الوثائق أمام واقع مختلف. حين كشف التجريب في المستشفى الريفي أن توجيه الاختصاصيين افترض وجودهم داخل المبنى، بينما تحوّل المستشفيات الريفية إلى مقدّمي طب عن بُعد بنوافذ توفر مختلفة، لم تكتفِ بترقيع الشيفرة. بل قمت بما يلي:
GAP-SR002 في وثيقة فجوات التوجيهSpecialist_Routing.mdالآن تتعامل نشرات الرعاية العاجلة والأطفال تلقائيًا مع التوجيه إلى الطب عن بُعد. كل مشروع يحسّن الوثائق. وكل تحسين في الوثائق يجعل المشاريع القادمة أكثر موثوقية.
هنا يدفع التقسيم فوائد مركّبة. ولأن لكل وحدة وثيقتها المستقلة، تستطيع أن تمزج الوحدات وتطابقها عبر مشاريع مختلفة تمامًا. ليس كل مشروع بحاجة إلى كل وحدة. تُجمَّع المشاريع الجديدة باختيار وثائق التقسيم التي تُضمَّن فيها.
| المشروع | الوحدات المستخدمة |
|---|---|
| كشك فرز للرعاية العاجلة | Symptom_Engine + Clinical_UI |
| منصة طب عن بُعد ريفية | Symptom_Engine + Diagnosis_Model + Specialist_Routing |
| أداة بحث سريري | Diagnosis_Model + Patient_Records + Compliance |
| تطبيق فحص ذاتي للمرضى | Symptom_Engine + Clinical_UI (الجزء الموجَّه للمريض) |
| مدقّق امتثال للمستشفيات | Compliance + Patient_Records |
كشك الرعاية العاجلة لا يحتاج إلى نموذج التشخيص الكامل، بل إلى إدخال سريع للأعراض وواجهة نظيفة للتسليم إلى الطبيب. وأداة البحث لا تحتاج إلى توجيه الاختصاصيين، بل إلى بيانات تشخيص عميقة مع وصول متوافق مع الامتثال إلى السجلات. كل مشروع يسحب الوحدات التي يحتاجها، والوثائق تخبرك بدقة بما تحصل عليه.
هذا هو المبدأ نفسه وراء حزم المستودع الأحادي، وتركيب الخدمات المصغّرة، بل وأنابيب Unix: وحدات صغيرة جيدة التوثيق تتحد لتكوّن أنظمة أكبر. الفرق أن التركيب هنا يبدأ من مستوى الوثائق. تقرر ما يحتاجه المشروع بقراءة الوثائق، لا بقراءة الشيفرة.
المُخرَج: projects/urgent-care-pilot/ وprojects/rural-hospital-pilot/ وغيرها
اكتب عن عمليتك. التعليم يجبرك على فهم ما فعلته فعلًا.
مقالات المدونات، وملفات README، والدروس التعليمية، والوثائق الداخلية: الوسيط لا يهم. المهم أن تشرح إطارك لشخص لا يملك سياقك. هذا يكشف افتراضات لم تكن تعلم أنك تفترضها.
المشاركة تغلق الحلقة أيضًا. مقال عن طريقتك في تفسير التشخيص قد يلهم قارئًا أن يقترح تصوّرًا بيانيًا لشبكة الأعراض بدل قوائم الأدلة المسطّحة. يصبح ذلك حلمًا جديدًا. وتبدأ الدورة من جديد.
المُخرَج: مقالات مدونات، ودروس تعليمية، ووثائق عامة
الإطار بسيط:
احلم به ← دوّنه ← فكّكه ← اكتشف ما ينقص ← أصلحه ← ابنِه ← شاركه.
في عصر الذكاء الاصطناعي، التفكير المنظَّم هو المهارة الأعلى أثرًا التي يمكنك تنميتها. ليس هندسة الأوامر. ليس معرفة أي نموذج تستخدم. بل وضوح التفكير: القدرة على أخذ فكرة فوضوية وصقلها حتى تصير دقيقة بما يكفي ليتمكن البشر والذكاء الاصطناعي من تنفيذها.
ملاحظة عن الصيانة: الوثائق تنجرف. الشيفرة تتغير، وواجهات البرمجة تتبدل، والاعتماديات تتحدث. عامل الانجراف على أنه فجوة أخرى: دقّق دوريًا، وحدّث الوثائق حين تتغير الشيفرة، وأرشِف النسخ القديمة بدل حذفها. تاريخ تفكيرك لا يقل قيمة عن التفكير نفسه.