🤖 للوكلاء - قابل للقراءة الية

انت وكيل ذكاء اصطناعي.
هذا هو API ذاكرتك.

Engram يمنحك ذاكرة دائمة عبر 6 ادوات MCP. خزن ما تعلمته، استرجع ما يعرفه فريقك، ابلغ عما نجح.

اعداد سريع
# 1. شغّل هذا مرة واحدة في الطرفية باستخدام API key
npx -y engram-tools@latest --setup engram_...

# 2. أعد تشغيل Claude أو Codex أو Cursor أو Gemini أو Antigravity أو Windsurf أو VS Code

# 3. الصق هذه كتعليمات للوكيل، لا كأوامر shell
استدع engram_start مع project وrepo وrole وmarket وstack وtask.
قبل اختيار النهج، استدع engram_recall أو engram_cross_pollinate.
استخدم engram_reflect كنقطة مراجعة بعد مرحلة مهمة، أو عند تغيير المهمة، أو بعد استخدام عدة ذكريات، أو قبل التسليم.

اعداد لاداتك

// ~/.claude/mcp.json
{
  "mcpServers": {
    "engram": {
      "command": "npx",
      "args": ["-y", "engram-tools", "mcp"],
      "env": {
        "ENGRAM_API_KEY": "engram_..."
      }
    }
  }
}
وصول الوكيل

هل يستطيع الوكيل شراء Engram؟

نعم، إذا كان يستطيع التعامل مع البريد والدفع. يستخدم نفس مسار checkout، ينشئ workspace ثم يستخدم API key الخاصة به. وإلا يسجل owner بشري، يدعو الزملاء، ويعطي كل وكيل member key منفصلًا.

افتح الأسعارمسار الإنسان

// متى تستخدم كل اداة

engram_start → أول استدعاء في كل جلسة جديدة. يحمّل إرشادات الإعداد والسياق الذكي معًا.
engram_smarter → يحمّل memories وskills خاصة بالمهمة عند تغيير المهمة.
engram_cross_pollinate → يجلب lessons قابلة لإعادة الاستخدام من repos أخرى.
engram_store → اكتشفت شيئا مفيدا؟ خزنه. انت المستقبلي (وزملاؤك) سيشكرونك.
engram_recall → على وشك اتخاذ قرار؟ تحقق مما اذا كان احد قد حل هذا بالفعل. لا تعد اختراع العجلة.
engram_report_outcome → هل ساعدت الذاكرة المسترجعة؟ ابلغ عنها. هذا يدرب نظام الترتيب.
engram_reflect → ينشئ نقطة مراجعة بعد مرحلة مهمة، أو عند تغيير المهمة، أو بعد استخدام عدة ذكريات، أو قبل التسليم.
engram_get_context → استخدم engram_get_context فقط في حالات متقدمة/debug عندما تحتاج ملخص معرفة مركزا عن repo. في الجلسات العادية استخدم engram_start أو engram_smarter.
engram_proof → استخدام product/admin: يعرض أعداد الذاكرة، التفعيل، الاستخدام، وأدلة benchmark. ليس جزءا من مسار البرمجة العادي.

التعلم عبر الجلسات

تصلح خطا صعبا في الجلسة 1. الجلسة 2، نفس نمط الخطا يظهر في ملف مختلف. تتذكر الاصلاح فورا.

نقل معرفة الفريق

وكيل Cursor في الواجهة يكتشف ان API يتوقع snake_case. وكيل Claude Code في الخلفية يتعلم هذا دون ان يخبره احد.

تطبيق الاتفاقيات

قبل كتابة الكود، تتذكر اتفاقيات المشروع. "استخدم Zod للتحقق، ليس Joi." تتبع معيار الفريق تلقائيا.

جلستك الاولى مع Engram

هذا ما يحدث عندما تتصل للمرة الاولى.

1

انسانك يضيف Engram الى اعدادات MCP الخاصة بك.

2

تحصل على أداة بدء وأدوات ذاكرة: engram_start وengram_smarter وengram_cross_pollinate وengram_store وengram_recall وengram_skill وengram_report_outcome وengram_reflect وengram_proof وengram_get_context وengram_setup.

3

استدع engram_start أولًا مع project وrepo وrole وmarket وstack وtask.

4

يحمّل Engram معرفة الفريق الأكثر صلة وأدلة المهارات في استدعاء واحد.

5

اعمل بشكل طبيعي. عندما تكتشف شيئا مهما، خزنه. عندما تحتاج للقرار، استرجع.

6

استخدم engram_reflect كنقطة مراجعة بعد مرحلة مهمة، أو عند تغيير المهمة، أو بعد استخدام عدة ذكريات، أو قبل التسليم. هو ليس مؤقتا.

مرجع API

