Perintah pipeline

Apothem mengirimkan pipeline /plan yang sadar arsitektur, pipeline /research tiga belas tahap, ditambah urutan audit sebelas perintah — memberikan setiap proyek jalur terstruktur dari prosa mentah menuju kode berkelas produksi yang ditinjau dari banyak sumbu, dan dari ide mentah menuju makalah yang telah ditelaah sejawat dan disebarluaskan.

Gambaran umum pipelineCopy 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]

Tahap-tahap perencanaanCopy Anchor Link

Pipeline ini dikirimkan sebagai delapan perintah garis miring kelas satu, satu per tahap — masing-masing dapat dipanggil secara independen sebagai /plan-<stage>. Orkestrator /plan menggerakkan tahap-tahap tersebut dari sebuah misi hingga suite yang telah dieksekusi.

/plan-audit bersifat ortogonal terhadap alur linear, bukan tahap di dalamnya. Perintah ini membungkus /plan-spec → /plan-generate → /plan-review sebagai satu lingkar tertutup, hanya menjalankan tahap hulu yang belum ada, secara aktif meremediasi temuan, dan meninggalkan suite dalam keadaan siap untuk /plan-execute. Perintah ini berbeda dari urutan tinjauan audit di bawah, yang mengaudit basis kode yang telah dieksekusi alih-alih suite rencana.

/plan-design bukan seremoni universal. /plan-review mengklasifikasikan apakah suite mengubah permukaan yang menyangkut arsitektur. Jika ya, /plan-design memancarkan jejak desain yang dikonsumsi /plan-execute dan /architecture-review. Jika tidak, suite yang telah ditinjau langsung masuk ke eksekusi.

Pipeline risetCopy Anchor Link

Pipeline riset dikirimkan sebagai tiga belas perintah garis miring kelas satu, satu per tahap — masing-masing dapat dipanggil secara independen sebagai /research-<stage>, dirangkai oleh Sequence Gate dan Handoff Manifest, di bawah sepuluh mandat ketelitian (sumber otoritatif, reprodusibilitas, falsifiabilitas, integritas sitasi, praregistrasi, etika / konflik kepentingan, ketelitian statistik, sains terbuka / FAIR, kepatuhan pada pedoman pelaporan, landasan teoretis / dampak).

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

Orkestrator alur kerja terbungkus /research menggerakkan tahap-tahap ini dari pertanyaan mentah hingga makalah yang terbit (orkestrator itu sendiri bukan sebuah tahap), dengan memeriksa keluaran setiap tahap secara independen sebelum tahap berikutnya dibangun di atasnya; --quick hanya menjalankan /research-sources + /research-synthesis untuk laporan bersitasi sekali jalan.

Tahap-tahap empiris (sumber, desain, eksperimen, analisis) dan tahap-tahap penulisan (makalah, tinjauan, publikasi, diseminasi) juga memanfaatkan permukaan yang mengoperasionalkan ketelitian — perbandingan multi-metode yang adil, provenance pembanding, kerangka program eksperimen, rencana pemanfaatan komputasi, lingkar eksperimen otonom yang opt-in, gerbang kemajuan definition-of-done, pembutaan dengan pengungkapan bertahap, catatan pencarian, perencanaan alokasi studi dan daya, disiplin analisis, kontingensi rencana, integritas gambar, serta perencanaan presentasi dan poster — yang menambahkan detail operasional pada kesepuluh mandat tanpa memperluasnya.

Urutan tinjauan auditCopy Anchor Link

Orkestrator alur kerja terbungkus /audit menyapu kesebelas dimensi di bawah ini dalam satu lintasan paralel — padanan audit-fortress dari /plan dan /research — dan menyintesis satu laporan temuan yang telah dideduplikasi dan ditriase menurut tingkat keparahan (hanya laporan; remediasi diarahkan ke /elevate). Setiap dimensi juga dapat dipanggil secara terpisah.

Orkestrator alur kerja terbungkus /fortress menutup lingkar yang dilaporkan /audit: orkestrator ini mendeteksi melalui /audit, memverifikasi setiap temuan, meremediasi setiap temuan yang bertahan pada permukaan pemiliknya, mengaudit ulang dalam lingkar yang dibatasi, dan menggerbangkan hasilnya melalui /release-readiness — padanan pengerasan produksi dari /plan dan /research.

Semua perintahCopy Anchor Link

Setiap perintah yang dikirimkan, dihasilkan dari definisinya di bawah src/apothem/commands/. Perintah tanpa halaman yang ditulis tangan mendapatkan halaman yang dihasilkan dari definisi yang sama.