وثائق Apothem

Apothem هو مدير تهيئة مستقل عن المضيف. تكتب ملف تعريف مشترك واحد في ~/.config/apothem/profile.yaml، فيحوِّله Apothem إلى أسطح التهيئة الأصلية لسبعة عشر إطار عمل — Claude Code وCursor وGemini CLI وGitHub Copilot وCodex وWindsurf وZed، وبقية الأدوات في الكتالوج المُسجَّل.

الوحدة التي يزامنها Apothem أوسع من القواعد وحدها. تنتقل القواعد، وأوامر الشرطة المائلة، والمهارات، والخطّافات، وأنماط الإخراج، والإعدادات (مع خوادم MCP)، والمخططات، والوثائق معًا بوصفها مجموعة واحدة محكومة، وتُحوَّل إلى الصيغة الأصلية لكل إطار عمل أو إلى شجرة دعم يملكها Apothem حيث لا تملك الأداة بدائيةً مطابقة.

جديد هنا؟ ابدأ في خطوتين

1. التثبيت — اختر مسار تثبيت (الإضافات والملحقات الأصلية للأدوات، أو npx، أو البرامج النصية المؤلَّفة من خطوة واحدة) وشغِّل الخطوة الأولى الموجَّهة. المتطلبان الوحيدان هما Node.js وPython 3.10 أو أحدث على النظام.
2. الوصول إلى أول تشغيل ناجح — اكتب ملف تعريف مشترك، وحوِّل منه التهيئة الأصلية لأحد أُطُر العمل، وتحقَّق من النتيجة. نحو خمس عشرة دقيقة من البداية إلى النهاية.

كيف يعمل Apothem

• ملف تعريف واحد، تهيئات أصلية متعددة. تكتب القصد مرة واحدة، فيترجمه Apothem إلى سطح التهيئة الأصلي لكل أداة — دون تسوية إلى القاسم المشترك الأدنى. انظر الوضعية المستقلة عن المضيف.
• حلقة التشغيل: خطِّط ← صلِّب ← اشحن. يحمل خطّ أنابيب التخطيط (/plan) أي تغيير عبر المواصفة والتوليد والمراجعة والتنفيذ، ويدفع خطّ أنابيب التصليب (/fortress) هذا العمل إلى حالة مُحكَمة بالإصدار، ثم تُغلق بوابة الإصدار الحلقة. انظر خط أنابيب الأوامر.
• عمل يصمد عبر الحدود. يُخرِج العمل الطويل الأمد حالته الكاملة إلى مجموعة .apothem/plans/ محلية للمشروع، فتستأنفه جلسة جديدة على أي حساب أو جهاز في مكانه. انظر التخطيط القابل للاستئناف.

ابدأ من هنا

• التثبيت — مسارات التثبيت (الإضافات والملحقات الأصلية للأدوات، وnpx، والبرامج النصية المؤلَّفة من خطوة واحدة)، مع تشغيل أول موجَّه.
• الاستخدام — اكتب ملف تعريف، وثبِّته على كل أُطُر العمل، وتحقَّق منه وحدِّثه.
• أُطُر العمل — كتالوج أُطُر العمل السبعة عشر، مع سطح التهيئة الأصلي لكل أداة وسلوك تحويلها.
• خط أنابيب الأوامر — مراحل خطّي أنابيب /plan و/research، وتسلسل التدقيق والمراجعة، ومهارتا workflow وprojectify، وحواجز الأمان للعمليات الجراحية.

تعمَّق أكثر

• المفاهيم — ملف التعريف المشترك، ومحوِّلات أُطُر العمل، ونموذج التحويل.
• البنية — هيكل الشفرة المصدرية، وتجريد المحوِّلات، وزمن التشغيل المكتفي ذاتيًا، وتدفق CI/CD.
• المرجع — كتالوج CLI، ومخطط ملف التعريف، والقواعد، والمهارات، والأوامر، والخطّافات، وأنماط الإخراج.
• مقارنة Apothem — مصفوفة تمييز صادقة تُسمّي المنافسين.

الحوكمة والأمان

• الحوكمة — سجلّات الانضباط، وبوابة المطابقة، وواجهة الإصدار.
• الأمان — وضعية سلسلة التوريد وسياسة الأمان.
• سِجِلّ التغييرات — ملاحظات الإصدار، الإصدار الحالي أولًا.