Web UI検証支援
tools/web-uxは、実際のWeb画面とブラウザの診断を同じ条件で採取する開発用ツールである。製品のSkill・FlowやRuntime権限は追加しない。合否は目視確認の規則に従って実装者が判断する。
入口はcli.ts、採取条件はscenarios/、保存証拠の構造はsrc/types.tsに置く。撮影・認証fixture・プロセス管理の理由は対応するsrc/のコメントで管理する。
維持規則
- scenarioは利用者の具体的な判断とデータ状態を定める。権限差・幅・themeは変更の契約を確認する範囲で選ぶ。
- readinessは画面または応答で確認し、固定sleepで推測しない。本番と異なるCSSやshellを撮影用に作らない。
- 認証状態と成果物を分離し、scenario・引数・成果物に秘密の値を含めない。
- PlaywrightとNixで固定するbrowserの対応を、toolchain変更として同時に検証する。
- 変更時は
deno.jsonのcheck・testと必要なbrowser testを選ぶ。scenario変更では実際の画像とreview-context.jsonを確認する。browser testの成功を目視の代わりにしない。