البدء السريع

انتقل من الصفر إلى مستودع مُعدّ وأول فحص للركيزة في حوالي دقيقة.

1. التثبيت

/plugin marketplace add CodeWithJuber/forgekit
/plugin install forgekit

npm install -g @codewithjuber/forgekit

npm install -g github:CodeWithJuber/forgekit

المسار عبر المُلحق هو الموصى به لأداتَي Claude Code وCodex — تُوصَل الحواجز تلقائيًا ولا يوجد ما يُدمج. راجع التثبيت للمصفوفة الكاملة، بما في ذلك إعداد التطوير بالروابط الرمزية.

2. إعداد المستودع

أصدر إعداد كل أداة

cd ~/your-project
forge init

يُصدر هذا AGENTS.md، وCLAUDE.md، و.gemini/settings.json، و.aider.conf.yml، والباقي — إضافةً إلى قاعدة الدمج الاتحادي في .gitattributes التي يحتاجها السجل. الآن تقرأ Claude Code، وCodex، وCursor، وGemini، وAider، وCopilot، وWindsurf، وZed، وContinue القواعدَ نفسها، كلٌّ من ملفها الأصلي.

افحص صحة الإعداد

forge doctor

فحص نجاح/إخفاق للأدوات المثبتة، والحواجز، ومصادقة MCP، وانحراف الإعدادات.

تغيير قاعدة لاحقًا

عدّل source/rules.json (أو ضع .forge/rules.json خاصًا بالمستودع)، ثم أعد التصريف:

forge sync

الأمر sync عديم الأثر — يعيد كتابة ما تغيّر فقط.

3. تشغيل بوّابة ما قبل الفعل

الركيزة هي الطبقة التي تعمل قبل أن يعدّل النموذج الشيفرة. أمر واحد يُشغّل البوّابة بأكملها:

forge substrate "Change verifyToken in src/auth.js to require length > 20; update tests"
#   → assumption verdict · cheapest capable model · predicted blast radius
#     (including files you didn't name) · scope clusters · verification checklist

في Claude Code تعمل الركيزة تلقائيًا على كل طلب عبر خطّاف UserPromptSubmit — إرشادية فقط، وصامتة عند المهام النظيفة. تحصل كل أداة أخرى على قاعدة إعداد أصلية إضافةً إلى 19 أداة MCP يمكنها استدعاؤها بنفسها.

إذا قال forge substrate ASK FIRST، اسأل الأسئلة المُرجَعة قبل التعديل. اقرأ الملفات المتوقع تأثرها — نصف قطر الانفجار — قبل أي تغيير مُعدِّل.

forge substrate "<task>" --json   # machine-readable verdict
forge impact <symbol-or-file>     # the blast radius on its own

4. استكشف الإضافات

forge atlas build          # index this repo's symbols → .forge/atlas.json
forge atlas query useAuth  # where is it defined? (cheaper than grep-and-read)
forge atlas has useAuth    # does it exist? "not found" = likely hallucinated
forge recall add "db port" "Postgres is on 5433 here, not 5432"
forge catalog              # the Start-Here index of everything

5. اليوم الثاني: السجل يتعلّم

كل ما تعلمته الركيزة في اليوم الأول أُودع كادعاءات في .forge/ledger/. هذه هي الذاكرة الحاملة للإثبات — والآن يبدأ عائدها:

forge ledger stats                              # what the repo knows, by kind and trust
forge ledger blame <id-prefix>                  # who minted a claim, every oracle outcome
forge reuse query "<what you're about to build>"  # verified code you already have

واصل

اقرأ كيف تُركّب بوّابة ما قبل الفعل مراحلها في حكم واحد.

ابدأ

المفاهيم الأساسية

البدء السريع

1. التثبيت

2. إعداد المستودع

3. تشغيل بوّابة ما قبل الفعل

4. استكشف الإضافات

5. اليوم الثاني: السجل يتعلّم

واصل

​1. التثبيت

​2. إعداد المستودع

​3. تشغيل بوّابة ما قبل الفعل

​4. استكشف الإضافات

​5. اليوم الثاني: السجل يتعلّم

واصل

1. التثبيت

2. إعداد المستودع

3. تشغيل بوّابة ما قبل الفعل

4. استكشف الإضافات

5. اليوم الثاني: السجل يتعلّم