يبدأ وكيل البرمجة كل جلسة وهو لا يعرف لماذا اخترتَ هذه المكتبة، ولا أين يوضع الملف الجديد، ولا القاعدة التي اتفق عليها فريقك. تحفظ إضافة archcore هذه المعرفة مستندات Markdown داخل مجلد .archcore/، فتنتقل مع Git بين الجلسات والوكلاء، ويقرؤها الوكيل عبر خادم MCP من أداة Archcore CLI المحلية.
الإصدار المرفق 0.9.1 مكتوب لـ Claude Code، ومعه ملفات إعداد لـ Codex CLI وCursor وGitHub Copilot. ولا يشغّل claude.ai في المتصفح الأداة المحلية التي تحتاجها الإضافة.
الأوامر الأربعة
/archcore:init: يقدّر حجم المستودع، ثم يقترح في معاينة واحدة قاعدة للتقنيات، ودليل تشغيل، ونظرة معمارية عامة، ومواصفات لأهم الوحدات، ونموذج البيانات والتكاملات إن وجدها، ويعرض استيراد CLAUDE.md وAGENTS.md و.cursorrules الموجودة. يقبل refresh لإضافة ما استجد، وdomain لنطاق واحد، و--depth=light|standard|deepلحجم ما يكتبه./archcore:document: يسجّل الوضع القائم: decision لقرار (ADR أو RFC أو rule)، وcode لوصف كود موجود (spec أو doc أو guide أو scenario)، وresearch لتقرير جاهز أو مادة خارجية واحدة./archcore:plan: يخطط لميزة بمسار يحسبه من حجم التغيير: إصلاح صغير بلا مستندات، أو spec وخطة لقدرة واحدة، أو PRD جامع لمبادرة كبيرة. ويقبل sdd، وsources لأبحاث السوق، وiso لسلسلة متطلبات ISO 29148، وresearch لتحقيق تقني./archcore:review: يقارن تغييرات فرعك بالمستندات في الاتجاهين، ويصنّف كل تعارض: spec-wrong إن تقادم المستند، أو code-wrong إن خالف الكود مستندًا ما زال قائمًا. وعلى الفرع الرئيسي يعرض حالة المستندات. ومن أوضاعه drift لكشف المستندات المتقادمة، وdeep لتدقيق شامل، وcloseout لإغلاق ميزة انتهت.
الوكيلان والخطافات
- archcore-assistant: للمهام التي تمس أكثر من مستند. يبدأ كل استدعاء بقائمة المستندات والعلاقات كاملة حتى لا ينشئ نسخة مكررة.
- archcore-auditor: مدقق للقراءة فقط، يبحث عن مستندات بلا علاقات، وثغرات في التغطية، ومستندات تشير إلى كود تغيّر، ويسلّم تقريرًا مقسومًا إلى حرج وتحذير ومعلومة.
- عند بدء الجلسة: يُحمَّل سياق .archcore/، ويقترح الخطاف /archcore:init إن كان المجلد فارغًا.
- قبل Write وEdit: يمنع تحرير ملفات .archcore/ مباشرة ويحيل التعديل إلى أدوات MCP، ويُلحق بتعديل الكود ما ينطبق عليه من مستندات المشروع.
- بعد إنشاء مستند أو تعديله: يتحقق منه وينبّه دون أن يمنع.
مثال: أول تشغيل في مستودع قائم
تكتب /archcore:init. وبحسب ملف المهارة، يتحقق من وجود archcore، ثم يعرض المستندات المقترحة وتكلفة كل من light وstandard وdeep، ولا ينشئ أي مستند ولا يعدّل .mcp.json قبل أن تكتب confirm. وبعدها ينقلك /archcore:document decision rfc for gRPC إلى فرع RFC دون سؤال عن النوع.
التثبيت
- ثبّت Archcore CLI أولًا، فهو غير مرفق بالحزمة. على macOS وLinux وWSL: curl -fsSL https://archcore.ai/install.sh | bash، وعلى Windows في PowerShell: irm https://archcore.ai/install.ps1 | iex، ثم تحقق بـ
archcore --version(صفحة التثبيت). - فك الضغط في مجلد ثابت، وشغّل
claude --plugin-dir "PATH/TO/EXTRACTED/plugin"بعد وضع المسار الفعلي؛ والتحميل هنا للجلسة الحالية فقط. - ثم شغّل /archcore:init في مشروعك.
المتطلبات والحدود
- يلزم Git وArchcore CLI بإصدار 0.7.0 أو أحدث، ومع إصدار أقدم يتوقف منع الكتابة المباشرة والتحقق بعدها. ونوعا research وevidence يحتاجان 0.8.3، وscenario يحتاج 0.8.4.
- سكربتات الخطافات مكتوبة بـ POSIX sh، فتحتاج على Windows إلى بيئة تشغّلها مثل WSL.
المصدر والترخيص
الإضافة من تطوير Archcore، ومصدرها archcore-ai/plugin (commit 5a8c659) بترخيص Apache-2.0. أرفقتُ ملفي LICENSE وNOTICE كما هما، وأضفتُ إليهما دليلًا عربيًا وفهرسًا للمكونات.
