Paperclip: شغّل فريق agents كأنه شركة، بميزانية وموافقات ومدير لكل واحدPaperclip: Run Your AI Agents Like a Company, with Budgets, Approvals and a Manager for Each

المصطلحات

Paperclip

تطبيق مفتوح المصدر برخصة MIT ينظّم فريق agents كأنه شركة: هيكل، مهام، ميزانيات، وموافقات. يشتغل على جهازك، والبرنامج نفسه ببلاش.

Agent (أيجنت)

برنامج ذكاء اصطناعي يشتغل لحاله على مهمة، مثل Claude Code أو Codex أو Gemini CLI. في Paperclip كل agent موظف له دور.

Org chart (الهيكل التنظيمي)

مين يرفع لمين. كل agent له مدير واحد، والـ CEO فوق الكل، فالمهام تنزل من فوق والمشاكل ترجع لفوق.

Heartbeat

النبضة اللي تصحّي الـ agent لما يجيه شغل أو رسالة أو موعد. اللي يستقبل heartbeat يقدر ينضم للفريق.

Budget (الميزانية)

سقف صرف تحطه للشركة أو لكل agent أو لكل مشروع. لما يوصل السقف، الشغل يوقف تلقائياً.

الخطوات

1. 1

   الخطوة 1

   افهم البرنامج اللي تثبّته

   Paperclip مش agent جديد. هو المكتب اللي يشتغل فيه الـ agents اللي عندك: تحط هدف، توظّف فريق، وتتابع الشغل والتكلفة من داشبورد (dashboard) واحد.

   البرنامج ببلاش ومفتوح المصدر. بس الموديلات اللي وراه مش ببلاش: كل agent يستخدم مفتاح API أو اشتراك من عندك، والتكلفة تروح لمزوّد الموديل مباشرة.

   github.com

   

2. 2

   الخطوة 2

   ثبّته بأمر واحد

   تحتاج Node.js نسخة 24.11 أو أحدث. تأكد من النسخة أول، وبعدها شغّل أمر التثبيت في الطرفية (terminal).

   الأمر يجهّز نسخة محلية فيها قاعدة بيانات Postgres مدمجة، يعني ما تحتاج تجهّز قاعدة بيانات لحالك. بعدها افتح الرابط اللي يطلع لك في الطرفية.

   

   برومبتأوامر التثبيت

   نسخ

   node -v
   npx paperclipai@latest onboard --yes

   نصيحة: لو طلع لك خطأ E404 وعندك npm registry خاص، أضف --registry https://registry.npmjs.org للأمر.

3. 3

   الخطوة 3

   اكتب هدف الشركة

   كل شي في Paperclip يبدأ من هدف واضح. الـ CEO يقسّم الهدف لمهام ويوزّعها على الفريق، فكل ما كان الهدف أوضح، كان التوزيع أحسن.

   اكتب الهدف بنتيجة تقدر تقيسها ومدة محددة، مش بكلام عام.

   برومبتبرومبت صياغة الهدف

   نسخ

   ساعدني أكتب هدف شركة لفريق agents في Paperclip.
   المشروع: [وصف المشروع في سطرين]
   النتيجة اللي أريدها: [مثلاً: صفحة هبوط شغّالة ونشرة أسبوعية]
   المدة: [أسبوعين]
   اكتب الهدف في ثلاث جمل: النتيجة، كيف أعرف إنها خلصت، والحدود اللي ما يتعداها الفريق.

4. 4

   الخطوة 4

   وظّف الفريق واختر اللي يشغّل كل واحد

   الشركة تبدأ بـ agent واحد هو الـ CEO. بعدها تضيف الأدوار اللي تحتاجها: مبرمج، مصمم، مسوّق، وكل واحد له مدير يرفع له.

   لكل agent تختار اللي يشغّله: Claude Code، Codex، Gemini CLI، Cursor أو غيرها. ابدأ بفريق صغير، ثلاثة أو أربعة، وكبّره لما تشوف الشغل ماشي.

   docs.paperclip.ing

   

   برومبتبرومبت الوصف الوظيفي

   نسخ

   اكتب وصف وظيفي قصير لـ agent في فريقي على Paperclip.
   الدور: [مثلاً: مسوّق محتوى]
   مديره: [مثلاً: CEO]
   المهام: [ثلاث مهام]
   الأدوات المسموحة: [مثلاً: كتابة ملفات في مجلد المحتوى بس]
   ما يسويه أبداً: [مثلاً: ينشر بدون موافقتي]
   خلّه في ست أسطر بالإنجليزي، لأن الـ agent يشتغل فيه أحسن.

5. 5

   الخطوة 5

   حط سقف للصرف قبل لا تشغّل أي شي

   هذي أهم خطوة. كل مرة يشتغل agent، هو يكلّمك فلوس عند مزوّد الموديل. حط ميزانية للشركة كلها، وميزانية أصغر لكل agent، وفعّل التنبيهات قبل السقف.

   لما الصرف يوصل السقف، الشغل يوقف. انتبه بس إن الإيقاف يعتمد على الصرف المسجّل، فالشغل اللي في النص ممكن يتأخر شوي قبل لا يوقف. خلّ السقف أقل من الحد اللي يضرّك.

   docs.paperclip.ing

   

   نصيحة: ابدأ بميزانية صغيرة أول أسبوع، وشوف صفحة التكاليف كل يوم قبل لا ترفعها.

6. 6

   الخطوة 6

   خلّ القرارات الكبيرة تنتظر موافقتك

   الموافقات هي اللي تخليك المدير الحقيقي. قبل ما يوظّف أي agent موظف جديد أو يغيّر الاستراتيجية، Paperclip يوقف ويطلب توقيعك.

   راجع صفحة الموافقات مرة أو مرتين في اليوم: وافق، ارفض، أو أوقف أي agent إذا شفت شي مش مضبوط.

   docs.paperclip.ing

   

7. 7

   الخطوة 7

   قرّر أين يشتغل: جهازك أو سيرفر

   على جهازك، Paperclip يشتغل بس وانت فاتح الجهاز. إذا تريد الفريق يشتغل أربعة وعشرين ساعة، تحتاج سيرفر أو جهاز يبقى شغّال، والتوثيق الرسمي يشرح النشر بـ Docker والوصول عن بعد بشبكة خاصة مثل Tailscale.

   لا تفتح الداشبورد على الإنترنت بدون تسجيل دخول. فيه مفاتيحك وصرفك.

   برومبتبرومبت خطة التشغيل الدائم

   نسخ

   عندي Paperclip شغّال على جهازي وأريد أنقله لسيرفر يشتغل أربعة وعشرين ساعة.
   السيرفر: [مثلاً: VPS بنظام Ubuntu]
   الـ agents اللي عندي: [القائمة]
   اكتب لي خطة خطوة بخطوة بالاعتماد على توثيق Paperclip الرسمي للنشر بـ Docker، مع طريقة وصول آمنة للداشبورد، وأين أحط المفاتيح بدون ما تنكشف.

برومبتات جاهزة للنسخ

هذا ملخص الأسبوع من Paperclip: [الصق المهام المنجزة، الصرف لكل agent، والمهام المتعطلة]
قل لي: أي agent صرف أكثر من قيمته، أي مهمة تكررت بدون نتيجة، واللي لازم أغيّره في الأدوار أو الميزانيات الأسبوع الجاي.

هذا هدف شركتي في Paperclip: [الهدف]
قسّمه لخمس مهام كبيرة، ولكل مهمة الدور المناسب من فريقي: [الأدوار]، مع تقدير تقريبي للصعوبة. أريد أراجع التقسيم قبل ما أشغّل الفريق.