概要
Refrain は、3フェーズのパイプラインでブラウザ操作を自動化します。- 生成 — AI が Web アプリを探索し、手順書を構築します。
- 実行 — 手順書を決定論的に再生します。AI コストはゼロです。
- 自動修復 — UI が変わったとき、AI が障害を診断し修正を提案します。
フェーズ 1: 生成
generate コマンドは URL とゴールを受け取り、AI が Web アプリを探索して手順書を構築します。
1
AI がブラウザを開く
開始 URL に移動し、ページのスナップショットを取得します。
2
AI がページを探索
ゴールとページの状態に基づいて実行するアクション（クリック、入力、ナビゲーションなど）を決定します。各アクションはステップとして記録されます。
3
停滞検出
AI がループにはまったり進捗がなくなった場合、ユーザーにガイダンスを求めます。探索中いつでも手動で介入することもできます。
4
AI がステップをレビュー
ゴール達成後、AI が全記録ステップをレビューし、不要なステップを除去、リスクのあるアクションに承認フラグを付与します。
5
手順書を出力
全ステップ、セレクタ、変数、設定を含む構造化された手順書ファイルが出力されます。
フェーズ 2: 実行
execute コマンドは生成された手順書を再生します。セレクタは決定論的に解決されるため、再実行時に AI トークンは消費されません（フォールバック時は除く）。
1
手順書を読み込み変数を解決
変数はシークレット、コンテキスト、環境変数、対話プロンプトから解決されます。
2
各ステップを実行
各ステップで多層的なセレクタ解決を使い要素を特定し、アクション（クリック、入力、ナビゲーションなど）を実行します。
3
承認を処理
承認が必要とマークされたステップでは実行を一時停止し、CLI、Slack、Teams、または Discord での確認を待ちます。
4
結果をレポート
各ステップの成功/失敗を表示するサマリーが出力されます。スクリーンショットや通知もオプションで利用可能です。
フェーズ 3: 自動修復
操作対象アプリの UI が変わってステップが失敗するようになったら、--self-heal で AI による診断を有効にします。
1
強化された実行
自動修復モードでは、アグレッシブなリトライ戦略、セレクタキャッシュ、Agent Fallback、Vision Fallback が自動的に有効になります。
2
エラー分類
各失敗が 6つのカテゴリのいずれかに分類され、修復戦略の方向性が決まります。
3
AI による修正提案
AI が失敗ステップを分析し、2種類の提案を生成します：手順書修正（セレクタ変更、ステップ追加）とコンテキスト修正（ページ構造変更の記録）。
4
修正を適用
fix-runbook コマンドで AI の提案をレビューし、手順書に適用します。主要な設計原則
- 再現性 — 同じ手順書は毎回同じ結果を生み出します。
- 再実行コストゼロ — 決定論的な実行により、再実行時の AI トークンはゼロです。
- ヒューマン・イン・ザ・ループ — 承認ワークフローにより、リスクのある操作を人が確認できます。
- 自己維持 — UI が変わっても AI が手順書を自動メンテナンスします。
次のステップ
手順書を生成する
手順書生成のステップバイステップガイド。
手順書を実行する
生成した手順書の実行方法。
自動修復モード
壊れた手順書を自動的に診断・修正。