Skip to content

BuilderIO/agent-native / packages/core/docs

agent-native-docs

Unverified

How to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.

FileKindSize
AGENTS.mdmarkdown6.0 KB
SKILL.mdskill md2.2 KB
content/a2a-protocol.mdxmarkdown37.6 KB
content/actions-access-control.mdxmarkdown28.9 KB
content/actions-advanced.mdxmarkdown13.1 KB
content/actions-agent-tools.mdxmarkdown5.6 KB
content/actions-defining.mdxmarkdown31.2 KB
content/actions-other-surfaces.mdxmarkdown10.3 KB
content/actions-overview.mdxmarkdown8.3 KB
content/actions-run-context.mdxmarkdown9.1 KB
content/add-ui-to-your-agent.mdxmarkdown5.0 KB
content/administered-deployments.mdxmarkdown7.7 KB
content/agent-mentions.mdxmarkdown10.2 KB
content/agent-native-config.mdxmarkdown34.9 KB
content/agent-native-toolkit.mdxmarkdown17.3 KB
content/agent-resources.mdxmarkdown27.0 KB
content/agent-surfaces.mdxmarkdown33.8 KB
content/agent-teams.mdxmarkdown13.4 KB
content/agent-web-surfaces.mdxmarkdown10.7 KB
content/agentkit.mdxmarkdown14.0 KB
content/audit-log.mdxmarkdown14.3 KB
content/authentication.mdxmarkdown30.7 KB
content/automation-connectors.mdxmarkdown7.8 KB
content/automations.mdxmarkdown26.7 KB
content/aws-amplify.mdxmarkdown10.7 KB
content/aws-lambda.mdxmarkdown13.9 KB
content/aws-rds.mdxmarkdown1.7 KB
content/azure-postgresql.mdxmarkdown1.8 KB
content/azure-static-web-apps.mdxmarkdown9.1 KB
content/blueprint-installer.mdxmarkdown6.3 KB
content/cli-adapters.mdxmarkdown5.7 KB
content/client-advanced.mdxmarkdown13.1 KB
content/client-agent-chat.mdxmarkdown17.7 KB
content/client-data.mdxmarkdown19.3 KB
content/client-entry-points.mdxmarkdown1.2 KB
content/client-overview.mdxmarkdown10.6 KB
content/client-routing.mdxmarkdown5.7 KB
content/client-sync-internals.mdxmarkdown5.2 KB
content/cloneable-saas.mdxmarkdown16.6 KB
content/cloud-sql.mdxmarkdown2.3 KB
content/cloudflare.mdxmarkdown8.3 KB
content/code-agents-ui.mdxmarkdown26.6 KB
content/components.mdxmarkdown42.9 KB
content/context-awareness.mdxmarkdown24.9 KB
content/create-with-an-agent.mdxmarkdown8.8 KB
content/creating-templates.mdxmarkdown21.6 KB
content/cross-app-connect-design.mdxmarkdown8.4 KB
content/cross-app-sso.mdxmarkdown8.7 KB
content/custom-design-system.mdxmarkdown17.3 KB
content/data-programs.mdxmarkdown25.0 KB
content/decisions.mdxmarkdown7.9 KB
content/deno-deploy.mdxmarkdown7.2 KB
content/deploy-an-app.mdxmarkdown5.0 KB
content/deployment-environment-variables.mdxmarkdown16.3 KB
content/deployment.mdxmarkdown11.3 KB
content/dispatch.mdxmarkdown18.6 KB
content/docker.mdxmarkdown8.1 KB
content/docs-components.mdxmarkdown28.9 KB
content/doctor.mdxmarkdown21.3 KB
content/drafts/clips-experimental-features.mdmarkdown5.4 KB
content/drop-in-agent.mdxmarkdown16.0 KB
content/durable-background-runs.mdxmarkdown13.8 KB
content/durable-resume.mdxmarkdown10.0 KB
content/embedding-sdk.mdxmarkdown31.3 KB
content/environment-variables.mdxmarkdown29.9 KB
content/evals.mdxmarkdown12.4 KB
content/extensions.mdxmarkdown34.8 KB
content/external-agents-catalog.mdxmarkdown40.5 KB
content/external-agents.mdxmarkdown29.3 KB
content/file-uploads.mdxmarkdown10.7 KB
content/generative-ui.mdxmarkdown10.8 KB
content/getting-started-actions.mdxmarkdown2.7 KB
content/getting-started-pages.mdxmarkdown2.6 KB
content/getting-started.mdxmarkdown7.2 KB
content/harness-agents.mdxmarkdown16.9 KB
content/http-api.mdxmarkdown20.9 KB
content/integrations.mdxmarkdown33.8 KB
content/internationalization.mdxmarkdown6.2 KB
content/key-concepts.mdxmarkdown30.6 KB
content/koyeb.mdxmarkdown7.3 KB
content/locales/ar-SA/a2a-protocol.mdxmarkdown48.5 KB
content/locales/ar-SA/actions-access-control.mdxmarkdown40.8 KB
content/locales/ar-SA/actions-advanced.mdxmarkdown16.3 KB
content/locales/ar-SA/actions-agent-tools.mdxmarkdown8.1 KB
content/locales/ar-SA/actions-defining.mdxmarkdown42.2 KB
content/locales/ar-SA/actions-other-surfaces.mdxmarkdown14.5 KB
content/locales/ar-SA/actions-overview.mdxmarkdown11.3 KB
content/locales/ar-SA/actions-run-context.mdxmarkdown11.1 KB
content/locales/ar-SA/add-ui-to-your-agent.mdxmarkdown3.7 KB
content/locales/ar-SA/administered-deployments.mdxmarkdown6.4 KB
content/locales/ar-SA/agent-mentions.mdxmarkdown11.8 KB
content/locales/ar-SA/agent-native-toolkit.mdxmarkdown17.3 KB
content/locales/ar-SA/agent-resources.mdxmarkdown36.8 KB
content/locales/ar-SA/agent-surfaces.mdxmarkdown48.4 KB
content/locales/ar-SA/agent-teams.mdxmarkdown18.5 KB
content/locales/ar-SA/agent-web-surfaces.mdxmarkdown14.3 KB
content/locales/ar-SA/audit-log.mdxmarkdown15.9 KB
content/locales/ar-SA/authentication.mdxmarkdown39.8 KB
content/locales/ar-SA/automations.mdxmarkdown31.3 KB
content/locales/ar-SA/aws-amplify.mdxmarkdown14.9 KB
content/locales/ar-SA/aws-lambda.mdxmarkdown18.9 KB
content/locales/ar-SA/aws-rds.mdxmarkdown319 B
content/locales/ar-SA/azure-postgresql.mdxmarkdown344 B
content/locales/ar-SA/azure-static-web-apps.mdxmarkdown12.4 KB
content/locales/ar-SA/blueprint-installer.mdxmarkdown8.4 KB
content/locales/ar-SA/cli-adapters.mdxmarkdown6.7 KB
content/locales/ar-SA/client-advanced.mdxmarkdown17.8 KB
content/locales/ar-SA/client-agent-chat.mdxmarkdown23.0 KB
content/locales/ar-SA/client-data.mdxmarkdown23.8 KB
content/locales/ar-SA/client-entry-points.mdxmarkdown1.6 KB
content/locales/ar-SA/client-overview.mdxmarkdown13.9 KB
content/locales/ar-SA/client-routing.mdxmarkdown7.2 KB
content/locales/ar-SA/client-sync-internals.mdxmarkdown7.3 KB
content/locales/ar-SA/cloneable-saas.mdxmarkdown23.2 KB
content/locales/ar-SA/cloud-sql.mdxmarkdown317 B
content/locales/ar-SA/cloudflare.mdxmarkdown11.9 KB
content/locales/ar-SA/code-agents-ui.mdxmarkdown34.2 KB
content/locales/ar-SA/components.mdxmarkdown51.5 KB
content/locales/ar-SA/context-awareness.mdxmarkdown33.1 KB
content/locales/ar-SA/create-with-an-agent.mdxmarkdown12.2 KB
content/locales/ar-SA/creating-templates.mdxmarkdown26.8 KB
content/locales/ar-SA/cross-app-connect-design.mdxmarkdown1.5 KB
content/locales/ar-SA/cross-app-sso.mdxmarkdown9.7 KB
content/locales/ar-SA/custom-design-system.mdxmarkdown21.6 KB
content/locales/ar-SA/data-programs.mdxmarkdown33.3 KB
content/locales/ar-SA/decisions.mdxmarkdown9.1 KB
content/locales/ar-SA/deno-deploy.mdxmarkdown10.1 KB
content/locales/ar-SA/deploy-an-app.mdxmarkdown7.1 KB
content/locales/ar-SA/deployment-environment-variables.mdxmarkdown21.3 KB
content/locales/ar-SA/deployment.mdxmarkdown13.9 KB
content/locales/ar-SA/dispatch.mdxmarkdown27.3 KB
content/locales/ar-SA/docker.mdxmarkdown11.3 KB
content/locales/ar-SA/doctor.mdxmarkdown3.4 KB
content/locales/ar-SA/drop-in-agent.mdxmarkdown20.8 KB
content/locales/ar-SA/durable-resume.mdxmarkdown15.4 KB
content/locales/ar-SA/embedding-sdk.mdxmarkdown41.3 KB
content/locales/ar-SA/evals.mdxmarkdown13.3 KB
content/locales/ar-SA/extensions.mdxmarkdown34.0 KB
content/locales/ar-SA/external-agents.mdxmarkdown89.3 KB
content/locales/ar-SA/file-uploads.mdxmarkdown13.4 KB
content/locales/ar-SA/getting-started-actions.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started-pages.mdxmarkdown3.2 KB
content/locales/ar-SA/getting-started.mdxmarkdown9.7 KB
content/locales/ar-SA/harness-agents.mdxmarkdown22.3 KB
content/locales/ar-SA/internationalization.mdxmarkdown8.2 KB
content/locales/ar-SA/key-concepts.mdxmarkdown42.0 KB
content/locales/ar-SA/koyeb.mdxmarkdown10.2 KB
content/locales/ar-SA/mcp-apps.mdxmarkdown33.7 KB
content/locales/ar-SA/mcp-clients.mdxmarkdown35.0 KB
content/locales/ar-SA/mcp-protocol.mdxmarkdown27.6 KB
content/locales/ar-SA/messaging.mdxmarkdown59.2 KB
content/locales/ar-SA/multi-app-workspace.mdxmarkdown36.2 KB
content/locales/ar-SA/multi-tenancy.mdxmarkdown7.5 KB
content/locales/ar-SA/native-chat-ui.mdxmarkdown21.3 KB
content/locales/ar-SA/neon.mdxmarkdown244 B
content/locales/ar-SA/netlify.mdxmarkdown15.2 KB
content/locales/ar-SA/node-docker.mdxmarkdown878 B
content/locales/ar-SA/node-js.mdxmarkdown8.4 KB
content/locales/ar-SA/notifications.mdxmarkdown16.2 KB
content/locales/ar-SA/observability.mdxmarkdown45.2 KB
content/locales/ar-SA/observational-memory.mdxmarkdown10.9 KB
content/locales/ar-SA/onboarding.mdxmarkdown16.9 KB
content/locales/ar-SA/organizations-teams-permissions.mdxmarkdown5.9 KB
content/locales/ar-SA/package-lifecycle.mdxmarkdown3.0 KB
content/locales/ar-SA/plan-plugin.mdxmarkdown23.0 KB
content/locales/ar-SA/portal.mdxmarkdown636 B
content/locales/ar-SA/postgres.mdxmarkdown487 B
content/locales/ar-SA/pr-visual-recap.mdxmarkdown53.9 KB
content/locales/ar-SA/privacy-and-data-rights.mdxmarkdown6.2 KB
content/locales/ar-SA/processors.mdxmarkdown8.7 KB
content/locales/ar-SA/progress.mdxmarkdown10.7 KB
content/locales/ar-SA/pure-agent-apps.mdxmarkdown5.0 KB
content/locales/ar-SA/real-time-collaboration.mdxmarkdown55.6 KB
content/locales/ar-SA/recorder.mdxmarkdown16.7 KB
content/locales/ar-SA/recurring-jobs.mdxmarkdown23.8 KB
content/locales/ar-SA/render.mdxmarkdown11.2 KB
content/locales/ar-SA/sandbox-adapters.mdxmarkdown18.0 KB
content/locales/ar-SA/security.mdxmarkdown31.5 KB
content/locales/ar-SA/server-database.mdxmarkdown27.6 KB
content/locales/ar-SA/server-middleware.mdxmarkdown7.9 KB
content/locales/ar-SA/server-overview.mdxmarkdown12.2 KB
content/locales/ar-SA/server-plugins.mdxmarkdown9.1 KB
content/locales/ar-SA/server-routes.mdxmarkdown14.3 KB
content/locales/ar-SA/sharing.mdxmarkdown28.6 KB
content/locales/ar-SA/skills-guide.mdxmarkdown27.0 KB
content/locales/ar-SA/ssr-caching.mdxmarkdown7.4 KB
content/locales/ar-SA/supabase.mdxmarkdown264 B
content/locales/ar-SA/syncing-template-changes.mdxmarkdown11.7 KB
content/locales/ar-SA/telemetry.mdxmarkdown21.9 KB
content/locales/ar-SA/template-analytics.mdxmarkdown26.4 KB
content/locales/ar-SA/template-assets.mdxmarkdown31.9 KB
content/locales/ar-SA/template-brain.mdxmarkdown29.7 KB
content/locales/ar-SA/template-calendar-agent.mdxmarkdown10.2 KB
content/locales/ar-SA/template-calendar-developers.mdxmarkdown33.4 KB
content/locales/ar-SA/template-calendar-features.mdxmarkdown14.4 KB
content/locales/ar-SA/template-calendar-integrations.mdxmarkdown6.2 KB
content/locales/ar-SA/template-calendar.mdxmarkdown4.4 KB
content/locales/ar-SA/template-chat-agent.mdxmarkdown4.7 KB
content/locales/ar-SA/template-chat-developers.mdxmarkdown31.3 KB
content/locales/ar-SA/template-chat-features.mdxmarkdown9.9 KB

