ブラウザテスト後のクリーンアップ

.agents/workflows/testing-cleanup.md

@@ -0,0 +1,78 @@
+---
+description: ブラウザテスト後のクリーンアップ手順
+---
+
+# ブラウザテスト後のクリーンアップ
+
+ブラウザサブエージェントを使ったテスト実施後、必ず以下のクリーンアップを行うこと。
+
+## ルール
+
+1. **テスト関連ファイルはすべて `testing/` フォルダ以下に保存する**
+   - スクリーンショット → `testing/screenshots/<カテゴリ>/`
+   - 録画（.webp） → `testing/recordings/`
+   - テスト結果レポート → `testing/test_report.md`
+   - サブエージェントが自動生成した一時ファイル → `testing/subagent_generated/`
+
+2. **プロジェクトの既存ファイルを変更しない**
+   - ブラウザサブエージェントは内部的に Playwright を使っており、以下のファイルを勝手に生成・変更することがある：
+     - `frontend/playwright_*.mjs`（テストスクリプト）
+     - `frontend/e2e/`（テストディレクトリ）
+     - `frontend/test-results/`（テスト結果）
+     - `.gitignore`（追記されることがある）
+     - `docker-compose.yml`（`WATCHPACK_POLLING` が追加されることがある）
+     - `frontend/src/` 内のソースコード（稀に変更されることがある）
+
+## テスト終了後のクリーンアップ手順
+
+// turbo-all
+
+### 1. git で変更されたファイルを確認する
+
+```powershell
+git diff --name-only
+```
+
+### 2. サブエージェントによる既存ファイルの変更を元に戻す
+
+```powershell
+# 典型的な復元対象
+git checkout .gitignore
+git checkout docker-compose.yml
+git checkout frontend/src/ 2>$null
+git checkout frontend/tsconfig.tsbuildinfo 2>$null
+```
+
+### 3. サブエージェントが生成した一時ファイルを `testing/subagent_generated/` に移動する
+
+```powershell
+$project = "C:\Users\akira\Develop\keinasystem_t02"
+$dest = "$project\testing\subagent_generated"
+New-Item -ItemType Directory -Force -Path $dest | Out-Null
+
+# playwright系ファイル
+Get-ChildItem "$project\frontend\playwright_*.mjs" -ErrorAction SilentlyContinue | Move-Item -Destination $dest -Force
+
+# e2eフォルダ
+if (Test-Path "$project\frontend\e2e") { Move-Item "$project\frontend\e2e" "$dest\e2e" -Force }
+
+# test-resultsフォルダ
+if (Test-Path "$project\frontend\test-results") { Move-Item "$project\frontend\test-results" "$dest\test-results" -Force }
+```
+
+### 4. git管理に追加されてしまったファイルを除外する
+
+```powershell
+git rm --cached "frontend/e2e/*" 2>$null
+git rm --cached "frontend/test-results/*" 2>$null
+git rm --cached "frontend/playwright_*.mjs" 2>$null
+```
+
+### 5. 最終確認
+
+```powershell
+# testing/ 以外に未追跡・変更ファイルがないことを確認
+git status --short | Where-Object { $_ -notmatch "testing/" }
+```
+
+上記の結果が空であればクリーンアップ完了。