> ## Documentation Index
> Fetch the complete documentation index at: https://forgekit-docs-mintlify-7cd64f48.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# البدء السريع

> ثبّت Forge، وأصدر إعداد كل أداة من مصدر واحد، وشغّل أول بوّابة قبل الفعل — في نحو 60 ثانية.

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

## 1. التثبيت

<CodeGroup>
  ```bash Plugin (Claude Code / Codex) theme={null}
  /plugin marketplace add CodeWithJuber/forgekit
  /plugin install forgekit
  ```

  ```bash npm (any tool) theme={null}
  npm install -g @codewithjuber/forgekit
  ```

  ```bash No registry theme={null}
  npm install -g github:CodeWithJuber/forgekit
  ```
</CodeGroup>

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

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

<Steps>
  <Step title="أصدر إعداد كل أداة">
    ```bash theme={null}
    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 **القواعدَ نفسها**، كلٌّ من ملفها الأصلي.
  </Step>

  <Step title="افحص صحة الإعداد">
    ```bash theme={null}
    forge doctor
    ```

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

  <Step title="تغيير قاعدة لاحقًا">
    عدّل `source/rules.json` (أو ضع `.forge/rules.json` خاصًا بالمستودع)، ثم أعد التصريف:

    ```bash theme={null}
    forge sync
    ```

    الأمر `sync` عديم الأثر — يعيد كتابة ما تغيّر فقط.
  </Step>
</Steps>

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

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

```bash theme={null}
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
```

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

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

```bash theme={null}
forge substrate "<task>" --json   # machine-readable verdict
forge impact <symbol-or-file>     # the blast radius on its own
```

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

```bash theme={null}
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/`. هذه هي
الذاكرة الحاملة للإثبات — والآن يبدأ عائدها:

```bash theme={null}
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
```

<Card title="واصل" icon="arrow-right" href="/ar/concepts/pre-action-gate">
  اقرأ كيف تُركّب بوّابة ما قبل الفعل مراحلها في حكم واحد.
</Card>