البنية التقنية

(مسودة من إنتاج AI. سيتم إعادة كتابتها بواسطة إنسان لاحقًا.)

لمحة سريعة عمّا بُني به techmeat.dev، والأدوات التي أعتمد عليها يوميًا، وسير العمل الذي أستخدمه لنشر المقالات وإطلاق الميزات بالاستعانة بوكلاء البرمجة.

الحزمة التقنية

• Astro 6 في وضع output: 'static'. المقالات بصيغة Markdown، تُعرض عبر مجموعات المحتوى في Astro.
• Solid.js عبر @astrojs/solid-js للجزر التفاعلية القليلة — مبدّل السمة، ومبدّل اللغة، وزر نسخ كتل الكود.
• Bun كبيئة تشغيل ومدير حزم ومُشغّل اختبارات. لا npm ولا pnpm.
• Cloudflare Pages للاستضافة؛ وCloudflare Web Analytics لقياس الزيارات، دون كوكيز.
• satori + resvg لتوليد بطاقات OG وقت البناء لكل مقالة ولكل لغة.
• @vite-pwa/astro (Workbox) لتطبيق PWA قابل للتثبيت مع بديل يعمل دون اتصال.
• @astrojs/sitemap + @astrojs/rss لخريطة الموقع وخلاصات RSS لكل لغة.

أدوات التطوير

• oxlint + oxfmt — مدقّق ومُنسّق مكتوبان بلغة Rust. لا ESLint ولا Prettier.
• @astrojs/check للتحقق من TypeScript داخل ملفات .astro.
• lefthook لخطافات ما قبل الالتزام (lint + تنسيق + فحص الأنواع عند كل commit).
• bun:test كإطار للاختبارات.

مساعدو الـ AI

• Claude Code — وكيل البرمجة الأساسي. سياق المشروع موجود في CLAUDE.md وAGENTS.md.
• مهارات Superpowers — brainstorming وwriting-plans وsubagent-driven-development للميزات غير البديهية.
• GPT-5.5 — يُستخدم لمراجعة الكود في تمريرة ثانية على التغييرات الأكبر.
• طاقم مهارات SEO / GEO — البحث في الكلمات المفتاحية، وتحسين وسوم الميتا، وschema markup، والتدقيق داخل الصفحة، ومدقّق جودة المحتوى (CORE-EEAT)، ومُحسّن محتوى GEO لمحركات الـ AI.

العتاد

• (عنصر نائب — سيتم تعبئته بواسطة الإنسان.)

سير العمل

كل مقالة وكل ميزة تمرّ تقريبًا بالحلقة نفسها:

1. تثبيت الهدف والقيود في CLAUDE.md / AGENTS.md ليكون لدى الوكيل سياق ثابت.
2. استكشاف شكل العمل عبر Superpowers؛ ثم إنتاج مواصفات تصميم.
3. تحويل المواصفات إلى خطة تنفيذ بخطوات ملموسة.
4. تنفيذ مدفوع بالوكلاء الفرعيين، مع مراجعة من مرحلتين (التوافق مع المواصفات، ثم جودة الكود) لكل مهمة.
5. للمقالات: خط أنابيب SEO + GEO متعدد المراحل قبل النشر.

الغاية من هذه الصفحة أن أكون صريحًا بشأن سلسلة الأدوات حتى تبقى المقالات مركّزة على العملية بدلًا من إعادة شرح الإعداد في كل مرة.