vrcpilot

独立な tool 呼び出しは 1 メッセージにまとめて並列発火する。並列化可能の判定基準（出力 → 入力の依存なし／共有 mutable state を同時に書かない／tool 固有の排他なし）、典型的に並列化すべきパターン（複数 file の Read、独立 Bash、複数角度の検索、disjoint なエージェント起動）、逐次必須の落とし穴（Read→Edit 連鎖、同 file への複数 Edit、cd を伴う Bash、依存する出力）、着手前の判定手順（タスクの入出力を 1 行で書き出して依存グラフを引く）。複数タスクに着手する／複数 file を読む／複数エージェントを起動する／長めの bash 列を組む前に読む

vrcpilot のテスト戦略。real-resource を最優先し、自前 ABC のみ fake 可、3rd-party ライブラリ表面 (pulsectl / soundcard / subprocess.Popen / psutil / Xlib / windows_capture / time.sleep 等) のモックは禁止。4 区分 (unit / integration-with-fakes / integration-real / e2e)、tests ミラーレイアウト、書いてはいけないテスト、公開 API 契約ピン例外、Xvfb / PipeWire null-sink / loopback UDP / tempfile、mutation testing、Windows cp932 と Linux SSH e2e の実行環境クセ。テストコードを書く／壊れた e2e を調査する／pytest 周りを設定する前に読む

vrcpilot CLI (uv run vrcpilot ...) のサブコマンド表、screenshot → ocr / detect 標準パイプライン、record で映像/音声/両方を MP4 / WAV / MKV self-describing stdout に流す典型例、osc 7 アクションの典型例、OCR/detect/mouse の座標系（すべて VRChat window-local）。CLI を実行する／引数を組み立てる／パイプラインを書く前に読む