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

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

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

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, and the re-entrant amend stage revises an existing suite and returns it to review.
    A[/plan-spec] --> B[/plan-generate]
    B --> C[/plan-review]
    AUD[/plan-audit<br/>orthogonal: wraps spec → review] -.->|closed-loop remediation| A
    AM[/plan-amend<br/>re-entrant: revises an existing suite] -.->|re-review| C
    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]

مراحل التخطيطCopy Anchor Link

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

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

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

خط أنابيب البحثCopy Anchor Link

يُشحَن خط أنابيب البحث في صورة ثلاثة عشر أمر شرطة مائلة من الدرجة الأولى، أمر لكل مرحلة — ويمكن استدعاء كلٍّ منها مستقلًّا بالصيغة /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 فقط للحصول على تقرير موثَّق بالاستشهادات في تمريرة واحدة.

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

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

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

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

جميع الأوامرCopy Anchor Link

كل أمر مشحون، مُولَّد من تعريفه تحت src/apothem/commands/. والأوامر التي ليست لها صفحة مكتوبة يدويًا تحصل على صفحة مُولَّدة من التعريف نفسه.