Skip to content

SOP: Chrome DevTools 検証ループ

この SOP は、UI 作業が実際のランタイムでの操作に依存しており、 スクリーンショット、DOM 状態、コンソール出力がコードの検査単独よりも 重要な場合に使用します。

目標

UI 検証を、エージェントがジャーニーがクリーンになるまで実行できる 再現可能な操作ループに変換する。

コアループ

  1. 対象のページまたはアプリインスタンスを選択する。
  2. 古いコンソールノイズをクリアする。
  3. BEFORE 状態をキャプチャする。
  4. UI パスをトリガーする。
  5. 操作中のランタイムイベントを観察する。
  6. AFTER 状態をキャプチャする。
  7. 必要に応じて修正を適用し、アプリを再起動する。
  8. ジャーニーがクリーンになるまで検証を再実行する。

必要な入力

  • 安定した起動コマンド
  • 再現可能な UI ジャーニー
  • DOM、コンソール、またはスクリーンショットのスナップショットを取得する方法
  • 「クリーン」とみなされる基準のルール

実行 SOP

  1. アクティブな計画にターゲットジャーニーを記述する。
  2. 成功を観察可能な条件で定義する: テキストの存在、ボタンの有効化、エラーの消失、 コンソールのクリーン、リクエストの成功。
  3. 操作前に初期状態のスナップショットを取得する。
  4. 一度に正確に1つのパスをトリガーする。
  5. ランタイムイベント、DOM 変更、可視出力を記録する。
  6. ジャーニーが失敗した場合、最も責任のある最小のレイヤーを修正して再起動する。
  7. 同じパスを再実行し、BEFORE/AFTER の証拠を比較する。

クリーンの基準

  • 意図された可視状態が存在する
  • 予期しないエラーが存在しない
  • コンソールノイズが理解されているかクリアされている
  • 同じパスを再実行すると同じ結果が得られる

更新すべきリポジトリ成果物

  • アクティブな実行計画
  • ジャーニーがゴールデンパスになった場合の docs/RELIABILITY.md
  • 可視動作が変更された場合のプロダクト仕様