e2e-live

name: e2e-live description: 実 Claude API を叩く総合テスト（全カテゴリ）を実行する。リリース前ではなく、定期的に手動で回して回帰を検出するための skill。`yarn dev` が起動済みであることが前提。

前提

yarn dev を別ターミナルで起動済み（http://localhost:5173 が応答する）
yarn dev は server を tsx server/index.ts（--watch なし）で起動するため、 server/*.ts や src/utils/html/previewCsp.ts 等 server に取り込まれるコードを変更した／ git pull で更新した直後は dev を必ず再起動してから走らせる。 stale dev のまま走らせると、ソース上は修正済の bug が再発したように見えて誤った issue 起票につながる（実例: PR #991 後の webkit L-01 fail → issue #1015、 dev 再起動だけで解消）
Claude 認証済み（claude login 済み or ANTHROPIC_API_KEY 設定済み）
e2e-live ディレクトリのテストは実 LLM を呼ぶため、API 利用枠を消費する

実行手順（Docker on / off 両モード）

mulmoclaude の Docker サンドボックス挙動はこのテスト群でカバーする品質の重要な軸なので、 両モードで回す こと。切替は dev サーバ再起動が必要なため Claude では自動化できない — 都度ユーザーに手順を案内する。

Step 1: 現在モードで実行

yarn test:e2e:live

Step 2: 結果を確認

進捗: ターミナル（list reporter）でリアルタイム表示
詳細: playwright-report-live/index.html（失敗時は自動オープン）
動画リプレイ: npx playwright show-trace test-results-live/<spec>/trace.zip
失敗時の動画: test-results-live/<spec>/video.webm

Step 3: 反対モードに切り替えてもらう

ユーザーに 明確に 次の指示を出す:

次は Docker を反対モード で回したいので、 dev サーバを再起動してください:

Docker off にする場合: いま起動中の yarn dev を Ctrl+C で停止 → DISABLE_SANDBOX=1 yarn dev

Docker on にする場合: いま起動中の yarn dev を Ctrl+C で停止 → yarn dev（こちらが既定）

起動が http://localhost:5173 で ready になったら教えてください。もう一度 yarn test:e2e:live を回します。

ユーザーの再起動完了通知を待つ。待ち中に勝手にテストを開始しない（古い dev サーバが残っていると ERR_CONNECTION_REFUSED か誤った結果になる）。

Step 4: 反対モードで再実行 + 統合サマリ

ユーザーから "再起動した" の合図がきたら、もう一度 yarn test:e2e:live を回す。両モードの結果（Pass / Fail カウント、違いがあったシナリオ）を 1 つのサマリにまとめてユーザーに返す。

デバッグ時（QA が画面で動作を見たい場合）

HEADED=1 yarn test:e2e:live

Chromium ウィンドウが開き、slowMo: 200ms で動作が目で追える。

失敗時の対応

各失敗はカテゴリ・シナリオ ID（L-01 〜 L-30）に紐づいている。plans/feat-e2e-live.md の Appendix に内部バグ ID（B-XX）との対応表があるので、回帰したバグを特定できる。

カテゴリ別の skill

特定カテゴリだけ走らせたい場合は以下を使用：

/e2e-live-media — 画像 / PDF / 動画
/e2e-live-roles — ロール別 sample query（未実装）
/e2e-live-session — セッション / 履歴（未実装）
/e2e-live-wiki — Wiki / Router（未実装）
/e2e-live-ui — UI / 通知 / プラグイン（未実装）
/e2e-live-skills — Skill / Tool（未実装）
/e2e-live-docker — Docker 環境特有（未実装）

カテゴリ別 skill は playwright-report-live/<category>/index.html に出力するので、親 /e2e-live の総合レポートは上書きされない。

name: e2e-live description: 実 Claude API を叩く総合テスト（全カテゴリ）を実行する。リリース前ではなく、定期的に手動で回して回帰を検出するための skill。yarn dev が起動済みであることが前提。

前提