content/locales/ar-SA/multi-app-workspace.mdx

View on GitHub
---
title: "مساحات عمل متعددة التطبيقات"
description: "يمكنك استضافة العديد من تطبيقات الوكيل الأصلية في monorepo واحد مع المصادقة المشتركة، وRBAC، والتعليمات، وskills، والمكونات، وبيانات الاعتماد."
---

# مساحات عمل متعددة التطبيقات

> **ما هو مستند مساحة العمل؟** تغطي هذه الصفحة **شكل النشر** — monorepo واحد، والعديد من التطبيقات، والمصادقة المشتركة والنشر الموحد. لمعرفة طبقة تخصيص الوكيل (موارد الوكيل: `AGENTS.md`، الذاكرة، skills، الوكلاء المخصصون) راجع [موارد الوكيل](/docs/agent-resources)؛ بالنسبة للحوكمة (من يراجع ويوافق ويمتلك ماذا) راجع [Workspace Governance](/docs/workspace-management).

## تطبيق مستقل أم مساحة عمل؟ {#standalone-or-workspace}

اختر مساحة عمل عندما تدير شركة عدة تطبيقات داخلية تريد مشاركة إعدادات النشر وسياق المؤسسة. اختر تطبيقا مستقلا لأداة منفردة مستقلة أو نموذج أولي. التطبيق المستقل شكل نشر مدعوم، لكنه لا يوفر إعدادات الجذر أو حزم مساحة العمل المشتركة. راجع [النشر المُدار](/docs/administered-deployments).

