NAQSH 2.0 — ONBOARDING GUIDE

أهلاً عبدالرحمن — هذا مكتب المشروع كاملاً

هذا المجلد هو كل شغل نقش 2.0: التحليل، الموقع التجريبي، البيانات، والأبحاث. ومعه «ذاكرة» المشروع كاملة، بحيث تكمل الشغل مع Claude Code من جهازك وكأنك تشتغل من نفس الجهاز اللي بدأ عليه المشروع. اقرأ الدليل بالترتيب — ولا تحتاج أي خبرة برمجية.

STEP 01

الملفات الثلاثة — التنزيل والفك

وصلتك على واتساب ثلاثة ملفات مضغوطة — الثلاثة مع بعض هي المشروع الكامل:

الملفوش فيه
naqsh-part1-core.zipالمشروع الأساسي: المواقع + التحليل + الأبحاث
naqsh-part2-client-data.zipبيانات العملاء المصنفة
naqsh-part3-raw-files.zipملفاتك الأصلية كما أرسلتها
  1. نزل الثلاثة من واتساب (من الكمبيوتر — واتساب ويب أو تطبيق سطح المكتب).
  2. انقل الملفات الثلاثة لمكان واحد ثابت: الأفضل مجلد المستخدم الرئيسي (Home) — على ماك هو المجلد اللي فيه اسمك، وعلى ويندوز C:\Users\اسمك.
  3. فك ضغط الثلاثة كلها بنفس المكان — بتطلع لك ثلاث مجلدات جنب بعض: naqsh و client-data ومجلد الملفات الأصلية.
  4. لا تحاول ترتبها يدوياً — Claude يركبها بنفسه في أول جلسة (الخطوة 4). التعليمات مكتوبة له داخل المشروع.
  5. لا تحذف ملفات الـ ZIP الثلاثة إلا بعد ما يكتمل التركيب وتشتغل أول جلسة بنجاح — هي نسختك الاحتياطية.
  6. لا تغير أسماء المجلدات ولا تنقل ملفات بينها — Claude يعتمد على هذه البنية.

وين تلقى أيش — داخل مجلد naqsh (لو حبيت تتصفح بنفسك)

وش تبيافتح
موقع الديمو (يفتح بدون إنترنت)exports / demo-v2 / index.html
موقع التحليل (يفتح بدون إنترنت)exports / consulting / index.html
العرض التقديمي الخاص فيكexports / deck-abdulrahman.html
ملفات البحث الخام (66 ملف)research /
بياناتك وصورك الأصليةassets /

الديمو والتحليل منفصلان تماماً — كل موقع بمجلده وينشر لرابطه، وما يأثر أحدهما على الثاني.

STEP 02

الوحدة الطرفية (Terminal) — كل اللي تحتاجه

الترمنال هو نافذة تكتب فيها أوامر نصية. لا تخاف منه — أنت بتحتاج ثلاث أوامر فقط طول عمر المشروع، والباقي كله Claude يتولاه.

كيف تفتحه

  • ماك: اضغط Cmd + Space واكتب Terminal واضغط Enter.
  • ويندوز: افتح قائمة ابدأ واكتب PowerShell واضغط Enter.

الأوامر الثلاثة

الأمروش يسويمتى تستخدمه
cd naqshيدخلك مجلد المشروعأول شي بعد فتح الترمنال — دائماً
claudeيشغل Claude Codeبعد ما تدخل المجلد
lsيعرض الملفات حولكإذا حسيت إنك تايه (اختياري)

يعني روتينك كل مرة: افتح الترمنال → cd naqsh → claude → اكتب طلبك بالعربي العادي.

مهم: الأمر cd naqsh يشتغل إذا كان المجلد في الـ Home (الخطوة 1). لو حطيته بمكان ثاني، اسحب المجلد نفسه وأفلته داخل نافذة الترمنال بعد ما تكتب cd (بمسافة) — يكتب المسار عنك.

