/research-experiment

‏/research-experiment — يُنفّذ الدراسة المُصمَّمة ويلتقط البيانات الخام بمصدرية كاملة، إضافةً إلى بيان قابلية الإعادة (البيئة، البذرة، البروتوكول، تثبيت الإصدارات).

الدور: الباحث الرئيسي (التنفيذ) الموضع في خط الأنابيب: منتصف السلسلة

يُنفّذ الدراسة أو التجربة المُصمَّمة ويلتقط البيانات الخام بمصدرية كاملة. يضمن قابلية الإعادة: يسجّل البيئة والبذرة وسجلّ البروتوكول وتثبيت الإصدارات حتى يتمكّن طرف مستقل من إعادة التشغيل.

الاستدعاء المعياري

/research-experiment

مع وسائط:

/research-experiment [path/to/research-suite/]

المدخلات

_inputs/study-design.md (التصميم) و_inputs/preregistration.md (خطة التحليل المُجمَّدة).

المخرجات

_outputs/experiment-log.md (أثر البروتوكول المختوم زمنيًا)، والبيانات الخام في موقع طبيعي للمضيف، و_outputs/reproducibility-manifest.md (البيئة، البذرة، البروتوكول، تثبيت الإصدارات).

في المصبّ

‏/research-analysis (المستهلك في المصبّ)

مراحل سير العمل

يتبع الأمر سير عمل خط أنابيب /research المعياري:

تحميل السياق — قراءة تصميم الدراسة والتسجيل المسبق.
التحقّق من بوّابة التسلسل — تأكيد وجود _inputs/study-design.md؛ وإلا فالتوقّف برسالة Blocked: run /research-design first.
التشغيل والتسجيل — تنفيذ البروتوكول؛ التقاط البيانات الخام بمصدريتها؛ تسجيل أثر البروتوكول المختوم زمنيًا.
التقاط قابلية الإعادة — تسجيل البيئة والبذرة والبروتوكول وتثبيت الإصدارات.
تحديث بيان التسليم — تسجيل موقع البيانات وبيان قابلية الإعادة.
إصدار السجلّ — _outputs/experiment-log.md + البيانات الخام + _outputs/reproducibility-manifest.md.

يُجري التنفيذُ تمريرة تجريبية استطلاعية لمعايرة الميزانيات والنطاقات، ثم المقارنة الكاملة تحت خطّة مُعلَنة لاستغلال الحوسبة (توزيع الأنوية، وسقوف الذاكرة، والتوازي الآمن للتكرارات المستقلّة). وتُشغّل كلُّ طريقة عشوائية نظامَ تكرارها المُسجَّل مسبقًا مع بذور مُسجَّلة وعتاد مُوثَّق. وتتوفّر حلقةُ تجربة مستقلّة اختيارية معطَّلة افتراضيًّا: مقابل مِطواعٍ (harness) مُجمَّد، تقترح تغييرًا على هدف واحد قابل للتحوير، وتشغّله بالميزانية المُثبَّتة، ولا تحتفظ به إلا إن تفوّق على القائم، وتُدوِّن كلّ تجربة في يوميّاتها.

أنماط الفشل

العَرَض	السبب	الاسترداد
Blocked: run /research-design first	لا يوجد تصميم للدراسة	شغّل `/research-design` لإنتاج `_inputs/study-design.md`
التشغيل غير قابل للإعادة	سجلّ البذرة / البيئة مفقود	سجّل بيان قابلية الإعادة الكامل قبل المتابعة
انحراف البروتوكول غير موثّق	تغيير في أثناء التشغيل لم يُسجَّل	سجّل الانحراف في سجلّ التجربة؛ وأفصِح عنه عند التحليل

أمثلة

# شغّل الدراسة المُصمَّمة والتقط بيانات خام قابلة للإعادة
/research-experiment path/to/research-suite/