عندما تستغرق عملية الترميز الديناميكي لأداة داخلية فترة ما بعد الظهر، فلا تتوقف عند واحدة. ينتهي الأمر بالفريق بالحصول على CRM، وصندوق بريد وارد للدعم، ولوحة معلومات، ووحدة تحكم للعمليات - عشرة تطبيقات صغيرة، كل منها مدعوم بشكل مستقل. يعد هذا أمرًا رائعًا حتى تحتاج إلى تغيير شيء ما فيها جميعًا.

في تلك المرحلة، يكون لكل تطبيق `AGENTS.md` خاص به، ومكون إضافي للمصادقة، ومكون تخطيط نسخ ولصق خاص به، ورمز Slack المميز المشفر، وفكرته الخاصة عن ماهية "المؤسسة". تغيير قاعدة الامتثال يعني عشرة ممثلين رئيسيين. إن تدوير مفتاح API يعني عشر عمليات إعادة توزيع. تحديث العلامة التجارية يعني خروج عشرة رؤوس مختلفة عن المزامنة. الشيء الذي جعل من السهل بنائها هو الآن ما جعل من الصعب إدارتها.

نمط **مساحة عمل التطبيقات المتعددة** هو الطريقة التي يحل بها الوكيل الأصلي هذه المشكلة. يمكنك استضافة جميع تطبيقاتك في monorepo واحد إلى جانب حزمة `packages/shared` الخاصة. يمتلك الإطار الإعدادات الافتراضية الشائعة؛ `packages/shared` مخصص فقط للتعليمات البرمجية أو التعليمات أو skills أو المكونات أو تجاوزات المكونات الإضافية المخصصة حقًا لمساحة العمل الخاصة بك. يتم تقليص كل تطبيق إلى عدد قليل من الشاشات وactions التي تجعله فريدًا.

## ما تتم مشاركته {#what-gets-shared}

أي شيء يجب أن يتفق عليه كل تطبيق في مؤسستك يمكن أن يكون موجودًا في `packages/shared`:

| الشيء المشترك                 | أين يعيش                                                                                |
| ----------------------------- | --------------------------------------------------------------------------------------- |
| تجاوز المصادقة / SSO          | تصدير `authPlugin` من `src/server/index.ts`                                             |
| قواعد المؤسسة / RBAC          | مؤسسات مصادقة أفضل، متضمنة اختياريًا بواسطة `authPlugin`                                |
| تجاوز محادثة الوكيل           | تصدير `agentChatPlugin` من `src/server/index.ts`                                        |
| تعليمات وكيل المؤسسة          | `AGENTS.md`                                                                             |
| الوكيل skills                 | `.agents/skills/<skill-name>/SKILL.md`                                                  |
| الوكيل المشترك actions        | `actions/*.ts`                                                                          |
| مكونات React المشتركة         | تصدير من `src/client/index.ts`                                                          |
| رموز التصميم/العلامة التجارية | أضف ملف CSS مشتركًا واستورده من كل تطبيق                                                |
| بيانات اعتماد API المشتركة    | تفضيل بيانات الاعتماد ذات النطاق الإطاري؛ أضف مساعدين فقط إذا كنت بحاجة إلى مساحة الاسم |

