> ## Documentation Index > Fetch the complete documentation index at: https://forgekit-docs-mintlify-efdb1a73.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Forge: الركيزة المعرفية لوكلاء البرمجة بالذكاء الاصطناعي > Forge هو الركيزة المعرفية التي يفتقدها كل نموذج عديم الحالة — الذاكرة، والاستشراف، وحواجز الأمان — يُقدَّم كإعداد أصلي لكل وكيل برمجة يعتمد على الذكاء الاصطناعي. **دماغ واحد لكل وكيل برمجة يعتمد على الذكاء الاصطناعي.** النموذج اللغوي الكبير عديم الحالة: نافذة سياق واحدة، تُمسح مع كل استدعاء. ليس لديه أي ذاكرة بما تعلمه فريقك، ولا استشراف لما قد يكسره أي تعديل، ولا حواجز أمان مُنفَّذة. إن Forge (`@codewithjuber/forgekit`) هو **الركيزة المعرفية** — الطبقة التي تعمل *قبل* أن يعدّل النموذج الشيفرة، والتي تُوفّر ذاكرةً مرجعية للأدلة وعنوانها محتواها (نُطلق عليها اسم "الذاكرة الحاملة للإثبات")، واستشرافًا استدلاليًا للأثر، وحواجز أمان مُنفَّذة — وكذلك **مُصرِّف إعدادات عابر للأدوات** يوصل هذا الدماغ كإعداد أصلي إلى كل الأدوات دفعة واحدة. أعمق تكامل مُختبَر هو مع Claude Code؛ أما البقية فتحصل على إعداد أصلي وأدوات MCP، مع تجربة ميدانية أقل. ذاكرة حاملة للإثبات تدوم عبر الجلسات وبين أعضاء الفريق. كل درس، وحقيقة، وإعادة استخدام مُتحقَّق منها هي ادعاء يحمل دليله معه. نصف قطر الانفجار لأي تعديل — مجموعة الملفات المتوقع أن يمسّها، مقروءةً من رسم الشيفرة، بما في ذلك الملفات المُترابطة التي لم تسمّها. خطّافات حتمية تُنفّذ القواعد التي لا يجوز للنموذج أن يخالفها أبدًا. تصمد بعد ضغط السياق بطريقة لا يصمد بها النص الطليق في ملف إعدادات. ## المشكلة النموذج اللغوي الكبير عديم الحالة — نافذة سياق واحدة، تُمسح مع كل استدعاء. * **لا يملك أي ذاكرة** بما تعلمه فريقك سابقًا. * **لا يملك أي استشراف** لما سيكسره أي تعديل. * **لا يملك أي حواجز أمان مُنفَّذة** — القواعد النصية تُنسى بعد الضغط. وكل أداة تريد ملف إعدادات خاصًا بها (`CLAUDE.md`، `AGENTS.md`، `.cursor/rules`، `GEMINI.md`، MCP…). إن Forge هو الركيزة المعرفية التي تُوفّر الأشياء الثلاثة المفقودة، والمُصرِّف الذي يوصلها إلى كل أداة من مصدر واحد. ## الأطروحة لا يستطيع النموذج أن يتعلم من قاعدة شيفرتك بين الاستدعاءات: أوزانه مُجمَّدة وذاكرته العاملة تُمسح بعد كل استجابة. لا يمكن حَقن الذاكرة والاستشراف والتحقق الذاتي فيه عبر الطلبات — يجب توفيرها من *الخارج*. تلك الطبقة الخارجية هي الركيزة المعرفية. رياضيًا، الاستدلال هو دالة ثابتة `y = f(x)` بلا حالة بين الاستدعاءات؛ وForge هو الحالة. اكتب قواعدك وإعدادات الركيزة الافتراضية في مصدر واحد قانوني (`source/rules.json`، `source/substrate.json`، `source/mcp.json`). يقوم `forge sync` بتصريف هذا المصدر إلى الإعداد الأصلي لكل أداة — تسع أدوات برمجة مدعومة بالذكاء الاصطناعي إضافةً إلى MCP — مع ترويسة تجزئة للمحتوى، فيصير الانحراف قابلًا للكشف وإعادة التشغيل بلا أثر. يُشغّل `forge substrate ""` تمريرًا حتميًا واحدًا قبل الفعل: الافتراضات، والتوجيه، وإعادة الاستخدام، والسياق، ونصف قطر الانفجار، والنطاق، ومرساة الهدف. فقط الأدوات المستقلة — الاختبارات وCI وقبول/تراجع الإنسان — هي التي تحرّك ثقة الذاكرة، بحيث يتلاشى الدرس الخاطئ بدلًا من أن يتحجّر. ## ماذا تحصل * **ذاكرة تدوم عبر الجلسات وبين أعضاء الفريق.** كل درس، وحقيقة، وإعادة استخدام مُتحقَّق منها هي *ذاكرة حاملة للإثبات (PCM)* — اسمنا للذاكرة المرجعية للأدلة والمعنونة بمحتواها: ادعاء يحمل مراجع لأدلته ولا يُوثَق به إلا عندما ترفع الأدوات المستقلة ثقته فوق حدٍّ أدنى. "الإثبات" هو مسار الأدلة، لا برهان صوري. * **استشراف قبل أن تكسر الأشياء.** اسأل "ماذا يكسر تغييرُ `verifyToken`؟" واحصل على نصف قطر الانفجار من رسم الشيفرة، بما في ذلك الملفات المترابطة التي لم تسمّها. * **حواجز أمان لا يمكن نسيانها.** خطّافات حتمية تُنفّذ المسارات المحمية، وميزانيات التكلفة، وكشف الحلقات الهالكة — وتصمد بعد ضغط السياق. * **عمل يكتمل من طرف إلى طرف.** بوّابة إكمال تحجب "تم" مرة واحدة في كل جلسة عند تحرّك الشيفرة دون أن يتبعها توثيق أو أثر حالة، مع قائمة الإصلاح كإجابة. * **إعداد واحد لتسع أدوات.** اكتب قواعدك مرة واحدة؛ يُصدر Forge الإعداد الأصلي لكل أداة، إضافةً إلى MCP لأدوات Roo وVS Code. صفر تبعيات وقت التشغيل — CLI واحد بلغة Node، وملفات عادية في git، دون خادم. ## أي أدوات يُغذّي Forge؟ يُصدر Forge إعدادات لـ **تسع أدوات**، إضافةً إلى خادم MCP لأداتَي Roo Code وVS Code: Claude Code، وCodex، وCursor، وGemini، وAider، وCopilot، وWindsurf/Devin، وZed، وContinue. تقرأ كلٌّ منها القواعد نفسها من ملفها الأصلي. خادم MCP الوحيد الموصول افتراضيًا هو خادم Forge نفسه (`src/cortex_mcp.js`) — فحوصات الركيزة وقراءات الذاكرة. أما خوادم MCP الطرف الثالث مثل `context7` فهي **اختيارية** ولا تهبط على القرص إلى أن تُشغّل [`forge integrations add --yes`](/cli/config#forge-integrations). ## الحدود الصادقة يُعلن Forge سقفه في كل مكان. إن Forge **يُقلّل ولا يُلغي** انحراف القواعد. هو طبقة شفافية وموثوقية، لا بديل للاختبارات أو المراجعة أو الحكم البشري. * **الحواجز تُنفّذ فقط ما يمكن التعبير عنه كخطّاف** (المسارات، والتنسيق، وحجم الفرق، والميزانية). القواعد الدلالية ("فضّل الأسلوب الدالّي") تبقى نصًا وقد تُتجاهل أحيانًا. * **التحقق يُقلّل ولا يشهد.** يُقلّص الفريق المُتحقِّق وعَلَم الرموز المُهلوَسة عبء المراجعة؛ لكنها لا تُثبت صحة الشيفرة. * **لا تعلّم على مستوى الأوزان.** `recall` / `cortex` ذاكرة ملفات وطلبات فقط — لا تعلّم مُعزَّز ولا ضبط دقيق. * **رسم الأثر تقريبي بواسطة regex** — متحفّظ لا رسم استدعاء دقيق. * **الاختبارات وتصحيحات الإنسان تفوز دائمًا.** إن Forge في مرحلة **بيتا**. النواة (`init`، `sync`، `substrate`، `impact`، `ledger`، والحواجز) مُختبَرة ومستخدمة يوميًا؛ قد تتغيّر بعض العلامات قبل `1.0`. ## الخطوات التالية ثبِّت، وشغّل `forge init`، ومرِّر مهمتك الأولى عبر الركيزة. المُصرِّف رباعي الطبقات، والذاكرة الحاملة للإثبات، وبوّابة ما قبل الفعل. كل أمر مُصنَّف حسب المجموعات: Core وMemory وSubstrate وQuality وConfig. ادمج سجل زميلك في فريقك بلا تعارضات، عبر git عادي.