Skip to content
Apothem
パイプラインコマンド

パイプラインコマンド

Apothem のパイプラインコマンドリファレンス — /plan フローと監査コマンドのカタログ。

Apothem は、アーキテクチャを考慮した /plan パイプライン、13 ステージの /research パイプライン、そして 11 コマンドの監査シーケンスを出荷しています。 これにより、すべてのプロジェクトに、生の散文から本番品質で多軸のレビューを経たコードへ、 そして生のアイデアから広く発信され査読を経た論文へと至る、構造化された道筋が与えられます。

パイプラインの概要

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]

プランニングのステージ

パイプラインは、ステージごとに 1 つずつ、8 つのファーストクラスのスラッシュコマンドとして出荷されます — それぞれ /plan-<stage> として個別に呼び出せます。 /plan オーケストレーターは、ミッションから実行済みのスイートまで、これらのステージを駆動します。

ステージ役割位置
/plan-specフォージ — 散文から仕様へ先頭
/plan-generateジェネレーター — 仕様からプランスイートへチェーンの中間
/plan-reviewオーディター — フォレンジックなプラン監査チェーンの中間
/plan-designアーキテクト — アーキテクチャに関わるスイートのための _inputs/design.md条件付きゲート
/plan-executeエグゼキューター — フェーズの実行終端
/plan-statusレポーター — 読み取り専用のステータス読み取り専用
/plan-auditガーディアン — spec → generate → review のクローズドループによるラップ直交(実行前)
/plan-amendスチュワード — 既存スイートの再入可能な修正再入可能

/plan-audit は線形フローに対して直交しており、その中のステージではありません。 /plan-spec → /plan-generate → /plan-review を 1 つのクローズドループとしてラップし、 欠けている上流のステージだけを実行し、検出結果を能動的に是正し、スイートを /plan-execute の準備が整った状態にします。 これは後述の監査レビューシーケンスとは別物です。監査レビューシーケンスは、プランスイートではなく、実行済みのコードベースを監査します。

/plan-design は、すべての場合に行う儀式ではありません。/plan-review は、 スイートがアーキテクチャに関わる面を変更するかどうかを分類します。 変更する場合、/plan-design は、/plan-execute と /architecture-review が利用する設計トレースを出力します。 変更しない場合、レビュー済みのスイートはそのまま実行に進みます。

リサーチパイプライン

