概要
Refrain は、3フェーズのパイプラインでブラウザ操作を自動化します。- 生成 — AI が Web アプリを探索し、手順書を構築します。
- 実行 — 手順書を決定論的に再生します。AI コストはゼロです。
- 自動修復 — UI が変わったとき、AI が障害を診断し修正を提案します。
フェーズ 1: 生成
generate コマンドは URL とゴールを受け取り、AI が Web アプリを探索して手順書を構築します。
フェーズ 2: 実行
execute コマンドは生成された手順書を再生します。セレクタは決定論的に解決されるため、再実行時に AI トークンは消費されません（フォールバック時は除く）。
各ステップを実行
各ステップで多層的なセレクタ解決を使い要素を特定し、アクション（クリック、入力、ナビゲーションなど）を実行します。
フェーズ 3: 自動修復
操作対象アプリの UI が変わってステップが失敗するようになったら、--self-heal で AI による診断を有効にします。
エラー分類
各失敗が 6つのカテゴリのいずれかに分類され、修復戦略の方向性が決まります。
主要な設計原則
- 再現性 — 同じ手順書は毎回同じ結果を生み出します。
- 再実行コストゼロ — 決定論的な実行により、再実行時の AI トークンはゼロです。
- ヒューマン・イン・ザ・ループ — 承認ワークフローにより、リスクのある操作を人が確認できます。
- 自己維持 — UI が変わっても AI が手順書を自動メンテナンスします。