يصبح كل تطبيق فردي _مجرد مجموعة من الشاشات_ - المسارات ولوحات المعلومات وطرق العرض وactions الخاصة بالمجال. تغطي الإعدادات الافتراضية لإطار العمل الباقي حتى تقوم بإضافة تخصيص حقيقي لمساحة العمل.

ينطبق هذا الحد نفسه عندما يريد تطبيقك استخدام تطبيق آخر للطرف الأول. يجب على لوحة معلومات مساحة العمل الجديدة التي تحتاج إلى البريد الإلكتروني والتقويم والتحليلات وسياق ذاكرة الشركة أن تستخدم تطبيقات البريد والتقويم والتحليلات والدماغ الحالية كجيران متصلين عبر الروابط أو A2A. ولا ينبغي لها استنساخ هذه القوالب، أو إنشاء تطبيق مجمّع يدمجها، أو دعم التطبيقات الفرعية داخل نفسها فقط للوصول إلى بياناتها أو وكلائها. لا تُنسخ نسخة من هذا التطبيق إلا عندما تريد صراحةً تخصيص هذا التطبيق.

## البدء {#getting-started}

مساحة العمل هي الشكل الافتراضي لمشروع الوكيل الأصلي. سقالة واحدة مع:

```bash
npx --yes @agent-native/core@latest create my-company-platform
```

يُظهر CLI منتقي متعدد التحديد لكل قالب طرف أول. اختر العدد الذي تريده - البريد + التقويم + النماذج، على سبيل المثال - وسيتم دمجها جميعًا في نفس مصادقة مشاركة مساحة العمل والإعدادات الافتراضية لقاعدة البيانات.

تحصل على pnpm monorepo مع الحزمة المشتركة الخاصة، و`package.json` الجذري الذي يربط اكتشاف مساحة العمل، و`.env` مشترك، ودليل فرعي واحد لكل تطبيق اخترته:

<FileTree
  id="doc-block-uekj3z"
  title={"workspace مولد"}
  entries={[
    {
      path: "package.json",
      note: "يعلن agent-native.workspaceCore",
    },
    {
      path: "pnpm-workspace.yaml",
      note: 'packages: ["packages/*", "apps/*"]',
    },
    {
      path: ".env.example",
      note: "ANTHROPIC_API_KEY و A2A_SECRET و DATABASE_URL و ... مشتركة",
    },
    {
      path: "packages/shared/",
      note: "@my-company-platform/shared",
    },
    {
      path: "packages/shared/src/server/",
      note: "plugin overrides عند الحاجة فقط",
    },
    {
      path: "packages/shared/src/client/",
      note: "React code مشترك عند الحاجة فقط",
    },
    {
      path: "packages/shared/AGENTS.md",
      note: "تعليمات على مستوى workspace",
    },
    {
      path: "apps/mail/",
    },
    {
      path: "apps/calendar/",
    },
    {
      path: "apps/forms/",
    },
  ]}
/>

ثم قم بتشغيله:

```bash
cd my-company-platform
cp .env.example .env             # املأ ANTHROPIC_API_KEY, BETTER_AUTH_SECRET,...
pnpm install
pnpm dev                         # opens Dispatch; other apps start on first visit
```

يعرف كل تطبيق بالفعل كيفية تسجيل الدخول ومشاركة نفس قاعدة البيانات وتحميل مساحة العمل `AGENTS.md`. لم تقم بتوصيل أي من ذلك - اكتشف إطار العمل تلقائيًا الحزمة المشتركة عبر حقل `agent-native.workspaceCore` في الجذر `package.json`:

```json
{
  "name": "my-company-platform",
  "agent-native": {
    "workspaceCore": "@my-company-platform/shared"
  }
}
```

## إضافة تطبيق آخر {#adding-a-new-app}

من أي مكان داخل مساحة العمل:

```bash
pnpm exec agent-native add-app
```

يعرض CLI منتقي القوالب مرة أخرى مع تصفية التطبيقات التي قمت بتثبيتها بالفعل. اختر واحدًا أو أكثر وسيتم تثبيتهم تحت `apps/`. البديل غير التفاعلي:

```bash
pnpm exec agent-native add-app crm --template content
```

يعمل أي قالب للطرف الأول كتطبيق مساحة عمل - يقوم CLI بتشغيل تحويل صغير **workspacify** على القالب الذي يضيف الحزمة المشتركة كإقلاع ويحل مراجع `workspace:*`. لا توجد سقالة موازية "لتطبيق مساحة العمل" يجب صيانتها.

```bash
pnpm install                     # at the workspace root
pnpm dev
```

هذا كل شيء. يحتوي التطبيق الجديد على نفس تعليمات تسجيل الدخول ومساحة العمل مثل أي تطبيق آخر. قم بإضافة العلامة التجارية المشتركة، actions، أو بيانات الاعتماد فقط عندما تحتاج مساحة العمل إليها فعليًا.

## ما قمت بتجاوزه حيث {#layering}

تعمل التطبيقات الأصلية للوكيل داخل مساحة العمل على حل السلوك الشامل من ثلاثة أماكن، بهذا الترتيب:

1. **التطبيق المحلي** — الملفات الموجودة داخل `apps/<name>/` (الأولوية العليا)
2. **مساحة العمل المشتركة** — الملفات الموجودة داخل `packages/shared/` (الطبقة المتوسطة المشتركة)
3. **الإطار الافتراضي** — `@agent-native/core` (الأدنى)

يتم الدمج حسب اسم الملف. إذا كان التطبيق يوفر ملفًا محليًا موجودًا أيضًا في المنبع، فسيفوز الملف المحلي. إذا لم يحدث ذلك، فسيتم تطبيق الإصدار المشترك لمساحة العمل. إذا لم توفر المشاركة واحدًا أيضًا، فسيتم تفعيل إطار العمل الافتراضي. وينطبق هذا على المكونات الإضافية، skills، وactions، و`AGENTS.md`.

