المسرد

كل مصطلح يستخدمه المنتج وهذا التوثيق، معرَّفًا مرة واحدة. ‏Masaro منصة مهام لبناء البرمجيات مع وكلاء برمجة ذكيين؛ وهذه مفرداتها.

البنية

  • مساحة العمل: النطاق الأعلى الذي تعمل داخله. تملك الأعضاء والمهام والوكلاء والإعدادات. تحصل على مساحة عمل شخصية عند التسجيل ويمكنك الانتماء إلى مساحات جماعية.
  • المشروع: تجميع اختياري على المهمة (عمل عميل، مجال منتج)، لا حاوية يجب أن تعيش المهام داخلها. مساحة العمل هي النطاق الحقيقي؛ وقد يكون للمهمة مشروع أو لا.
  • الملحمة: مجموعة مهام مترابطة بحجم ميزة. تنتمي الملاحم إلى مشروع، ولذلك لا يمكن لمهمة بلا مشروع أن تحمل ملحمة.
  • المهمة: وحدة العمل: عنوان ووصف وحالة وأولوية وتعقيد ومعايير قبول ووسوم. هي ما على اللوحة، وما تسلّمه إلى وكيل.
  • المهمة الفرعية: مهمة متداخلة تحت مهمة أصل.
  • الحالة: موضع المهمة في التدفّق: الانتظار ← جاهز ← قيد التنفيذ ← قيد المراجعة ← مكتمل. والأرشفة تحفظ التاريخ؛ ولا شيء يُحذف نهائيًا.
  • التعقيد: تقدير حجم تقريبي: trivial، small، medium، large، xl. ويحدّد أيضًا كم يصمد حجز وكيل صامت قبل أن يتقادم.
  • الوسم: بطاقة ملوّنة على مستوى مساحة العمل للتجميع والتصفية. (وأدوات MCP تصفّي بأسماء الوسوم عبر معاملها tags.)
  • التبعية: رابط «محجوبة بواسطة» بين المهام. ولا تُسلَّم مهمة محجوبة إلى وكيل حتى يكتمل حاجبها.

العقد

  • معايير القبول: القائمة القابلة للتحقق التي تحدّد معنى «منجَز» لمهمة. هي العقد الذي يبني عليه البشر والوكلاء، والمسطرة التي تقيّم بها المراجعات. انظر المفهوم.
  • التسليم: إعطاء مهمة لوكيل ذكاء اصطناعي عبر MCP، بكامل السياق.
  • الإعادة: العكس: يسلّم الوكيل مع ملخص وادّعاءات «مستوفى/غير مستوفى» لكل معيار، وتنتقل المهمة إلى قيد المراجعة لتقييمك.
  • الفرز: منطقة انتظار للعمل الوارد (المهام التي ينشئها وكيل ضمن السياسة الخاضعة للإشراف). تقبل المهمة إلى قائمة الانتظار أو ترفضها؛ ولا شيء يدخل الخطة بدونك.

الذكاء الاصطناعي

  • العصف الذهني: محادثة الذكاء الاصطناعي بملء الصفحة التي تحوّل فكرة إلى ملاحم ومهام محددة النطاق مع معايير.
  • مساعد الذكاء الاصطناعي: الذكاء نفسه في صورة لوحة جانبية واعية بالسياق (Cmd+J) على أي شاشة.
  • المهارة: وضع مركّز للمساعد: العصف الذهني، والتقسيم، ومعايير القبول، والتوازي.
  • الاقتراح (Suggest): التمرير عند الطلب الذي تطلبه أنت، في نافذة الإنشاء أو على مهمة قائمة. يقترح وسومًا من مفردات مساحة عملك، وتقديرًا، وحتى ثلاثة معايير قبول، بوصفها شارات تأخذها واحدة واحدة. ولا يُكتب شيء حتى تقبله.
  • تهيئة المهمة: التمرير الوحيد الذي يجريه Masaro دون طلب، عند التسليم: حين يحجز وكيل مهمة لا ملخّص لها ولا معايير، يُصاغ الملخّص حينها وتُقترح المعايير بوصفها اقتراحات. وتنقيح سجل الأعمال يجري المسح نفسه وفق جدول، إن فعّلته. ولا يستبدل أيٌّ منهما ما كتبته.
  • الاقتراح: تغيير يقترحه الذكاء الاصطناعي تقبله أو تتجاهله. والاقتراحات لا تطبّق نفسها أبدًا.
  • ذاكرة المشروع: ملاحظات markdown دائمة وقابلة للتحرير يحتفظ بها Masaro عن مشروع (تقنيات، أعراف، قرارات) ليبدأ الوكلاء وقد أُطلِعوا. انظر المفهوم.

الوكلاء

  • الوكيل: عامل ذكاء اصطناعي خارجي (Claude Code، Cursor، أي عميل MCP) له هوية خاصة في مساحة عملك. وكل إجراء يتخذه يُنسَب إلى تلك الهوية.
  • MCP: بروتوكول سياق النموذج، المعيار المفتوح الذي يستخدمه الوكلاء للاتصال بـ Masaro وسحب المهام والإبلاغ عن التقدّم وإعادة العمل. انظر تسليم MCP.
  • تشغيل الوكيل: السجل الحي لجلسة عمل وكيل واحدة على مهمة: الحالة، والإجراء الحالي، والتقدّم، والفرع، وطلب السحب. وهو ما يجعل الوكيل يبدو كزميل على اللوحة.
  • الحجز: حجز وكيل لمهمة (قيد التنفيذ تحت هويته). والحجز مؤقّت تُبقيه تقارير التقدّم ساريًا؛ فحجز وكيل صامت يتقادم فتتحرّر المهمة تلقائيًا.
  • سياسة الاستقلالية: كم يجوز للوكيل أن يفعل بدونك: خاضع للإشراف (الافتراضي؛ بوابتا الفرز والمراجعة) أو مستقل. سقف لمساحة العمل وحدّ لكل وكيل؛ والأشد يفوز. انظر استقلالية الوكيل.