पाइपलाइन कमांड

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/ के अंतर्गत उसकी परिभाषा से उत्पन्न। जिन कमांड का हाथ से लिखा पृष्ठ नहीं है, उन्हें उसी परिभाषा से उत्पन्न एक पृष्ठ मिलता है।