リサーチパイプラインは、ステージごとに 1 つずつ、13 のファーストクラスのスラッシュコマンドとして出荷されます — それぞれ /research-<stage> として個別に呼び出せ、シーケンスゲートとハンドオフマニフェストによって連結され、 10 の厳密性マンデート(権威ある情報源、再現性、反証可能性、引用の完全性、事前登録、 倫理 / 利益相反、統計的厳密性、オープンサイエンス / 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-ideate問題の定式化 — ドメインのシードから候補となる問いを導く先頭
/research-spec問いの枠組み — 反証可能な仮説 + スコープチェーンの中間
/research-theory概念フレームワーク + 変化の理論チェーンの中間
/research-sources再実行可能な検索記録を伴う体系的な情報源の収集チェーンの中間
/research-synthesisSOTA マップ + ギャップ分析チェーンの中間
/research-proposal目的 + 実現可能性 + コンティンジェンシー + インパクト + データ計画 + 事前登録の計画。資金提供機関の公募マトリクスまたは再申請への回答チェーンの中間
/research-design研究デザイン + 事前登録チェーンの中間
/research-experiment実行 + 記録、再現可能チェーンの中間
/research-analysis結果 + 統計チェーンの中間
/research-paperトップティアの論文ドラフトチェーンの中間
/research-review査読レベルの批評チェーンの中間
/research-publish投稿先向けのパッケージ + 投稿チェーンの中間
/research-disseminate普及 + インパクト + FAIR なアーカイブ終端

/research のラップ型ワークフローオーケストレーターは、生の問いから公開された論文まで、 これらのステージを駆動します(オーケストレーター自体はステージではありません)。 次のステージが前のステージの出力に基づいて構築を始める前に、各ステージの出力を独立してチェックします。 --quick は、1 回限りの引用付きレポートのために /research-sources + /research-synthesis だけを実行します。

経験的なステージ(情報源、研究デザイン、実験、分析)と執筆のステージ(論文、レビュー、公開、普及)は、 さらに厳密性を運用に落とし込む面 — 公平な複数手法の比較、比較対象の来歴、実験プログラムの足場、 計算資源の利用計画、オプトインの自律実験ループ、完了の定義による前進ゲート、段階的な開示を伴う盲検化、検索記録、 研究の割り付けと検出力の計画、分析の規律、計画のコンティンジェンシー、図の完全性、口頭発表とポスターの計画 — を活用します。 これらは 10 のマンデートを拡張することなく、運用上の詳細を加えるものです。

監査レビューシーケンス

/audit のラップ型ワークフローオーケストレーターは、以下の 11 の次元すべてを 1 回の並列パスで一掃します — /plan と /research に相当する監査フォートレス版です — そして、重複を排除し重大度で振り分けた 1 つの検出結果レポートにまとめます(レポートのみ。是正は /elevate に回されます)。各次元は個別に呼び出すこともできます。

/fortress のラップ型ワークフローオーケストレーターは、/audit が報告するループを閉じます。/audit を通じて検出し、各検出結果を検証し、検証を通過したすべての検出結果をその所有元の面で是正し、上限のあるループで再監査し、結果を /release-readiness でゲートします — /plan と /research に相当する本番堅牢化版です。

コマンド品質領域
/code-reviewコード品質
/code-auditコードコーパス
/security-auditOWASP / ASVS
/perf-auditパフォーマンス
/architecture-reviewアーキテクチャ
/ux-review開発者体験
/a11y-auditアクセシビリティ
/docs-reviewドキュメント
/dependency-audit依存関係
/supply-chain-auditサプライチェーン
/threat-model-audit脅威モデル

すべてのコマンド

出荷されるすべてのコマンドです。src/apothem/commands/ 配下の定義から生成されます。 手書きのページがないコマンドには、同じ定義から生成されたページが用意されます。

CommandSummary
/planRuns the planning pipeline (spec, generate, review, design) with independent verification, confirming at each hand-off; execute stays a manual step the …
/plan-specTurns free-form prose, notes or rough requirements into a spec-grade _spec/spec.md that keeps the author's wording and settles open questions by inquiry.
/plan-generateGenerates a full plan suite (master plan, progress log, decision notes, per-phase files) from a written spec or raw prose.
/plan-reviewReads an existing plan suite line by line for fidelity, consistency, completeness and risk, then applies only the revisions the user approves.
/plan-designWrites the architectural design for a reviewed plan suite at _inputs/design.md: components, interfaces, decisions and diagrams.
/plan-executeUse to implement one phase of a reviewed plan suite: reads the phase file and progress notes, verifies prerequisites and review scorecards, implements each …
/plan-amendChanges an existing plan suite without losing resolved decisions, re-deriving only the affected spec, phases and notes.
/plan-auditAudits a plan suite across spec, generate and review, then fixes findings in a loop without per-revision approval until none remain or the cap is hit.
/plan-statusReports plan-suite progress from its tracking files across tasks, phases and artifacts, read-only.
/researchRuns the research pipeline from idea to peer-reviewed paper, verifying each stage hand-off and halting before data collection or publication.
/research-ideateFinds a research question from zero by scanning opportunities, gaps, and invalidated hypotheses, then ranking candidates.
/research-specFrames a research question or notes into a testable spec: falsifiable hypotheses, inclusion and exclusion scope, success metrics.
/research-theoryBuilds the conceptual framework for a framed research question: theory of change, constructs with operational definitions and a conceptual-model diagram.
/research-sourcesCollects and screens the literature for a ratified research spec: deduplication, ranking and extraction with provenance.
/research-synthesisReconciles collected sources into a state-of-the-art map, a literature matrix and a research-gap statement.
/research-proposalTurns a research gap and theoretical framework into a fundable proposal: SMART aims, feasibility, risk register with contingencies, impact pathway, data …
/research-designTurns a synthesized research gap into testable predictions, a study design and a frozen preregistration.
/research-experimentRuns the preregistered study protocol and records raw data with provenance: experiment log, data, and reproducibility manifest (environment, seed, version …
/research-analysisRuns the preregistered statistical analysis on collected data: effect sizes with confidence intervals, multiple-comparison correction, robustness checks, …
/research-paperAssembles a paper draft from the synthesis, study design, and analysis, with every citation checked to resolve.
/research-reviewHostile peer review of a paper, from a research suite or a supplied PDF or text: scores novelty, rigor, reproducibility, ethics; ranks revisions.
/research-publishBuilds the venue submission package for a reviewed paper: template formatting, cover letter, data and code availability statement, ethics and conflict …
/research-disseminatePlans post-acceptance dissemination and impact: preprint announcement, FAIR data and code archive, altmetrics tracking, rebuttal loop.
/auditSweeps a repository across all eleven review dimensions in one multi-agent run and returns one verified, severity-ranked report; it never fixes anything.
/a11y-auditAudits rendered pages of a web surface against WCAG 2.2 AA and reports severity-ranked findings per page, without fixing anything.
/architecture-reviewReviews a repository against its design document and layer rules, reporting boundary violations, coupling and wiring gaps as ranked findings.
/code-auditCross-file forensic audit: hidden coupling, type-hint gaps, coverage holes, dead and duplicate code.
/code-reviewReviews source files one at a time for readability, naming, complexity, idiom fit and comment quality, and reports severity-ranked findings without editing.
/dependency-auditAudits direct and transitive dependencies for known vulnerabilities, license conflicts, deprecation and loose pins, ranking findings per dependency.
/docs-reviewReviews documentation pages for prose clarity, broken links, code-block tags, citations and public-API coverage, reporting severity-ranked findings per page.
/perf-auditAudits an Apothem installation's per-class budgets (hooks, ecosystem verification, conformity gate, tests, agents, shell, lint) with its benchmark drivers, …
/security-auditAudits a repository's security posture: secrets, injection, unsafe deserialization, path traversal, vulnerable dependencies.
/supply-chain-auditAudits a repository's release pipeline: build provenance, artifact signing, SBOM completeness, pinned CI actions and minimum permissions.
/threat-model-auditThreat-models a repository with STRIDE per element and trust boundaries, classifying actors and rating residual risk.
/ux-reviewReviews a repository's developer experience from a first-time user's view: CLI ergonomics, error messages, install flow and docs discoverability.
/fortressHardens a repository end to end: runs the audit sweep, verifies each finding, remediates survivors through the surgical-guard, secret-rotation and vuln-triage …
/elevateWhole-repository elevation: runs the audit sweep, then critiques naming, structure, storytelling and extensibility, remediates what it finds (deletions are …
/evalRuns one evaluation campaign for a language model or prompt: scores each output over a dataset and reports metrics by category plus regressions against a …
/freshifyUse when a repository must be made fresh and release-clean: purges caches and stale artifacts, removes legacy narrative and back-references, normalizes file …
/github-deploy-freshUse when a GitHub repository needs one clean first release on origin/main: a single v0.1.0 release commit, green workflow cards, a first-version changelog, and …
/github-deploy-nextUse to run the next release cycle on a GitHub repository: merge ready pull requests, resolve the issues the release addresses, derive the SemVer bump from …
/projectifyBuilds the Description, Instruction and knowledge files for a chat-app Project or custom assistant through guided questions, within the platform's context …
/release-readinessPre-release gate sweep: use before shipping a repository to check lint, format, types, tests, dependency and supply-chain risk, visibility surfaces, changelog …
/test-suiteAuthors and runs behavior-first tests for a repository, triages failures and reports coverage gaps on critical paths.
/workflowUse to run a non-trivial mission as an independent multi-agent workflow: parallel subagents under named return contracts, refute-by-default verification of …

On this page