بناء WirelessHub مع Claude

إزاي ساعدت في بناء مدونة عن هندسة الـ wireless من الصفر، وClaude Code معايا كـ AI pair programmer

رسمة: مكتب مهندس بالليل عليه لابتوب وشاشة فيها موجات منورة، ومجسّم صغير لبرج محمول ولمبة مكتب

من كام شهر، صاحبي أحمد الشافعي (Ahmed Elshafie) — Wireless Systems Engineer في Apple وIEEE Senior Member — كان عايز مكان يشارك فيه علمه الكبير في الاتصالات اللاسلكية ومعالجة الإشارات والرياضيات. كان عنده الخبرة والمقالات. اللي كان ناقصه مكان ليها على النت. وهنا جه دوري، وهنا Claude Code بقى شريكي في البنا.

الفكرة

الهدف كان واضح: أبني مدونة نضيفة وسريعة وبتركز على المحتوى اسمها WirelessHub تخلّي مقالات أحمد التقنية تلمع. من غير frameworks تقيلة. من غير build tools. من غير npm. بس HTML وCSS وvanilla JavaScript — موقع static بيفتح فورًا وبيشتغل في أي مكان.

أحمد كان عنده أصلًا أكتر من 25 مقال بتغطي كل حاجة من الـ FFT في الحياة اليومية لـ MIMO beamforming لـ quantum wireless communication. والموقع لازم ينظّم ده كله، مع بحث وfiltering وتصنيف وdark mode، وحتى حلقات podcast مدمجة.

الشغل مع Claude Code

رسمة: لمبتين مكتب منوّرين ترابيزة واحدة مشتركة عليها رسومات antenna وموجات، ولابتوب على الجنب

Claude Code ماكانش مجرد أداة autocomplete في المشروع ده. كان شريك برمجة بجد. ده شكل الشغل عمليًا:

الـ Architecture Claude ساعد في تصميم الـ layout المبني على tabs، وقاعدة بيانات البحث بصيغة JSONL، ونظام الـ widgets في الـ sidebar
التنفيذ من زرار الـ dark mode لحد مشغّل الـ podcast بالتقديم والتأخير وشريط التقدم — Claude كتب code جاهز للـ production
نظام البحث بحث live بالكلمات المفتاحية على قاعدة بيانات JSONL بتتحمّل وقت الـ runtime، وبيدوّر في العناوين والـ tags والتصنيفات
لمسات التصميم حركات الـ hover، وظلال الـ cards، وlayouts بتتظبط على كل الشاشات، ونظام ألوان متناسق بين الـ theme الفاتح والغامق

كنت بوصف اللي عايزه — مرة بدقة ومرة بشكل عام — وClaude يلف في الـ codebase ويفهم الـ patterns الموجودة ويعمل تغييرات راكبة على المشروع بشكل طبيعي. لما قلتله «⁦add GoatCounter analytics to all pages⁩»، Claude عدّل 27 ملف HTML، وضاف script التتبع، وعمل template للمقالات، وحدّث توثيق المشروع، كل ده في لفّة واحدة.

أحلى حاجة في الشغل مع Claude Code إنه بيقرا قبل ما يكتب. بيفهم الـ codebase الأول، وبعدين يعمل تغييرات ماشية على الـ conventions الموجودة.

اللي بنيناه

الموقع في شكله النهائي static بالكامل — مستضاف ببلاش على GitHub Pages — ومع كده بيحسّسك إنه منصة محتوى كاملة:

تنقّل بالـ tabs بين الرئيسية والمقالات والـ podcast وعن الموقع. filtering بالتصنيفات بـ chips وأزرار ترتيب. مقال مميز في أعلى الصفحة الرئيسية. مشغّلات podcast في الـ sidebar وفي tab مخصوص، بتشغيل وإيقاف وشريط تقدم وتقديم وتأخير. dark mode بيفضل محفوظ من جلسة للتانية. بحث مباشر بيفلتر المقالات والـ podcast بالكلمة. وanalytics بتحترم الخصوصية عن طريق GoatCounter.

ده كله بـ vanilla HTML وCSS وJS. من غير build step. من غير dependencies. code نضيف ومقروء وبس.

اللي اتعلمته

الـ AI pair programming حاجة حقيقية

Claude Code ماكانش بيطلّع snippets من الـ code وبس — كان بيفهم السياق. بيقرا الملفات الموجودة، ويمشي على نفس أسلوب الـ code، ويعمل تغييرات على كذا ملف ماشية مع بعض. مسك حاجات فاتتني، واقترح طرق ماكنتش فكرت فيها.

المواقع الـ static لسه بتكسب

مفيش زهق من الـ frameworks. مفيش تحديثات dependencies. مفيش build بيفشل. الموقع بيفتح بسرعة، وبيشتغل offline بعد أول تحميل، وهيفضل شغال سنين من غير صيانة. لمدونة بتركز على المحتوى، ده بالظبط المطلوب.

التوثيق بيضاعف الأثر

كان عندنا ملف CLAUDE.md مفصّل، مكتوب فيه كل convention في المشروع — نظام الـ tabs، وصيغة الـ JSONL، والـ HTML structure بتاع الـ card، وكلاسات CSS للتصنيفات. يعني كل مرة أبدأ جلسة جديدة مع Claude، كان يفهم المشروع على طول ويعمل تغييرات صح من غير ما أشرح تاني.

التوثيق الكويس مش بيساعد الناس بس. ده بيخلّي الشغل مع الـ AI أفيد بمراحل.

شوفه بنفسك

WirelessHub live على ahmedsalahelshafie-ship-it.github.io/Ahmed_Elshafie_Blog. لو بتهتم بالاتصالات اللاسلكية أو معالجة الإشارات أو الرياضيات اللي ورا الاتصال الحديث، مقالات أحمد تستاهل وقتك.

ولو إنت developer وعندك فضول تجرّب التطوير بمساعدة الـ AI، أقدر أقولك من تجربتي: Claude Code حاجة بجد. مش كامل، بس شريك شاطر بشكل يلفت النظر، وبيخلّي المشاريع الطموحة تحسها في إيدك.