インストールと初回実行

このチュートリアルが終わる頃、flow スキルはエージェントホームのディスク上にあり、エージェントは再起動済みで、ハーネスはステータス、次の一手、ゲート結果のいずれかで答えている。

時間：コマンド1つ、再起動1回、機械チェック1つ。任意の深掘り経路（バージョンとゲート拒否の記録）は約10分——深掘りであり、バーではない。

始める前に

Node.js 22.14以上と、支援されるコーディングエージェントが1つ必要だ（Claude Code、Codex CLI、Cursor、Antigravity、またはAgents home）。スキル自体も実行時に bash を要する——WindowsではGit Bashのことだ。python3 は推奨だが任意：なくてもゲートは動き、耐久SQLite層だけオフになる。

ステップ1 — インストーラを実行する

npx @manhquy/flow-skill@latest

スキル v0.34.4（インストーラ 0.7.11）には @latest を使う。ベアな npx @manhquy/flow-skill はnpxキャッシュから出て、静かに古いコピーを再実行することがある。

起きることは3つだ：

npmが現在のリリース済みインストーラをダウンロードする。
インストーラがこのマシンで検出したエージェントの対話型マルチセレクトを示す。
選んだすべてのホームにスキルツリーをコピーする（例：~/.claude/skills/flow）。

実際に使うエージェントを選ぶ。後でコマンドを再実行して追加もできる。

ステップ2 — エージェントを再起動する

スキルはディスク上のファイル群だ。エージェントは起動時にそのディレクトリを読む。再起動するまで、エージェントはスキルの存在を知らない。

エージェント	再起動後
Claude Code	`/flow` と入力
Codex CLI	一度再起動し、`$flow` と入力
Cursor / Agents home	ツールをリロードし、flowスキルを開く
Antigravity	IDEまたは `agy` を再起動し、`/flow`

ステップ3 — 環境をチェックする

bash ~/.claude/skills/flow/runner/flow.sh doctor

READY が欲しい。doctor はmacOS・Linux・Windowsを横断してbash、python、grep、gitをチェックする。python3 の欠落は耐久層を無効と報告する——縮退モードであり、失敗ではない。それ以外ならインストールが壊れたらへ。

Windows PowerShellでは bash の代わりに runner\flow.cmd を呼ぶ。PowerShellのベアな bash は大抵WSLに解決し、C:/... パスを読めず、動くインストールを壊れて見せる。

インストーラ対スキルのバージョン番号の確認は任意の深掘りだ。2つのバージョン番号を参照。

両方のバージョン番号を出力する

npx @manhquy/flow-skill@latest --help
# 期待：flow-skill v0.7.11 (ships skill v0.34.4)

インストーラは自身のバージョンと出荷するスキルのバージョンを出力する。次にディスクからスキルのバージョンを読む：

grep -E '^\s*version:' ~/.claude/skills/flow/SKILL.md | head -1

この2つの数字は独立に動く。このページから数字を写さない。

ステップ4 — 作りたいものを言う

動詞を覚える必要は決してない。fresh なエージェントセッションで、プロジェクトディレクトリで入力する：

「店の在庫管理アプリを作りたい。」

または /flow と入力する（Codexでは $flow）。

コンシェルジュは先にステータスコマンドを実行して機械的グラウンドトゥルースを取り、誰が成果物を起草すべきかの平易な同意確認を1つ聞き、正確に1つの次の一手を提案する。手入力の /flow 動詞はチャットルーティングに常に勝つ。

ルーティングはClaude上では信頼できる。CodexやAntigravityではチャットルーティングをベストエフォートとして扱い、動詞を入力すること。注意点の全文は日常ループ。

成功は次のいずれかだ：ステータス、次の一手、ゲート結果。「コンシェルジュがyesと言った」だけでは戦利品ではない。

今手に入れたもの

少なくとも1つのエージェントホームにインストールされたスキル。
スキルが見えるよう再起動されたエージェント。
1つのハーネスの答え：ステータス、次の一手、ゲート結果。

次

フルプロジェクトを歩くで実際のプロジェクトを全計画ゲートに通す。あるいは 2層ハーネスを読んで、何がファイルを裁くのかを理解する。

ゲートの拒否を見る

任意の深掘りだ。機械層が生きていることの決定的デモだ。ゲートで潰すことも正当だ。

空のIdeaファイルの記録

空ディレクトリを作り、そこでエージェントを開く。次に最初のステージを求める：

/flow next

ランナーは flow/00-idea.md を足場掛けし、即座にゲートチェックする。まだ何も書いていないので拒否する：

FAIL: gate for stage 00-idea is not clean.
  [x] unchecked gate boxes:
      L4:- [ ] The pitch below is 3 sentences, no more
  [x] unfilled [FILL] placeholders:
      L10:[FILL: sentence 1 — who has the problem]
Fix the above, then run '/flow next' again. (Kill at a gate is also valid.)

これがインストールの動作だ。機械層はファイルを読み、未チェックのボックスと未記入のプレースホルダを見つけ、行番号付きで非ゼロ終了した。代わりに埋めなかった。これからも埋めない。