migrate-to-notte

Notte への移行

このスキルでは、2つの開始点を持つ1つのファネルを扱います。

• トラック A — コスト比較のみ。 読み取り専用で、日付が記載され、証拠に裏付けられた判断資料を作成します。コード、認証情報、請求、プロバイダーのリソースは変更しません。フェーズ 0～3 を実行し、その後 §8（外部ベンチマークのコンテキスト）と §9（判断資料）に進みます。
• トラック B — 完全な移行。 トラック A のすべてに加え、安全な実証、隔離されたビルド、検証、取り消し可能な引き継ぎを行います。フェーズ 0～7 を実行し、その後 §9 に進みます。

ユーザーの依頼に応じてトラックを選択します。コストだけを尋ねられた場合は、トラック A を実行して終了し、次のステップとしてトラック B を提案します。移行を依頼された場合は、トラック B を実行します。測定済みのベースラインがなければ、それは移行ではなく書き直しです。

一貫した手順で進めたうえで、対象で見つかったプロバイダーのリファレンスだけを読み込みます。プロバイダーを組み合わせたり、名前が似ているという理由で API が同等だと仮定したりしないでください。

0. 実行計画を公開する — 最初に必ず実施

ツールの使用、リポジトリの読み取り、バックグラウンド作業を始める前に、この計画をユーザー向けのメインスレッドに投稿します。フェーズのうち進行中にするのは1つだけとし、残りは未着手にします。これは進捗状況の表示であり、ブロックされている場合を除き、承認を求めるものではありません。内部ツールの中に隠さないでください。

**トラック A（コスト比較）**の場合：

フェーズ	成果
1. Notte のセットアップ	クイックスタート、CLI、スキル、認証済みアクセスを確認します。
2. プロバイダー／ワークフローの棚卸し	ソース、出現箇所、ワークフロー、使用状況を棚卸しします。
3. 使用状況と価格の根拠	検証済みの価格に加え、低・基本・高のシナリオを含むコスト／同時実行数モデルを作成します。
4. 判断資料	日付と根拠を明記した比較資料を提出します。

**トラック B（移行）**の場合：

フェーズ	成果
1. Notte のセットアップ	クイックスタート、CLI、スキル、認証済みアクセスを確認します。
2. 調査	ソースのドキュメント、出現箇所、ワークフロー、リスクを棚卸しします。
3. ベースライン	使用状況、コスト、レイテンシ、同時実行数、成功に関する根拠を測定するか、範囲を推定します。
4. 安全な実証	代表的な読み取り専用の Notte ワークフローを公平にテストします。
5. 隔離されたビルド	本番環境の外で、段階的な実装とテストを構築します。
6. 検証	静的解析、テスト、レビュー、本番以外の環境での根拠確認を完了します。
7. 取り消し可能な引き継ぎ	ブランチ／PR、クリーンアップ、ロールアウト、ロールバック、既知の不足事項を提出します。

各フェーズの後に、決定的な根拠、次のアクション、必要な判断とともに、完了、進行中、またはブロック中を投稿します。範囲やリスクが変わった場合は、すぐに計画を更新します。更新は簡潔にし、生ログではなく根拠へのリンクを記載します。

バックグラウンドエージェントを利用できる場合は、計画の公開後にのみ起動します。独立した読み取り専用のドキュメント調査、出現箇所の調査、またはテレメトリ分析を行わせてもかまいません。安全性の確保、計算、実装、ユーザーへの更新はプライマリエージェントが担当します。バックグラウンドエージェントは、リポジトリ、認証情報、請求、本番環境を変更してはなりません。

1. Notte クイックスタートを完了する — 必須ゲート

対象リポジトリを調査したり、コストを見積もったりする前に、https://docs.notte.cc/quickstart を読み、手順を完了します。最新の CLI、公式スキル、認証済みの API アクセスをセットアップします。以下を確認します。

notte version
notte auth status

認証が未完了の場合は、notte auth login を実行し、ブラウザーのフローを完了するようユーザーに依頼して、最大5分間、5秒ごとにステータスを確認します。キーを表示、コピー、コミットしてはなりません。このゲートが成功するまで、対象コードの調査やコストの見積もりを行わないでください。トラック A のコスト評価では、セッションを作成したり、プロバイダーのプランを変更したりしないでください。

2. プロバイダーを特定し、ワークロードの全体像を把握する