STEP 03

تثبيت Claude Code

على ماك — في الترمنال الصق:

curl -fsSL https://claude.ai/install.sh | bash

على ويندوز — في PowerShell الصق:

irm https://claude.ai/install.ps1 | iex

بعد التثبيت أغلق الترمنال وافتحه من جديد. تحتاج اشتراك Claude (Pro أو Max) — أول ما تشغل claude بيفتح لك المتصفح تسجل دخولك بحسابك.

STEP 04

أول محادثة — وكيف توافق وترفض

ادخل المجلد وشغله:

cd naqsh claude

وابدأ بهذه الرسالة بالضبط (تخلي Claude يركب الحزم الثلاث أولاً ثم يطلعك على المشروع):

«ركب المشروع من الحزم الثلاث، ثم اقرأ CLAUDE.md ولخص لي وضع المشروع: وش المنجز، وش المعلق، ووش تقترح نبدأ فيه»

بيستأذنك ينقل مجلدي البيانات لمكانهما داخل naqsh/assets — وافق. ولما يخلص ويأكد لك إن التركيب سليم، تقدر تحذف ملفات الـ ZIP.

كيف تتعامل معه وهو يشتغل

  • الاستئذان: قبل ما يعدل ملف أو ينفذ أمر، Claude يعرض لك وش بيسوي ويسألك. Enter = موافقة، أو اختر «No» للرفض. اقرأ وش يطلب قبل توافق — هذا خط دفاعك الأول (تفاصيل بقسم الحماية تحت).
  • الإيقاف: Esc يوقفه بنص الشغلة إذا حسيت إنه رايح باتجاه غلط.
  • الخروج: اكتب /exit أو اضغط Ctrl + C مرتين.
  • جلسة جديدة: كل ما تشغل claude من جديد يبدأ صفحة نظيفة — بس يقرأ CLAUDE.md تلقائياً فما يضيع السياق. ولو تبي يكمل آخر محادثة بالضبط: claude --continue

أمثلة طلبات

  • «عدل سعر مشروع هوكسن في الموقع التجريبي إلى …»
  • «ورني خلاصة تحليل المنافسين»
  • «أضف مشروع جديد اسمه … بنفس نموذج صفحة هوكسن»
  • «انشر التعديلات وتأكد إنها وصلت»
STEP 05

كلاودفلير — النشر على نفس الروابط

المواقع الثلاثة منشورة على حساب محمد في Cloudflare. عشان تحديثاتك تطلع على نفس الروابط الحالية (مو روابط جديدة)، تنضم لحسابه كعضو — إعداد مرة واحدة:

أ — خطوة عند محمد (دقيقتين)

  1. يدخل dash.cloudflare.com → Manage Account → Members
  2. Invite Member → يكتب إيميلك → صلاحية Administrator → إرسال

ب — خطوات عندك (مرة واحدة)

  1. توصلك دعوة على إيميلك — اقبلها وأنشئ حساب Cloudflare مجاني بنفس الإيميل.
  2. من الترمنال داخل مجلد المشروع:
    npx wrangler login
    يفتح المتصفح → وافق على الربط → اختر حساب محمد إذا سألك أي حساب.

ج — النشر بعد كذا (كل مرة)

ما تحفظ أي أوامر — تقول لـ Claude حرفياً: «انشر التعديلات وتأكد إنها وصلت». هو يعرف أي مجلد يروح لأي موقع (موثق له في CLAUDE.md) ويتحقق من الرابط الحي بعد النشر.

الموقعالرابط
الموقع التجريبيnaqsh-demo.pages.dev
التحليل والدراسةnaqsh-consulting.pages.dev
استراتيجية جيرةnaqsh-jeerah.pages.dev
ملاحظة: بدون الدعوة، أي نشر من جهازك بيروح لحسابك أنت وبيطلع برابط جديد مختلف — مو الروابط اللي فوق.
SAFETY ⚠️

