動画編集標準ワークフロー
核となる順序：要件を聞く → 素材をすべて取得する → 1つずつ確認する → ナラティブに沿ってショットを選ぶ → 精密編集する → オーディオを調整する → 検証する → 完成作品のみを納品する。デフォルトでは、ダウンロードや中間ファイルをユーザーのローカルに置きません。
0. 作業開始前に一度で聞くこと
用途/プラットフォーム、画角（横 16:9 / 縦 9:16）、目標尺、テンポの速さ、オーディオ（BGMのみ/現場音/ナレーション）、字幕・タイトル、トーン・スタイル（ユーザーが決定し、フィルタは固定しない）。
1. 素材の取得（ユーザーのローカルストレージを消費しない）
素材はアシスタントの永続作業ディレクトリにダウンロードします。MCP for クラウドストレージは通常、ファイル管理のみでダウンロードやクラウド編集はできません。公式クライアントのシングルスレッド転送が通常最も高速かつ安定しており、ダウンロード監視と組み合わせて断点再開や低メモリ再起動を行います。ffprobe でファイル数と整合性を確認します。
2. 1つずつ確認し、見逃さない
各ファイルから複数のフレームを抽出してグリッドにし、すべてを確認します。シーン、照明、構図、使用可否・除外理由を注釈します。
3. ショットの選択（ナラティブ + 多様性）
感情の流れ：目を引くオープニング → 導入 → 展開 → クライマックス → 余韻を残すエンディング。遠近/明暗/水/橋/林/カーブ/広い景色を交互に配置し、同じようなものが連続しないようにします。ソースファイルと正確なイン点を記録します。
4. 精密編集
画角と fps を統一します。カラーグレーディングはユーザーのその時の要求に従い、全体に雰囲気を出し、ショットごとに調整可能で、フィルタは以前の値を使い回しません。スローテンポの場合はソフトなクロスフェードを使用します。低メモリ環境では処理を分割し、中断しても冪等に再開できます。
5. 字幕（ユーザーが必要な場合のみ）
細字の白文字にソフトな影、フェードイン・フェードアウト、風景を遮らない。日本語の場合は Noto CJK を使用。
6. オーディオ
BGMのみ：現場音を破棄し、尺を合わせ、afade でフェードイン・フェードアウト、loudnorm でモバイル端末向けの快適なラウドネス（約 I=-16）に調整。
7. 圧縮とコンテナ
ターゲットビットレートを VBV で制御してファイルサイズを管理（粒状感が強い・雰囲気重視の場合はビットレートを緩和）。H264 + AAC、-movflags +faststart。
8. 検証
ffprobe で仕様確認。blackdetect で中間に黒フレームがないことを確認。フレーム抽出でカラーグレーディング、順序、欠けているショット、音楽の開始・終了を確認。破損しているクリップはやり直し。
9. 納品
present_files で完成作品のみを送信します。簡単な表で仕様と処理ポイントを説明します。フィードバックに基づいて反復し、毎回ユーザーが指摘した部分だけを修正します。
リソースナビゲーション
スクリプトは scripts/ にあります（実行権限は付与済み。指示に従ってパラメータを変更するだけです）：
make_grid.py：バッチでフレーム抽出・グリッド表示（ステップ 2）make_clips.py：クリップのトリミング + カラーグレーディング雰囲気調整、統一クリップを出力（ステップ 4、フィルタはサンプル値なので必要に応じて書き換え）join.py：xfade でソフトに接続 + 先頭末尾の黒フレーム、カスタムショット順序に対応（ステップ 4/7）verify_final.py：完成作品の仕様 + 黒フレーム + フレーム抽出による最終検証（ステップ 8）download_watchdog.sh：大容量ファイルのダウンロード監視、OOM 防止、自動再起動（ステップ 1）recover.sh：システムディスクリセット後のクライアント再インストール + ライブラリ補完（ステップ 1）
参考ドキュメントは references/ にあります（必要なときに読む）：
full-workflow.md：完全ワークフロー振り返り + 1回のツーリングvlogの実際のショットリスト、フィルタパラメータ、5回の反復経験troubleshooting.md：クラウドストレージ取得、低メモリ、システムリセット、ログイン、エンコーディングなど、すべてのハマりポイントと対処法
機密情報（アカウントクッキー、認証コード、電話番号）は、いかなるスクリプト、ドキュメント、ログにも記録しません。