コマンドリファレンス
すべての動詞は機械エンジン bash <skill-dir>/runner/flow.sh <command> にディスパッチする。Claude Code、Cursor、Antigravityでは /flow … と入力する。Codex CLIでは $flow … と入力する。Windows PowerShellでは bash ではなく <skill-dir>\runner\flow.cmd <command> を呼ぶ。
/flow status — 今どこにいて、何が止めているか/flow next ゲートチェック + 次のステージを開ける/flow assess ブラウンフィールド評価/flow card ビルドカードを作成/flow check C-001 カードを検証(done = 現実世界の証拠)/flow auto 自律ビルド(セキュリティクラスでhalt)/flow doctor 環境チェック| コマンド | 動作 |
|---|---|
/flow resume |
プロジェクト途中にコールドで入るための読み取り専用セッションストーリー概要:最後のセッション(コマンド名のみ、生の引数は決して)、進行中カードとdwell、ゲート状態、1つの NEXT -> 行。ロックを取らない。既存プロジェクトをコールドで引き継ぐとき最初に実行する。 |
/flow (status) |
今どこにいるか、何が止めているか、resume と同じヘルパーからの NEXT -> 行、現在のステージdwell、カードリスト(10枚超は要約に圧縮)、1行のメモリ要約。 |
/flow recall |
ステージやカードの開始時に耐久メモリを読み戻す——未解決debt、最新のレトロ、前カードのスコープ、ハーネスの摩擦とbacklog、監査の健全性、プレイブック。 |
/flow unlock |
クラッシュや放棄されたセッションの後に、このプロジェクトの並行ロックをクリアする。 |
/flow doctor |
macOS・Linux・Windowsを横断する環境自己チェック:bash、python、grep、git、インストールパス。 |
ステージと計画
Section titled “ステージと計画”| コマンド | 動作 |
|---|---|
/flow next |
現在のステージをゲートチェック。通過したら次を開ける(またはステージ00から開始)。通過したばかりのステージの意味チャレンジは機械的通過の後に適用される。 |
/flow gate <stage> [--json] |
1つのステージ(またはカードには --card C-NNN)の読み取り専用機械スキャン:何も進めず所見を報告する。進行は next/check のものだ。--json は閉じた gate.report エンベロープを出力する。 |
/flow assess |
ブラウンフィールド:計画の前に flow/00-inspect.md に現状評価を足場掛けしてゲートをかける。オペレータレビュー。 |
/flow skip <stage> --reason |
対応する未解決debt行のあるゲートを進める。非セキュリティクラスのみ。ステージ05は決してスキップできない。 |
/flow clarify |
Scope・PRD・Contract上の ## Open decisions 配下に残った - [ ] 箇条書きを列挙する。助言的であり、next ゲートではない。 |
/flow constitution |
flow/constitution.md 内のオペレータ執筆プロジェクト不変条件をチェックする。助言的であり、next ゲートではない。 |
/flow converge |
現在のコードを計画に照らして突き合わせる追記のみの残余カード。トランザクショナル——全カードか無か。既存カードを編集しない。差がなければ CONVERGED を出力し何も書かない。 |
カードとビルド
Section titled “カードとビルド”| コマンド | 動作 |
|---|---|
/flow card |
次のビルドカードを作成。すべての計画ゲート通過後のみ。 |
/flow card start|done C-NNN |
カードを進行中に印付け、または check と同じ規則でゲートされるCLI所有の done への反転——失敗すれば取り消す。手編集と共存する。 |
/flow check C-NNN |
カードを検証する:[FILL] プレースホルダ、ステータス、必須セクション、完了証拠。 |
/flow ready |
ビルド可能なtodoカードを並行安全性ヒント付きで列挙する。 |
/flow auto |
自律実行をプレフライトする。auto stop でクリアする。Tier-Aは自動マージ、Tier-Bは fresh サブエージェントによる1回の修復、Tier-Cセキュリティクラスはhalt。 |
/flow attest semantic|live-verify|status|recover |
証明付き実行コントロールプレーンが使うフィンガープリント束縛の証跡を発行・検査する。 |
/flow workspace add|list|enter|remove|check|doctor|port |
マルチエージェントworktree分離:エージェントごとに1つの git worktree。1つのブランチ切り替えが全端末を反転させない。workspace port は決定的なカードごとポートを割り当てる。 |
/flow loop-prep <card> |
単一数値目標への反復のための配管:分離worktreeと、カードのallowed filesから導出された数値検証コマンド。 |
/flow loop-log <card> --iterations N --start M --end K --outcome … |
終了したループ実行を使用テレメトリに記録する。 |
モードと設定
Section titled “モードと設定”| コマンド | 動作 |
|---|---|
/flow mode [teach|work] |
ゲート成果物を誰が書くかを表示・設定する。デフォルト teach。 |
/flow project-type [web|cli|library|skill] |
プロジェクトタイプを表示・設定する。完了証拠規則と契約の継ぎ目を選択する。デフォルト web。 |
/flow debt add|list |
DEBT.md に意図的ゲートスキップを記録・列挙する。セキュリティクラス項目はオペレータのみ。 |
/flow rules [cursor|windsurf|roo|cline|aider|openhands|copilot|list] [--write] |
サードパーティハーネスがflowの規律に従うためのworkspace規則の足場を出力(または書き込み)する。助言的。 |
ドリフトチェック
Section titled “ドリフトチェック”/flow contract、/flow tokens、/flow coherence、/flow consistency は各々1軸の漂流を旗立てし、自動修正しない。合わせて格子を成す:バージョン、URL、デザイントークン、成果物同士の追跡可能性。
| コマンド | 軸 | 報告内容 |
|---|---|---|
/flow coherence |
バージョン | 宣言されたバージョンフィールド間の漂流——安い文書対コードの断片 |
/flow contract |
URL | クライアントbase-URL対提供パス接頭辞の漂流。二重 /api や混在接頭辞のクラス。スキーマdiffツールが見逃す(web) |
/flow tokens |
デザイン | DESIGN.md 宣言トークン対実際に使われたCSS:未使用トークン、値の不一致、孤児変数 |
/flow consistency |
追跡可能性 | カードが主張し契約インターフェースが serve するすべてのPRD FRn、数値の成功指標、残ったプレースホルダなし |
契約ゲートの後、カードを切る前に consistency と coherence を実行する。記述する面のビルド中に contract と tokens を実行する。
/flow design <file> はプロジェクト横断の掃引ではなく、単一UIファイルへの関連する機械チェックだ。
記述とタイミング:README.md
耐久層と知識
Section titled “耐久層と知識”| コマンド | 動作 |
|---|---|
/flow harness <args> |
耐久層CLIへのパススルー:intake、story、trace、decision、backlog、query、audit、propose、さらにinit、tool、intervention、promote-suggest、rollup、usage、prune、graph、journal。 |
/flow promote <file> |
プレイブックをクロスプロジェクトのナレッジベース ~/.claude/flow/playbooks にコピーする。 |
/flow usage [--global|--prune] |
ローカルJSONL使用ログをビルド分析に集計する:サイクルタイム、ゲート失敗率、ステージ・カードごとのdwell、コマンド内訳。ローカルのみ。 |
/flow retro |
3つのレトロ質問を出力する。行を書くのはオペレータであり、エージェントではない。 |
ハーネスサブコマンド
Section titled “ハーネスサブコマンド”/flow harness <args> は耐久層へのパススルーだ。セッションを越えて生き残るものを蓄えるflow所有のPythonとSQLiteのCLI。
| サブコマンド | 用途 |
|---|---|
intake |
タイプ・要約・フラグ付きで入ってきた要求を記録する。authのようなリスクフラグはレーンを自動昇格させる |
story |
作業単位とその証拠を追跡する。story complete --proof-source … で完了させる |
trace |
カードチェック通過時に書かれるtier採点済み記録 |
decision |
決定を記録し、後に実際の結果でループを閉じる |
backlog |
propose が書き込む改善backlog |
query |
記録を読み戻す |
audit |
蓄積された記録のエントロピーとドリフトを採点する |
propose |
反復する摩擦と介入をbacklog項目に掘り起こす。決定的で、2回以上の発火で動く |
init |
ハーネスデータベースを作成・更新する |
tool |
kind別のインバウンドツール・能力レジストリ |
intervention |
人間・レビュアー・CI・エージェントの上書きを記録する |
promote-suggest |
反復する摩擦と介入からプレイブック案を起草する |
rollup |
JSONL使用シンクを使用ストアに取り込む(冪等) |
usage |
使用ストアから使用分析を出力する |
prune |
各JSONLシンクを末尾N行に切り詰める(クラッシュセーフ) |
graph |
グラフ実行器:ジャーナル項目の記録・進行 |
大半はエンジンがあなたのために書く——ステージの進行がintakeを生み、通過したチェックがtraceを記録する——手動の面はほぼ読み取りだ。この層は任意だ:python3 がなければゲートは動き続け、このストアだけ無効になる。
スキーマ、フラグ、ライブ権威表:skills/flow/harness/README.md
| コマンド | 動作 |
|---|---|
/flow eval [--stage 01|02|05|card|routing|converge] [--fixture <id>] [--n 3] [--timeout <s>] |
意味ゲートの行動的証拠:モデルは中身がなく機械的にはクリーンなfixtureに実際に旗を立てるか?任意で課金。claude CLIがなければゼロ呼び出しでクリーンスキップする。 |
/flow eval --report |
オフライン、ゼロ呼び出し:最後の完全バッチのスコアカードと前バッチとの漂流。 |
/flow eval --replay |
保存済みfixtureのキーレス再生——モデル呼び出しなし。欠落・古いfixtureはexit 1。評決はevalフロアに数えない。 |
/flow eval --diff <old> <new> |
オフラインのfixtureリグレッション分類器:2バッチをベースラインと比較する。 |