SouVi Engine
souvi は PATH 上にあり、任意のディレクトリから実行できます。エンジンは /home/cptdawn/Kode/SouVi-Engine（以下 $SOUVI）にあります。souvi <コマンド> -h でフラグを確認、souvi presets で出力フォーマット、ルック、タイトルスタイル、トランジション、効果音の一覧を表示します。
ワークスペース
各成果物セットは $SOUVI 内のプロジェクトとして管理されます。
projects/<スラッグ>/—timeline.json（編集データ）とBRIEF.md（概要＋日付入りの決定ログ）assets/<スラッグ>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/— ソースファイル（変更不可）output/<スラッグ>/{drafts,renders,final,review}/— 結果（バージョン_vNNN、上書き禁止）
別リポジトリから呼び出す場合：スラッグはそのリポジトリのフォルダ名です（別の成果物が必要な場合は接尾辞を追加します。例：myapp-teaser）。メディアのインポートは souvi import <スラッグ> <ファイル…>（音楽以外の音声は --as voice|sfx、大きな映像は --link）、配信は souvi promote <レンダー> --to <呼び出し元リポジトリ内のフォルダ> を使用します。$SOUVI 内の Git は、ユーザーから依頼がない限り触らないでください。
並行エージェントでも安全です：各ジョブはプライベートフォルダで実行され、1つのプロジェクトのレンダリングはロックでキューイングされます。各エージェントの成果物には独自のスラッグを割り当ててください。
ループ
souvi new <スラッグ> --preset <配信形式>; 概要をBRIEF.mdに記述します。souvi import …、souvi assets <スラッグ>を実行し、すべての候補ソースに対してsouvi look <クリップ>を実行します。$SOUVI/docs/timeline.mdを読んだ後、timeline.jsonを記述し、souvi plan <スラッグ>がエラーなしで終了するまで繰り返します。souvi render <スラッグ> --draft（--gpu、--until N）でレンダリングし、レビュー、修正。souvi render <スラッグ>（QC が PASS するまで）、レビュー、souvi promote <レンダー> [--to …]。
レビュー — あなたは動画を視聴したり音声を聞いたりできないため、以下のコマンドで出力される PNG を読み取ります：souvi look <動画>（コンタクトシート、カット周辺の高密度シートには --from/--to）、souvi frame <動画> --at <時刻…>、souvi hear <ファイル>（スペクトログラム、波形、ラウドネス）。最終レンダリングがこのレビューと QC を通過した時点で作業完了です。
クラフト
クリエイティブな判断の前に、映像については video.md、音声については audio.md を読んでください。それぞれのレビューチェックリストのすべての項目を適用してください。
単一ファイルツール
export --preset、master、voice、sfx、reverb、stabilize、denoise、grade、retime、qc、loudness、probe。処理されたファイルはソースの隣に <名前>.<タグ>_vNNN.<拡張子> として配置されます。それ以外の場合、生の ffmpeg でも構いませんが、10ビット処理、lanczos スケーリング、BT.709 タグ、soxr リサンプリングを維持し、最後に souvi master でラウドネスを仕上げ、souvi export で配信用ファイルにエンコードしてください。