| 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 の総合レポートは上書きされない。