<Diagram id="doc-block-ydy60h" title={"ثلاث طبقات، مدمجة حسب اسم الملف"} summary={"يحل كل تطبيق المكونات الإضافية والمهارات والإجراءات وAGENTS.md من التطبيق المحلي أولاً، ثم الحزمة المشتركة، ثم إطار العمل الافتراضي."}>

```html
<div class="layer">
  <div class="diagram-card accent">
    <span class="diagram-pill accent">1 &middot; App local</span
    ><small class="diagram-muted"
      ><code>apps/&lt;name&gt;/</code> &mdash; highest priority</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
  <div class="diagram-card">
    <span class="diagram-pill">2 &middot; Workspace shared</span
    ><small class="diagram-muted"
      ><code>packages/shared/</code> &mdash; the mid-layer</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&darr;</div>
  <div class="diagram-card">
    <span class="diagram-pill">3 &middot; Framework default</span
    ><small class="diagram-muted"
      ><code>@agent-native/core</code> &mdash; lowest</small
    >
  </div>
  <div class="diagram-arrow diagram-accent" aria-hidden="true">&darr;</div>
  <div class="diagram-box ok">first match wins</div>
</div>
```

```css
.layer {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 6px;
}
.layer .diagram-card {
  display: flex;
  flex-direction: column;
  gap: 3px;
  padding: 12px 16px;
  width: 320px;
}
.layer .diagram-arrow {
  font-size: 18px;
  line-height: 1;
}
.layer .diagram-box {
  margin-top: 2px;
}
```

</Diagram>

عندما يحتاج أحد التطبيقات إلى شيء مختلف، قم بإسقاط ملف محلي:

| شيء يجب تجاوزه                  | الملف المطلوب إنشاؤه داخل التطبيق                    |
| ------------------------------- | ---------------------------------------------------- |
| ملحق المصادقة                   | `apps/<name>/server/plugins/auth.ts`                 |
| البرنامج المساعد للدردشة الوكيل | `apps/<name>/server/plugins/agent-chat.ts`           |
| مهارة محددة                     | `apps/<name>/.agents/skills/<skill-name>/SKILL.md`   |
| إجراء محدد                      | `apps/<name>/actions/<action-name>.ts`               |
| تعليمات الوكيل الإضافية         | `apps/<name>/AGENTS.md` (يدمج مع مساحة العمل الأولى) |

لا توجد أسلاك ولا تكوين. أنشئ الملف وسيتولى الأمر.

## تحرير السلوك المشترك {#editing-shared-behavior}

كل شيء شامل يمكنك تخصيصه للحياة في `packages/shared/`. قم بتصدير `authPlugin` من `src/server/index.ts` وسيلتقطه كل تطبيق في عملية إعادة التحميل التالية للمطور. أضف مهارة ضمن `.agents/skills/` وسيراها وكيل كل تطبيق. أضف إجراءً إلى `actions/` ويمكن لكل وكيل تطبيق الاتصال به.

نظرًا لأن الحزمة المشتركة هي تبعية `workspace:*`، يقوم pnpm بربطها في `node_modules/` لكل تطبيق. لا يمكنك إنشاءه أو نشره أبدًا - فالتطبيقات تجمع كل ما تحتاج إليه منه في وقت الإنشاء.

## الموارد العالمية لوقت التشغيل {#runtime-global-resources}

استخدم `packages/shared` للإعدادات الافتراضية على مستوى التعليمات البرمجية التي يجب أن تأتي مع الريبو: المكونات الإضافية، وactions المشتركة، ورمز React المشترك، ونظام الملفات `AGENTS.md`، ونظام الملفات skills. استخدم موارد مساحة عمل Dispatch للسياق العام القابل للتحرير في وقت التشغيل والذي يرغب المسؤولون في إدارته دون تغيير التعليمات البرمجية.