حماية البيانات — المخاطر والقواعد

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

خطر 1 — حذف أو تخريب ملفات بالجهاز: Claude ما ينفذ شي إلا بموافقتك، فموافقاتك هي البوابة. لو شفت أمر فيه كلمة rm (حذف) أو delete يلمس مجلد assets أو research — ارفض واسأله ليش. هذي مجلدات البيانات الخام وما فيه أي سبب مشروع لحذف شي منها.
خطر 2 — النشر يستبدل الموقع الحي كاملاً: كل عملية نشر على كلاودفلير تستبدل الموقع كله بالنسخة المرفوعة. لو انرفع مجلد ناقص، صفحات حية بتختفي. الحماية موجودة: كلاودفلير يحفظ كل النشرات السابقة — ترجع لأي نسخة قديمة من اللوحة: dash.cloudflare.com → Workers & Pages → اسم المشروع → Deployments → القائمة (⋯) جنب أي نشرة قديمة → Rollback. يعني حتى أسوأ نشرة غلط تنصلح برجعة بضغطة زر.
خطر 3 — ضياع نسخة الشغل: المجلد اللي عندك هو نسخة العمل الوحيدة على جهازك. حمايتك ثلاث طبقات: (1) ملف الـ ZIP الأصلي محفوظ عندك، (2) نسخة محمد الكاملة على جهازه، (3) نقاط الحفظ — الفقرة الجاية.

نقاط الحفظ — جاهزة لك من الآن

المشروع مجهز بنظام نقاط حفظ (Git) وفيه نقطة أولى اسمها «النسخة المسلمة لعبدالرحمن». الاستخدام كله بالعربي مع Claude:

  • بعد أي جلسة شغل مهمة: «سوّ نقطة حفظ» — يحفظ لقطة كاملة من حالة المشروع.
  • لو شي خرب: «رجعني لآخر نقطة حفظ» أو «ورني نقاط الحفظ وش فيها».
  • Claude نفسه موجه (في CLAUDE.md) يقترح عليك نقطة حفظ قبل أي تغيير كبير — لا ترفضها.

ملاحظة: نقاط الحفظ تغطي الموقع والتحليل والأبحاث، وما تشمل مجلد assets (البيانات الخام الثقيلة) — لهذا قاعدة «assets للقراءة فقط» فوق مهمة.

القواعد الخمس — علقها

  1. ملفات الـ ZIP الثلاثة لا تنحذف إلا بعد تأكد التركيب — هي صورة المشروع يوم استلمته.
  2. مجلدا assets وresearch للقراءة فقط — نضيف عليها، ما نحذف منها ولا نعدل الموجود.
  3. نقطة حفظ بعد كل جلسة ناجحة — جملة وحدة: «سوّ نقطة حفظ».
  4. اقرأ قبل توافق — خصوصاً أي أمر حذف أو نشر.
  5. بعد كل نشر افتح الرابط وتأكد بنفسك — ولو شفت خلل: Rollback من لوحة كلاودفلير (خطر 2 فوق).
WORKFLOW

الطريقة المثلى لجلسة الشغل

  1. هدف واحد للجلسة — «اليوم نعدل صفحة هوكسن» أفضل من خمس طلبات متشابكة.
  2. اطلب وراجع — خل Claude يوريك النتيجة محلياً (يفتح لك الصفحة) قبل النشر.
  3. انشر وتحقق — «انشر وتأكد إنها وصلت»، وافتح الرابط من جوالك أيضاً.
  4. اختم بنقطة حفظ — «سوّ نقطة حفظ باسم: تعديل صفحة هوكسن».

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

DRIVE

مجلد قوقل درايف

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

مجلد حملات نقش — Google Drive

محتواه مفهرس بالكامل في research/drive-assets-catalog.md — إذا احتاج Claude ملفاً منه، بيطلب منك تنزله وتحطه في المكان اللي يحدده.