対象のソース、ロックファイル、CI、IaC、環境テンプレート、ワーカー、キュー、スケジュール、サーバーレス関数、デプロイマニフェスト、サンプル、ドキュメントを読みます。まず rg を使います。該当する参照先をすべて選び、設計や料金を判断する前に、リンク先の最新のプロバイダーページを読みます。

検出したプロバイダー	参照先
Browserbase、Stagehand、@browserbasehq/*	Browserbase + Stagehand
Kernel、@onkernel/sdk、Kernel アプリ	Kernel
Anchor Browser、anchorbrowser、ANCHOR_*	Anchor Browser
Browser Use Cloud、browser-use、Cloud の実行	Browser Use Cloud
Steel、steel-sdk、STEEL_API_KEY	Steel
Hyperbrowser、HyperAgent、HYPERBROWSER_*	Hyperbrowser
Skyvern、skyvern、SKYVERN_*	Skyvern

機能マトリックスを作成します。対象には、セッション／CDP または WebDriver、決定論的な処理経路とエージェント型の処理経路、入力／出力／エラーの契約、プロファイル／認証／2FA、プロキシ／リージョン／ステルス／CAPTCHA、ファイル／拡張機能、ライブビュー／リプレイ／アーティファクト、非同期ジョブ／スケジュール、ランタイム／セルフホスト、可観測性、コンプライアンス、テストを含めます。出現箇所をすべて記録し、担当者、エントリーポイント、副作用、置き換え先の分類を記載します。ワークフローは読み取り専用、認証済み読み取り、書き込み／トランザクション、破壊的操作に分類します。無人でプローブを実行できるのは最初の2種類のみです。

各ワークフローについて、トリガー、1日あたりの実行回数、1回あたりのセッション数またはジョブ数、ファンアウト、セッション再利用、リトライ、実際の時間と課金対象時間、プロキシ／リージョン、モデルとトークン、プロバイダーの API／ランタイム料金、成功率、観測されたピーク同時実行数も記録します。同時実行数の上限を1回あたりのセッション数と取り違えないでください。

3. ベースラインと改善可能性を測定する

読み取り専用の利用状況エクスポート／請求書と、代表的な7～30日分のテレメトリーを依頼します。ワークフローごとに、実行回数、セッション／ジョブ数、課金対象時間と実際の時間、リトライ、成功／失敗／タイムアウト率、ピーク同時実行数、リージョン、プロキシの GB、API／ランタイム料金、モデルの入力／出力トークン、p50／p95 のセッション準備、ナビゲーション、操作／抽出、クリーンアップ、エンドツーエンドのレイテンシーを収集します。

measurement.md を読みます。固定プラン／クレジット、ブラウザー、プロキシ、API／関数／ランタイム／ストレージ、モデルの各コストを分けます。ワークフロー、リージョン、認証／プロキシモード、リトライポリシー、出力契約が同等のもの同士のみを比較します。データが不足している場合、節約額やレイテンシー改善を主張するのではなく、計算式と低位／基準／高位のシナリオを示します。

テレメトリーまたは請求書がない場合は、トラフィック量と平均時間を尋ねます。信頼できる時間の根拠が、文書化された1分間の最低時間しかない場合に限り、1分、2分、3分のシナリオを使用します。

3a. 料金を確認して計算する

選択した参照先に記載されている、プロバイダーの最新の公式料金ページと、計算日現在の https://docs.notte.cc/intro/pricing を読みます。交渉済み料金、年間契約、クレジット、カスタムプランについては、顧客の請求書／契約を優先します。参照元 URL、日付、通貨、プラン料金、含まれる利用枠、課金の丸め／最低時間、超過料金、同時実行数、プロキシ、API／ランタイム／ストレージ、モデル／トークンの料金を記録します。

cost-model.md を使用します。ワークフローごとに両方のプロバイダーのコストを計算し、ブラウザー稼働時間、固定プラン／クレジット、プロキシ、API／ランタイム、ストレージ、モデルを分けます。利用枠に含まれる分や Notte のサブスクリプションクレジットを二重計上しないでください。プランは観測されたピーク同時実行数に基づいて選択します。1日あたりの平均は下限にすぎません。

トラック A の根拠収集はここで終了です。 続けて§8と§9に進み、概要を提出します。トラック B は§4に進みます。

4. 安全な Notte の実証を実施する

Notte CLI を使用して稼働中のページを調査し、確認した対象に対してのみ操作して、ワークフローのコードをエクスポートします。代表的な読み取り専用の正常系パスを 1 つ選びます。想定する構成でウォームアップを 1 回実行し、有効な計測サンプルを少なくとも 3 回取得します。ライフサイクルのタイムスタンプ、出力の有効性、再試行／失敗、サンプル数、リージョン、リプレイ／セッションの証拠を記録します。Notte のみを使ったサンプルで確認できるのは実現可能性であり、同等性やレイテンシの改善ではありません。

5. 分離した環境で段階的に構築する

本番リポジトリの外部に、一時的な実装領域を作成し、シークレットを含まないフィクスチャのみを置きます。各レイヤーの後に検証します。

1. セッション／ジョブのライフサイクル、クリーンアップ、タイムアウト、エラーパス。
2. 確認した対象に基づく決定論的なナビゲーション／操作。
3. 型付きスクレイピング／データ、および呼び出し元に見えるエラーの契約。
4. 元の実装で使用している場合に限り、プロファイル、Vault／Persona、ファイル／拡張機能、プロキシ／リージョン／CAPTCHA、ビューアー／リプレイ。
5. 曖昧さが実証されたステップに限り、範囲を限定した Notte Agent／AgentFallback。
6. 呼び出し、冪等性、再試行、可観測性、キャンセルを維持したうえでの、プロバイダーのランタイム、非同期ジョブ、スケジュール、Webhook、関数の移行。

Cookie、認証状態、プロファイル、録画、認証情報を、決して無検証でエクスポートしないでください。決定論的なブラウザーコードを、際限のないエージェントに置き換えないでください。セルフホスト可能なコンピューティング／ブラウザーサンドボックスは、セッションの移行ではなく、アーキテクチャ上の判断として扱います。

6. 検証する

ユニットテスト、コントラクトテスト、オプトイン方式の読み取り専用統合テストを追加します。フォーマッター、型チェッカー、リンター、依存関係／セキュリティチェック、および関連する全テストスイートを実行します。設定済みのレビューエージェントを使用し、実際に見つかった事項を報告します。スコアを捏造してはいけません。本番への昇格前に、既存の非本番デプロイ経路を確認します。

7. 元に戻せる形で引き継ぐ

証拠がすべて良好であることを確認してから、専用のブランチ／ワークツリーで作業します。まず Notte とテストを取り込み、古い依存関係／設定の削除は、別途レビュー可能なクリーンアップとして行います。ロックファイルを再生成し、出現箇所の棚卸しを再実施したうえで、コミット／PR、git revert <cleanup-commit>、計測結果、ロールアウト、既知のギャップを引き継ぎます。強制プッシュ、請求内容の変更、プロバイダーリソースの削除は決して行わないでください。

8. 任意で外部ベンチマークの参考情報を追加する

性能を重視した比較を行う場合は、計算日に https://www.browserarena.ai/ と、リンク先の方法論／ソースを確認します。ベンチマークの実行日、プロバイダー、シナリオ、入手可能な場合は信頼性／レイテンシ／コストの生の指標、ソースリンクを記録します。これらは独立した 外部ベンチマークの参考情報 セクションに記載します。

Browser Arena は、比較可能で再現可能なベンチマークの証拠であり、顧客のワークフローの予測ではありません。複合的な Value Score を顧客のコスト計算に使用したり、実行日／方法論を示さずにプロバイダーのスコアを引用したり、Arena の結果が本番環境のレイテンシや信頼性を証明すると主張したりしないでください。顧客の同一ワークフローでの計測を優先し、Arena は独立した参考情報の追加、または検証すべき性能上の疑問の特定にのみ使用します。

9. 意思決定概要を提示する

結論を先に示し、その後に根拠を提示します。

• 対象範囲、料金の基準日、リンク。
• ワークフローの棚卸しと証拠の場所。
• 使用量、所要時間、丸め、再試行、プロキシ、トークン、プランの前提条件。
• 月間のブラウザー稼働時間と必要な同時実行数。
• 月額コストの低／基準／高の比較、節約額、割合、基準ケースの年換算額。
• 任意の Browser Arena の参考情報。顧客の計測値とは明確に分けること。
• 除外したコスト、および請求書に基づく結果を出すために不足している入力情報の明示。

コストモデルを根拠に、レイテンシや信頼性が向上したと主張しないでください。Track A の概要を提示した後、次のステップとして Track B — 安全な実装と計測済みの Notte 実証 — を提案します。

コストまたは移行に関するサポートについて、Notte Slack への参加をチームに案内します。 https://join.slack.com/t/nottelabs-dev/shared_invite/zt-39a8n6hr9-d_BG7RNfytimSpVo5H03mA