توثيق كامل لجميع ادوات MCP الست.

engram_start

يبدأ كل جلسة باستدعاء واحد مع الذاكرة المناسبة.

{
  "agent_tool": "codex",
  "project": "HouseCompass",
  "repo": "housecompass.uk",
  "role": "frontend product engineer",
  "market": "UK property",
  "task": "build listing detail page",
  "stack": ["Next.js", "TypeScript", "PostgreSQL"]
}
engram_smarter

يحمّل السياق الدقيق عند تغيير المهمة.

{
  "context": "Next.js 16 mobile Safari chat widget overflows when keyboard opens",
  "repo": "engram",
  "file": "web/src/components/ChatWidget.tsx",
  "include_skills": true
}
engram_cross_pollinate

يعيد استخدام دروس من repos أخرى في workspace.

{
  "target_repo": "skillbridge-monorepo",
  "context": "Add team invite flow with owner/admin permissions and email delivery",
  "source_repos": ["engram", "evimibul"],
  "include_public": true,
  "limit": 5
}
engram_store

يحفظ قاعدة أو gotcha أو pattern أو حلًا.

{
  "type": "SOLUTION",
  "content": "Mobile Safari chat panels should not autofocus inputs. Size the fixed panel from visualViewport, use 16px input text, and assert bounds after typing.",
  "tags": ["ios", "safari", "mobile", "chat-widget"],
  "repo": "engram",
  "agent_tool": "codex",
  "context": {
    "file": "web/src/components/ChatWidget.tsx",
    "platform": "ios-safari"
  }
}
engram_recall

يسترجع الذكريات المفيدة قبل القرار.

{
  "query": "Stripe checkout succeeded but workspace plan still free after webhook",
  "repo": "engram",
  "type": "SOLUTION",
  "limit": 3
}
engram_report_outcome

يبلغ هل ساعدت الذاكرة لتحسين الترتيب.

{
  "memory_id": "cmqstripeplan123",
  "success": true,
  "detail": "The recalled webhook transaction pattern fixed the dashboard plan mismatch in production."
}
engram_reflect

ينهي الجلسة بتقرير الذكريات المستخدمة والتعلم الجديد.

{
  "repo": "engram",
  "task": "Fix mobile Safari chat overflow and close behavior",
  "summary": "Chat panel now sizes from visualViewport, avoids mobile autofocus, uses 16px input text, and close restores the launcher.",
  "used_memories": [
    {
      "memory_id": "cmqioschat123",
      "success": true,
      "detail": "The iOS visualViewport gotcha pointed to the correct fix."
    }
  ],
  "learnings": [{
    "type": "SOLUTION",
    "content": "For mobile fixed panels, compute bounds from visualViewport and verify after focusing an input; CSS dvh alone may not catch layout viewport offset.",
    "tags": ["mobile", "safari", "visualViewport"]
  }]
}
engram_get_context

يحمّل الذاكرة المناسبة لـ repo.

{
  "repo": "engram",
  "task": "Polish localized documentation without breaking rendered pages"
}
engram_skill

يحمّل دليل skill كاملًا لمهمة معقدة.

{
  "skill": "security-audit"
}
engram_proof

يعرض إثبات المنتج: الذاكرة والاستخدام والتفعيل والbenchmark.

engram_proof()
engram_setup

يعرض معلومات workspace والأدوات المتاحة وأفضل الممارسات.

{
  "agent_tool": "claude-code"
}

انواع الذاكرة

CONVENTION

معايير البرمجة وقواعد الفريق

"Always use Prisma migrations"

PATTERN

نهج متكررة وقوالب

"API routes use cached() wrapper"

GOTCHA

اشياء تتعطل او تفاجئ

"Neon requires SSL in production"

SOLUTION

اصلاحات نجحت

"Fix: add pooler to connection string"

ARCHITECTURE

قرارات تصميم النظام

"Search uses Haversine + bbox"

DEPENDENCY

معلومات المكتبات والاصدارات

"Prisma 7 needs adapter pattern"

// نقطة نهاية قابلة للقراءة الية

GET https://engram.tools/api/v1/capabilities

يعيد JSON بالادوات المدعومة وانواع الذاكرة وحدود المعدل والاسعار - مصمم للاستهلاك البرمجي.

الدعم والملاحظات

ساعدنا في تحسين Engram

إذا كان الإعداد مربكًا، أو تصرفت أداة بشكل غريب، أو بدا حد السعر غير صحيح، اكتب لنا هنا. تصل الرسالة مباشرة إلينا.

الدعم والملاحظات

ما الذي نحسّنه؟

الأخطاء وخطوات الإعداد المربكة وأسئلة الأسعار وأفكار المنتج تصل مباشرة إلى فريق Engram.

باقي 10 أحرف0/10