يتم تحديد نطاق موارد الإرسال **جميع التطبيقات** (يرثها كل تطبيق في وقت التشغيل، بدون خطوة النسخ أو المزامنة) أو **التطبيقات المحددة** (تُمنح لكل تطبيق لسياق خاص بالتطبيق). راجع [موارد الوكيل](/docs/agent-resources#global-resources) للحصول على جدول نموذج الموارد الكامل واصطلاحات المسار وحزمة البداية الموصى بها.

## المصادقة وRBAC {#auth-and-rbac}

يأتي كل تطبيق أصلي للوكيل مزودًا بالفعل بـ [Better Auth](/docs/authentication) بالإضافة إلى نظام التنظيم المدمج في إطار العمل. وفي مساحة العمل، يمكنك الحصول على ذلك مجانًا في كل تطبيق، مدعومًا بقاعدة البيانات نفسها. للحصول على نموذج الإيجار المتعدد الكامل - المؤسسات والأدوار وعزل البيانات - راجع [Multi-Tenancy](/docs/multi-tenancy).

بالنسبة للقواعد الخاصة بالمؤسسة (نطاقات القائمة المسموح بها، فرض SSO، عمليات التحقق من الأدوار الإضافية)، قم بتصدير `authPlugin` من `packages/shared/src/server/index.ts`. يفرض كل تطبيق في مساحة العمل الآن هذه القواعد.

يتدفق التنظيم النشط تلقائيًا: `session.orgId` → `AGENT_ORG_ID` → SQL نطاق الصف، لذا فإن البيانات التي تم وضع علامة عليها بـ `org_id` تكون غير مرئية للمؤسسات الأخرى حتى للوكيل. راجع [Security & Data Scoping](/docs/security) للاطلاع على النموذج الكامل.

## التطبيقات المدمجة {#builtin-apps}

افتراضيًا، يمكن لكل مساحة عمل الوصول إلى تطبيقات الطرف الأول المستضافة (Mail وCalendar وContent وDesign وClips وغيرها) بوصفها وكلاء مدمجين. اختر التطبيقات التي تقدمها مساحة العمل باستخدام `agent-native.builtinAgents` في ملف `package.json` الجذري:

```json
{
  "agent-native": {
    "workspaceCore": "@my-company-platform/shared",
    "builtinAgents": {
      "mode": "selected",
      "include": ["mail", "calendar", "design"],
      "urls": {
        "design": "https://design.example.test"
      }
    }
  }
}
```

- `mode`: القيمة `"all"` (الافتراضية، كل تطبيقات الطرف الأول العامة)، أو `"none"` (بلا تطبيقات مدمجة)، أو `"selected"` (ما في `include` فقط).
- `include`: التطبيقات المدمجة التي تقدمها مساحة العمل عندما تكون قيمة `mode` هي `"selected"`. تبقى التطبيقات الأخرى غير معروفة لمساحة العمل.
- `urls` (اختياري): يربط معرّفات التطبيقات المدمجة بعناوين أساسية عبر HTTPS للتطبيقات المقدمة، دون تغيير قائمة الوكلاء. يتجاوز عنوان الاستضافة الأساسي، بما في ذلك البيان المُسبق الإضافة الذي ما زال يستخدم العنوان الافتراضي، مع بقاء الأولوية لعناوين URL المخصصة للوكلاء البعيدين المتصلين وتطبيقات مساحة العمل. يؤدي وجود معرّف غير معروف أو عنوان URL غير صالح إلى فشل التحليل. يجب أن تكون كل قيمة عنوان HTTPS مطلقًا ومنقحًا بلا بيانات اعتماد أو استعلام أو جزء. يظل توجيه التطوير المحلي ذا الأولوية ويستخدم العناوين المحلية.

تُسجَّل المعرّفات غير المعروفة في `include` كتحذير ويتم تجاهلها. يمكن للتطبيق المستقل استخدام المفتاح نفسه في ملف `package.json` الخاص به. يمرر `agent-native dev` وعمليات نشر مساحة العمل القيمة إلى كل تطبيق عبر `AGENT_NATIVE_BUILTIN_AGENTS_JSON`.

يتحكم هذا الإعداد في قائمة التطبيقات واكتشاف الوكلاء والاستدعاءات بين الوكلاء. تحتفظ تطبيقات مساحة العمل المثبّتة وعناوين URL المخصصة للوكلاء البعيدين المتصلين بأولويتها، ويظل الوصول إلى تطبيقات MCP إذن توجيه منفصلًا.

في Dispatch، يمكن لمالكي المؤسسة ومسؤوليها أيضًا إخفاء التطبيقات المضمّنة المعروضة من الإعدادات › المؤسسة › التطبيقات (أو باستخدام `set-hosted-apps-settings`). يزيلها ذلك من قوائم تطبيقات Dispatch ومن سياق التطبيقات لدى وكيله على مستوى المؤسسة؛ ويظل `call-agent` بالاسم يصل إليها. وبدون مؤسسة لا توجد صفحة إعدادات لذلك، فلا يستطيع تغييره إلا الوكيل، ولذلك المستخدم فقط.

## خوادم MCP المشتركة {#shared-mcp}

الخيارات الموصى بها لمشاركة خوادم MCP عبر تطبيقات مساحة العمل، حسب التفضيل:

1. **إرسال موارد MCP لمساحة العمل** — أضف موارد `mcp-servers/<name>.json` في Dispatch في نطاق **جميع التطبيقات**. يرث كل تطبيق في مساحة العمل خادم MCP في وقت التشغيل دون الحاجة إلى إجراء تعديلات على الملفات أو إعادة نشرها. منح للتطبيقات المحددة فقط عندما يكون الخادم خاصًا بالتطبيق. الرموز موجودة في قبو الإرسال؛ يمكنك الرجوع إليها من المورد JSON باستخدام `${keys.NAME}`.

2. **Root `mcp.config.json`** — قم بإسقاط ملف في جذر مساحة العمل وسيتصل كل تطبيق في مساحة العمل بنفس خوادم MCP. يمكن للتطبيقات الفردية تجاوز `mcp.config.json` الخاصة بها (فوز جذر التطبيق). استخدم هذا لخوادم MCP المحلية/نظام الملفات (`@modelcontextprotocol/server-filesystem`، `claude-in-chrome`، Playwright) التي لا تحتاج إلى بيانات اعتماد مخزن لكل مستخدم.

3. **إعدادات UI (النطاق الشخصي/المؤسسي)** — لخوادم HTTP MCP البعيدة، يمكن للمستخدمين إضافتها من الإعدادات UI في النطاق الشخصي أو الفريق (org) — لا توجد تعديلات على الملفات، ويتم إعادة تحميلها بسرعة في الوكيل قيد التشغيل.

راجع [MCP Clients](/docs/mcp-clients) للتعرف على مخطط التكوين وقواعد الأسبقية وإعداد المحور.

## متغيرات البيئة المشتركة {#shared-env}

The workspace root `.env` is loaded into every app automatically for deployment-level configuration such as `A2A_SECRET`, `BETTER_AUTH_SECRET`, and `DATABASE_URL`. User, org, and workspace API keys should be saved as scoped DB secrets instead of being written into `.env`. Per-app deploy-time overrides can still go in `apps/<name>/.env` and win on conflict.

بالنسبة لبيانات اعتماد تطبيق وقت التشغيل، تفضل Dispatch vault على تحرير ملفات `.env` يدويًا. يتم تعيين الوصول الافتراضي للمخزن إلى جميع التطبيقات، لذلك يكون كل مفتاح مخزن محفوظ متاحًا لكل تطبيق مساحة عمل يشارك قاعدة بياناته. قم بتبديل المخزن إلى الوضع اليدوي فقط عندما تحتاج التطبيقات إلى منح صريحة لكل مفتاح.

```text
my-company-platform/
├── .env                           # shared: ANTHROPIC_API_KEY=... , A2A_SECRET=... , ...
└── apps/
    └── mail/
        └── .env                   # optional overrides just for mail
```

هناك عدد قليل من عمليات الإعداد التي تكون جاهزة للاستخدام في مساحة العمل:

- **Builder OAuth**: clicking "استخدم Builder.io" authorizes the signed-in user with the least-privilege `builder:ai:invoke` scope and stores the token in encrypted per-user custody. Legacy Builder keys remain available only to existing uncovered integrations.
- **Compatibility key route** (`POST /_agent-native/env-vars`): older onboarding forms still call this route name, but it now saves values as scoped DB secrets. Pass `scope: "workspace"` to share with the active org, or omit it for a per-user key.

## بيانات الاعتماد المشتركة {#shared-credentials}

تشير التطبيقات الموجودة في نفس مساحة العمل إلى نفس `DATABASE_URL` بشكل افتراضي، لذلك يمكن لتخزين بيانات اعتماد إطار العمل إتاحة بيانات الاعتماد لكل تطبيق دون تكوين لكل تطبيق. استخدم `@agent-native/core/credentials` مباشرة، أو قم بإضافة مساعد رفيع في `packages/shared` إذا كانت مساحة العمل الخاصة بك تريد اصطلاح تسمية أكثر صرامة.

## التطبيق الافتراضي عند `/` {#default-app}

يفتح `/` تطبيق Dispatch إذا كانت مساحة العمل تحتوي على تطبيق `dispatch`، وإلا فيفتح أول تطبيق. اضبط `WORKSPACE_DEFAULT_APP=<app-id>` لفتح تطبيق مختلف. يقرأه كل من `agent-native dev` وعمليات نشر مساحة العمل من بيئة العملية أولًا، ثم من ملف `.env` في جذر مساحة العمل؛ ويتم تجاهل أي قيمة لا تطابق أي تطبيق. تقرأه عمليات النشر وقت البناء، لذا اضبطه في المكان الذي تبني منه. يحتفظ Dispatch بإعادة التوجيه الخاصة به `/dispatch`، ولا يزال `deployment.workspace.rootPage: "directory"` يعرض قائمة التطبيقات.

## رموز التصميم المشتركة {#design-tokens}

إطار العمل موجود على Tailwind v4. قم بإضافة ملف CSS مشترك إلى `packages/shared` فقط عندما تحتوي مساحة العمل على رموز مميزة للعلامة التجارية الحقيقية لمشاركتها، ثم قم باستيراده من `app/global.css` لكل تطبيق:

```css
@import "tailwindcss";
@import "@my-company-platform/shared/styles/tokens.css";
@source "./**/*.{ts,tsx}";

:root {
  --background: 0 0% 100%; /* ...brand tokens... */
}
.dark {
  --background: 220 6% 6%; /* ... */
}
```

يمكن أن توجد ألوان العلامة التجارية والطباعة ومقاييس التباعد وأي فئات مكونات مشتركة في ملف CSS هذا. قم بتحديثه في `packages/shared` وسيتم تغيير العلامة التجارية لكل تطبيق في الإصدار التالي.

## النشر {#deployment}

أمامك خياران: **النشر الموحد** (الإعداد الافتراضي لمساحات العمل) أو النشر المستقل لكل تطبيق.

### النشر الموحد (مستحسن)

ينشئ أمر واحد كل تطبيق في مساحة العمل ويشحنه خلف أصل واحد، ومسار واحد لكل تطبيق:

```bash
npx @agent-native/core@latest deploy
# https://your-agents.com/mail/*       → apps/mail
# https://your-agents.com/calendar/*   → apps/calendar
# https://your-agents.com/forms/*      → apps/forms
```

يُبنى كل تطبيق باستخدام `APP_BASE_PATH=/<name>` و`VITE_APP_BASE_PATH=/<name>` ويُصدَر عبر إعداد Nitro المحدد. **Netlify** هو الإعداد المسبق الافتراضي لأمر `deploy` الموحد؛ فهو يصدر وظائف التطبيق ضمن `.netlify/functions-internal/<app>-server` وينشئ عمليات إعادة توجيه تترك الأصول الثابتة غير قسرية بحيث يخدم CDN الملفات أولاً. **Vercel** مدعوم بـ `npx @agent-native/core@latest deploy --preset vercel`؛ فهو يكتب حزمة `.vercel/output` الجذرية باستخدام Build Output API من Vercel.

<Diagram id="doc-block-1huoqdg" title={"النشر الموحد: أصل واحد ومسار واحد لكل تطبيق"} summary={"يأتي كل تطبيق من مصدر واحد، لذا فإن جلسات تسجيل الدخول والتطبيقات المشتركة A2A مجانية."}>

```html
<div class="deploy">
  <div class="diagram-box accent">
    your-agents.com<br /><small class="diagram-muted"
      >one DNS record &middot; one cert &middot; one CDN</small
    >
  </div>
  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
  <div class="deploy-apps">
    <div class="diagram-box">/mail/*</div>
    <div class="diagram-box">/calendar/*</div>
    <div class="diagram-box">/forms/*</div>
  </div>
  <div class="diagram-pill ok">
    shared login cookie on the apex &bull; same-origin A2A, no CORS
  </div>
</div>
```

```css
.deploy {
  display: flex;
  align-items: center;
  gap: 14px;
  flex-wrap: wrap;
}
.deploy .deploy-apps {
  display: flex;
  flex-direction: column;
  gap: 8px;
}
.deploy .diagram-arrow {
  font-size: 24px;
}
.deploy .diagram-pill {
  flex-basis: 100%;
}
```

</Diagram>

التواجد على **نفس الأصل** هو المكان الذي تعيش فيه المكافأة الحقيقية:

- **جلسة تسجيل الدخول المشتركة.** تقوم Better Auth بتعيين ملف تعريف الارتباط الخاص بها على المجال الرئيسي، لذا فإن تسجيل الدخول إلى أي تطبيق يؤدي إلى تسجيل دخولك إلى كل تطبيق. لا توجد رقصة SSO عبر النطاقات.
- **A2A عبر التطبيقات ذات التكوين الصفري.** يصبح وضع علامات `@mail` على `@calendar` جلبًا من نفس المصدر — بدون CORS، ولا يوجد توقيع JWT بين الأشقاء. لا يزال A2A الخارجي يستخدم JWT كما هو الحال اليوم.
- **سجل DNS واحد، وشهادة واحدة، وذاكرة تخزين مؤقت CDN واحدة.**

انشر مخرجات البناء لمنصتك:

```bash
npx @agent-native/core@latest deploy
netlify deploy --prod --dir=dist --functions=.netlify/functions-internal
```

لـ Netlify:

```bash
npx @agent-native/core@latest deploy --preset netlify --build-only
```

بالنسبة لعمليات نشر Vercel Git، قم بتعيين أمر الإنشاء على:

```bash
npx @agent-native/core@latest deploy --preset vercel --build-only
```

### مسارات التطبيقات العامة

تعتبر تطبيقات مساحة العمل داخلية بشكل افتراضي. بالنسبة إلى موقع عام يحتوي على صفحات إدارية لتسجيل الدخول فقط، قم بتعيين جمهور عام وحماية بادئة المسؤول في `package.json` لهذا التطبيق:

```json
{
  "agent-native": {
    "workspaceApp": {
      "audience": "public",
      "protectedPaths": ["/admin"]
    }
  }
}
```

بالنسبة للتطبيقات الداخلية في الغالب والتي تحتوي على عدد قليل من الصفحات العامة، اترك الجمهور داخليًا وبادئات صفحة القائمة:

```json
{
  "agent-native": {
    "workspaceApp": {
      "publicPaths": ["/", "/share"]
    }
  }
}
```

تؤثر هذه الإعدادات فقط على التنقل في الصفحة للقراءة فقط. تظل أدوات إطار العمل، ودردشة الوكيل، وA2A، والوصول إلى المخزن، وAPIs التعسفية مصادق عليها ما لم يعلن التطبيق صراحة عن البادئات العامة باستخدام `createAuthPlugin({ publicPaths: [...] })`.

### النشر المستقل لكل تطبيق

هل تفضل كل تطبيق في نطاقه الخاص (`mail.company.com`، `calendar.company.com`)؟ لا يزال كل تطبيق في مساحة العمل قابلاً للنشر بشكل مستقل — يتصرف `cd apps/mail && pnpm build` تمامًا مثل السقالة المستقلة. يمر A2A عبر التطبيق بعد ذلك عبر المسار القياسي الموقع بـ JWT مع `A2A_SECRET` المشترك. تتم معالجة SSO عبر المجال بين التطبيقات المنشورة بشكل منفصل عن طريق اتحاد الهوية مع Dispatch كمحور - راجع [Cross-App SSO](/docs/cross-app-sso)؛ يتجنب النشر الموحد ذو الأصل الواحد الحاجة إليه.

### قاعدة بيانات مشتركة، بيانات اعتماد مشتركة

لمشاركة حسابات المستخدمين والمؤسسات والإعدادات والبيانات الأخرى بين التطبيقات، وجّه كل تطبيق إلى `DATABASE_URL` نفسه. أثناء التطوير المحلي، عيّنه في ملف `.env` بجذر مساحة العمل كي تستخدم كل التطبيقات قاعدة بيانات PostgreSQL نفسها. إذا لم يُعيّن، فسيستخدم كل تطبيق قاعدة بيانات PGlite خاصة بعمليته، لذلك لن تتم مشاركة المستخدمين والمؤسسات.

يتراكم طلب الاتصالات بين العمليات التي تستخدم قاعدة البيانات نفسها. إذا استخدمت خمس عمليات تطبيق Node.js طويلة العمر مجمعًا مشتركًا واحدًا لكل منها على `DATABASE_URL` نفسه، فقد تستخدم ما يصل إلى 100 اتصال عند الحد الافتراضي البالغ 20 اتصالًا لكل مجمع (`5 × 1 pool × 20`). وفي مساحات العمل عديمة الخادم، قدّر عدد مثيلات الوظائف الدافئة لكل تطبيق باستخدام الحدود الافتراضية الخاصة ببيئة التشغيل. راجع [قاعدة بيانات الخادم](/docs/server-database) لإعداد `AGENT_NATIVE_DB_POOL_MAX` وإرشادات تقدير الميزانية الكاملة.

لا يتم نشر الحزمة المشتركة نفسها بشكل مستقل أبدًا. إنه قسم `workspace:*` الذي يرتبط pnpm به في `node_modules/` لكل تطبيق، بحيث يقوم كل تطبيق بتجميع كل ما يحتاج إليه بشفافية في وقت الإنشاء.

## خارج النطاق (في الوقت الحالي) {#out-of-scope}

نمط مساحة العمل ضيق عن عمد. بعض الأشياء التي لم يتعامل معها عمدًا حتى الآن:

- **خزنة بيانات الاعتماد المشفرة.** تفضل مخزن الإرسال لبيانات اعتماد تطبيقات وقت التشغيل (راجع [Shared environment variables](#shared-env)). المسار الاحتياطي غير المخزن - بيانات الاعتماد المشتركة المكتوبة مباشرة في جدول إطار العمل `settings` - يخزنها كنص عادي اليوم، لذا قم بالتدوير بشكل مسؤول عند الاعتماد عليها.
- **نشر التعليمات البرمجية المشتركة إلى npm الخاص.** الحزمة المشتركة هي `workspace:*` فقط؛ تعد مشاركة عمليات الريبو المتعددة عبر سجل خاص أمرًا ممكنًا، ولكنها ليست مدعومة.
- **مكتبة المكونات ذات الرأي.** `packages/shared` هو المكان الذي تضع فيه المكونات المشتركة. لا يفرض إطار العمل shadcn/ui أو أي نظام آخر على تلك الفتحة.

## انظر أيضًا {#see-also}

- [موارد الوكيل](/docs/agent-resources) — طبقة التخصيص (`AGENTS.md`، `LEARNINGS.md`، الذاكرة الشخصية، skills، الوكلاء المخصصون) يشاركها كل تطبيق في مساحة العمل.
- [Workspace Governance](/docs/workspace-management) — التفرع، CODEOWNERS، مراجعة العلاقات العامة عبر العديد من التطبيقات في مستودع واحد.
- [Multi-Tenancy](/docs/multi-tenancy) — المؤسسات، والأدوار، وعزل البيانات لكل مؤسسة.
- [Cross-App SSO](/docs/cross-app-sso) — اتحاد الهوية لعمليات نشر المجال المنفصل.
- [Dispatch](/docs/dispatch) — مستوى التحكم في وقت التشغيل الذي يوجد عادةً داخل مساحة عمل متعددة التطبيقات مثل مخزن الأسرار وكتالوج التكامل ومركز الموافقات.
rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).Stars: 198kUpdated Claude CodeCodexUnverifiedInstall
doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.Stars: 198kUpdated Claude CodeCodexVerifiedInstall