Prompt — Generate a Roadmap Post (Emotion Style)

Use this prompt to generate new roadmap posts. It corrects the weaknesses found in python-roadmap-2026.md. Always fill in the [VARIABLES] before running.

Variables to fill

TOPIC:         [e.g. JavaScript, DevOps, Cybersecurity]
STAGES:        [number of stages, e.g. 5]
MILESTONES:    [total milestones, e.g. 16]
PAIN_POINT:    [where most beginners quit and why, e.g. "المرحلة الثالثة — OOP — لأن أحداً لم يشرح لهم السبب الحقيقي وراء البنية الكائنية"]
MARKET_FACT:   [one verified market fact about this skill — verify before including]
AUTHOR_YEARS:  [e.g. "سنوات من الكتابة التقنية وتأليف الكتب"]
CTA_URL:       [/subscribe-direct/ unless specified otherwise]

Prompt

اكتب خارطة طريق احترافية لتعلم [TOPIC] بالعربية الفصحى.

الأسلوب المطلوب: Emotion Style

المنهج: ألم → سلطة → مسار → كسب الاشتراك.

لا تبدأ بإحصائيات السوق أو مؤشرات الشعبية. ابدأ بما يشعر به القارئ قبل أن يبدأ رحلته:

• ماذا جرّب من قبل وفشل؟
• أين توقف معظم الناس في هذا المجال تحديداً؟ ([PAIN_POINT])
• لماذا لم يكن الفشل خطأه؟

بعد سطرين من الألم، أدخل جملة سلطة واحدة فقط: “هذه الخارطة بنيتها بعد [AUTHOR_YEARS] — تبدأ من حيث تحتاج فعلاً.”

ثم انتقل للمسار مباشرة.

هيكل المنشور

المقدمة (لا تتجاوز 8 سطور):

• سطر 1-2: الألم — ما يشعر به القارئ الآن
• سطر 3: تسمية السبب الحقيقي للفشل (ليس ضعفه — بل غياب المسار الصحيح)
• سطر 4: جملة سلطة واحدة من تجربة المؤلف
• سطر 5: جملة انتقالية للمسار
• إذا ذكرت حقيقة سوقية: حقيقة واحدة موثقة فقط، ليس قائمة

[STAGES] مراحل، [MILESTONES] مرحلة:

لكل مرحلة:

1. عنوان يصف التحول لا المحتوى: “فكّر مثل المحترفين” لا “تعلم OOP”
2. جملة انتقالية عاطفية: ماذا يشعر المتعلم الآن؟ وما الذي سيتغير؟
3. نقطة ألم خاصة بهذه المرحلة — أين يتوقف الناس هنا ولماذا؟
4. شرح المفاهيم بالأسلوب التالي:
   • تعريف بسيط بالعربية أولاً
   • تمثيل من الحياة اليومية (ليس دائماً في blockquote — نوّع)
   • مثال كود صغير إذا كان ذلك يوضح الفكرة أكثر من الكلام
5. مشروع تطبيقي: 7 خطوات رقمية محددة، نتيجة قابلة للقياس، يصلح للـ Portfolio

الخاتمة (لا تتجاوز 5 سطور):

• اعترف برحلة القارئ: “وصلت لمكان كثيرون لم يصلوه”
• جملة مشجعة واحدة — ليست مبالغة، بل حقيقية
• CTA واضح: افتح المكتبة لمزيد من المحتوى، وستصلك الخرائط الجديدة على هاتفك
• رابط: [CTA_URL]

قواعد اللغة (إلزامية)

• فصحى فقط — لا عامية في أي مكان
• لا “اشترك” ولا “سجّل” — استخدم “افتح” / “احصل على” / “فعّل”
• المستقبل: “سيصلك” لا “وصلك”
• الجمل: قصيرة — فكرة واحدة لكل جملة
• التشجيع: حقيقي ومحدد، لا عام (“أتقنت OOP — هذا ما يتوقف عنده 70% من المبتدئين”)
• التمثيلات: نوّع أساليبها — blockquote، جملة عادية، مثال كود — لا تكرر نفس القالب

ما يجب تجنبه

• لا تبدأ بـ “في عالم اليوم” أو “في ظل التطور التقني”
• لا تذكر إحصائية لم تتحقق منها (مؤشر TIOBE، نسب توظيف، أرقام رواتب)
• لا تنهِ المنشور بـ “بهذا نكون قد أكملنا” — هذا إنهاء مستند لا منشور
• لا تجعل الأسلوب واحداً طوال المنشور — نوّع الإيقاع بين سريع وبطيء

Frontmatter المطلوب

---
layout: roadmappost
title: "[العنوان بالعربية]"
title_en: "[English title]"
permalink: "/[slug]-roadmap/"
description: "[وصف SEO — جملة واحدة تتضمن: اللغة/التقنية + الجمهور + النتيجة]"
date: "YYYY-MM-DD"
categories: ["هندسة البرمجيات", "[التخصص]"]
page_tags: ["[tag1]", "[tag2]"]
quote: "[اقتباس من صوت المؤلف — ليس من شخصية عامة]"
social_hook: "[سؤال يبدأ بما يشعر به القارئ، لا بـ 'هل تريد تعلم']"
author: "Ahmed Bouchefra"
reddit:
  status: queued
  subreddits:
    - r/learnprogramming
    - r/[relevant-subreddit]
  titles:
    - "[problem-first title]"
  opening_comment: >
    [2-3 sentences adding value, no "I wrote this"]
---