パイプラインコマンド
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-synthesis | SOTA マップ + ギャップ分析 | チェーンの中間 |
| /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-audit | OWASP / ASVS |
| /perf-audit | パフォーマンス |
| /architecture-review | アーキテクチャ |
| /ux-review | 開発者体験 |
| /a11y-audit | アクセシビリティ |
| /docs-review | ドキュメント |
| /dependency-audit | 依存関係 |
| /supply-chain-audit | サプライチェーン |
| /threat-model-audit | 脅威モデル |
すべてのコマンド
出荷されるすべてのコマンドです。src/apothem/commands/ 配下の定義から生成されます。
手書きのページがないコマンドには、同じ定義から生成されたページが用意されます。
| Command | Summary |
|---|---|
| /plan | Runs the planning pipeline (spec, generate, review, design) with independent verification, confirming at each hand-off; execute stays a manual step the … |
| /plan-spec | Turns 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-generate | Generates a full plan suite (master plan, progress log, decision notes, per-phase files) from a written spec or raw prose. |
| /plan-review | Reads an existing plan suite line by line for fidelity, consistency, completeness and risk, then applies only the revisions the user approves. |
| /plan-design | Writes the architectural design for a reviewed plan suite at _inputs/design.md: components, interfaces, decisions and diagrams. |
| /plan-execute | Use to implement one phase of a reviewed plan suite: reads the phase file and progress notes, verifies prerequisites and review scorecards, implements each … |
| /plan-amend | Changes an existing plan suite without losing resolved decisions, re-deriving only the affected spec, phases and notes. |
| /plan-audit | Audits 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-status | Reports plan-suite progress from its tracking files across tasks, phases and artifacts, read-only. |
| /research | Runs the research pipeline from idea to peer-reviewed paper, verifying each stage hand-off and halting before data collection or publication. |
| /research-ideate | Finds a research question from zero by scanning opportunities, gaps, and invalidated hypotheses, then ranking candidates. |
| /research-spec | Frames a research question or notes into a testable spec: falsifiable hypotheses, inclusion and exclusion scope, success metrics. |
| /research-theory | Builds the conceptual framework for a framed research question: theory of change, constructs with operational definitions and a conceptual-model diagram. |
| /research-sources | Collects and screens the literature for a ratified research spec: deduplication, ranking and extraction with provenance. |
| /research-synthesis | Reconciles collected sources into a state-of-the-art map, a literature matrix and a research-gap statement. |
| /research-proposal | Turns a research gap and theoretical framework into a fundable proposal: SMART aims, feasibility, risk register with contingencies, impact pathway, data … |
| /research-design | Turns a synthesized research gap into testable predictions, a study design and a frozen preregistration. |
| /research-experiment | Runs the preregistered study protocol and records raw data with provenance: experiment log, data, and reproducibility manifest (environment, seed, version … |
| /research-analysis | Runs the preregistered statistical analysis on collected data: effect sizes with confidence intervals, multiple-comparison correction, robustness checks, … |
| /research-paper | Assembles a paper draft from the synthesis, study design, and analysis, with every citation checked to resolve. |
| /research-review | Hostile peer review of a paper, from a research suite or a supplied PDF or text: scores novelty, rigor, reproducibility, ethics; ranks revisions. |
| /research-publish | Builds the venue submission package for a reviewed paper: template formatting, cover letter, data and code availability statement, ethics and conflict … |
| /research-disseminate | Plans post-acceptance dissemination and impact: preprint announcement, FAIR data and code archive, altmetrics tracking, rebuttal loop. |
| /audit | Sweeps a repository across all eleven review dimensions in one multi-agent run and returns one verified, severity-ranked report; it never fixes anything. |
| /a11y-audit | Audits rendered pages of a web surface against WCAG 2.2 AA and reports severity-ranked findings per page, without fixing anything. |
| /architecture-review | Reviews a repository against its design document and layer rules, reporting boundary violations, coupling and wiring gaps as ranked findings. |
| /code-audit | Cross-file forensic audit: hidden coupling, type-hint gaps, coverage holes, dead and duplicate code. |
| /code-review | Reviews source files one at a time for readability, naming, complexity, idiom fit and comment quality, and reports severity-ranked findings without editing. |
| /dependency-audit | Audits direct and transitive dependencies for known vulnerabilities, license conflicts, deprecation and loose pins, ranking findings per dependency. |
| /docs-review | Reviews documentation pages for prose clarity, broken links, code-block tags, citations and public-API coverage, reporting severity-ranked findings per page. |
| /perf-audit | Audits an Apothem installation's per-class budgets (hooks, ecosystem verification, conformity gate, tests, agents, shell, lint) with its benchmark drivers, … |
| /security-audit | Audits a repository's security posture: secrets, injection, unsafe deserialization, path traversal, vulnerable dependencies. |
| /supply-chain-audit | Audits a repository's release pipeline: build provenance, artifact signing, SBOM completeness, pinned CI actions and minimum permissions. |
| /threat-model-audit | Threat-models a repository with STRIDE per element and trust boundaries, classifying actors and rating residual risk. |
| /ux-review | Reviews a repository's developer experience from a first-time user's view: CLI ergonomics, error messages, install flow and docs discoverability. |
| /fortress | Hardens a repository end to end: runs the audit sweep, verifies each finding, remediates survivors through the surgical-guard, secret-rotation and vuln-triage … |
| /elevate | Whole-repository elevation: runs the audit sweep, then critiques naming, structure, storytelling and extensibility, remediates what it finds (deletions are … |
| /eval | Runs one evaluation campaign for a language model or prompt: scores each output over a dataset and reports metrics by category plus regressions against a … |
| /freshify | Use 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-fresh | Use 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-next | Use 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 … |
| /projectify | Builds the Description, Instruction and knowledge files for a chat-app Project or custom assistant through guided questions, within the platform's context … |
| /release-readiness | Pre-release gate sweep: use before shipping a repository to check lint, format, types, tests, dependency and supply-chain risk, visibility surfaces, changelog … |
| /test-suite | Authors and runs behavior-first tests for a repository, triages failures and reports coverage gaps on critical paths. |
| /workflow | Use to run a non-trivial mission as an independent multi-agent workflow: parallel subagents under named return contracts, refute-by-default verification of … |