أوامر خط الأنابيب

يأتي Apothem مع خطّ أنابيب /plan واعٍ بالمعمارية، وخطّ أنابيب /research من ثلاث عشرة مرحلة، إضافةً إلى سلسلة تدقيق من أحد عشر أمرًا — ممّا يمنح كلّ مشروع مسارًا مُهيكَلًا من النثر الخام إلى شِفرة بمستوى الإنتاج مُراجَعة على محاور متعدّدة، ومن الفكرة الخام إلى ورقة بحثية منشورة ومُراجَعة من الأقران.

نظرة عامة على خط الأنابيب

flowchart LR
    accTitle: Plan pipeline command flow
    accDescr: Left-to-right flowchart of the apothem plan pipeline from the spec stage through the generate and review stages, then through a conditional architecture-bearing decision that either runs the design stage or skips directly to the execute stage. The orthogonal audit stage wraps the spec-through-review span as a closed remediation loop.
    A[/plan-spec] --> B[/plan-generate]
    B --> C[/plan-review]
    AUD[/plan-audit<br/>orthogonal: wraps spec → review] -.->|closed-loop remediation| A
    C --> Q{Architecture-bearing suite?}
    Q -->|yes| F[/plan-design<br/>emit _inputs/design.md]
    Q -->|no| D[/plan-execute]
    F --> D
    D --> E[/plan-status]
    D --> G[Audit review sequence]
    G --> H[Completion milestone]

مراحل التخطيط

يُشحَن خطّ الأنابيب على هيئة ثمانية أوامر مائلة من الدرجة الأولى، واحد لكلّ مرحلة — كلٌّ منها قابل للاستدعاء بصورة مستقلّة كـ /plan-<stage>.

/plan-audit متعامد على التدفّق الخطّي، وليس مرحلةً داخله. فهو يغلّف /plan-spec → /plan-generate → /plan-review كحلقة مغلقة واحدة، ويُشغِّل المراحل الصاعدة المفقودة فقط، ويعالج النتائج بفاعلية، ويترك الحزمة جاهزة لـ /plan-execute. وهو متمايز عن سلسلة التدقيق أدناه، التي تُدقّق قاعدة شِفرة مُنفَّذة بدلًا من حزمة خطّة.

/plan-design ليس طقسًا كونيًّا. إذ يُصنِّف /plan-review ما إذا كانت الحزمة تُغيِّر أسطحًا حاملةً للمعمارية. فإن كانت كذلك، يُخرِج /plan-design أثرَ التصميم الذي يستهلكه /plan-execute و/architecture-review. وإن لم تكن، انتقلت الحزمة المُراجَعة مباشرةً إلى التنفيذ.

خط أنابيب البحث

يُشحَن خطّ أنابيب البحث على هيئة ثلاثة عشر أمرًا مائلًا من الدرجة الأولى، واحد لكلّ مرحلة — كلٌّ منها قابل للاستدعاء بصورة مستقلّة كـ /research-<stage>، مُتسلسِلة عبر بوّابة تسلسل وبيان تسليم، تحت عشرة تفويضات صرامة (المصادر الموثوقة، وقابلية الاستنساخ، وقابلية التفنيد، ونزاهة الاستشهاد، والتسجيل المُسبَق، والأخلاقيّات / تضارب المصالح، والصرامة الإحصائية، والعلم المفتوح / FAIR، والامتثال لأدلّة الإبلاغ، والتأسيس النظري / الأثر).

flowchart LR
    accTitle: Research pipeline command flow
    accDescr: Left-to-right flowchart of the apothem research pipeline from the ideate stage through spec, theory, sources, synthesis, proposal, study design, experiment, analysis, paper, and peer review to publish and disseminate, with a revision loop from review back to paper.
    RI[/research-ideate] --> RS[/research-spec]
    RS --> RT[/research-theory]
    RT --> RSO[/research-sources]
    RSO --> RSY[/research-synthesis]
    RSY --> RPR[/research-proposal]
    RPR --> RD[/research-design]
    RD --> RE[/research-experiment]
    RE --> RA[/research-analysis]
    RA --> RP[/research-paper]
    RP --> RR[/research-review]
    RR --> RPU[/research-publish]
    RPU --> RDI[/research-disseminate]
    RR -.->|revision loop| RP

يقود مُنسِّق سير العمل المُغلَّف /research هذه المراحل من السؤال الخام إلى الورقة المنشورة (وهو نفسه ليس مرحلة)، مُتحقِّقًا من مُخرَج كلّ مرحلة بصورة مستقلّة قبل أن تبني المرحلة التالية عليه؛ ويُشغِّل --quick فقط /research-sources + /research-synthesis لتقرير موثَّق بالاستشهاد بمرور واحد.

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

سلسلة تدقيق المراجعة

يجتاح مُنسِّق سير العمل المُغلَّف /audit الأبعاد الأحد عشر أدناه جميعها كمرور موازٍ واحد — وهو نظير التدقيق-الحصن لـ /plan و/research — مُركِّبًا تقرير نتائج واحدًا مُزالًا منه التكرار ومُصنَّفًا حسب الخطورة (للإبلاغ فقط؛ تُوجَّه المعالجة إلى /elevate). وكلّ بُعد قابل للاستدعاء فرديًّا أيضًا.

يغلق مُنسِّق سير العمل المُغلَّف /fortress الحلقة التي يُبلِغ عنها /audit: فهو يكتشف عبر /audit، ويتحقّق من كلّ نتيجة، ويعالج كلّ ناجٍ على سطحه المالك، ويُعيد التدقيق في حلقة محدودة، ويُبوِّب النتيجة عبر /release-readiness — وهو نظير تصليب-الإنتاج لـ /plan و/research.