DubeyDivyansh/opencut-studio

OpenCut Studio — エージェントエンジニアリングガードレール

1. 決定論的フレーム演算のみ:

   • src/remotion-engine/ 内では、CSS @keyframes、transition、requestAnimationFrame、setTimeout を絶対に使用しないでください。
   • 位置、スケール、不透明度、3D回転は常に const frame = useCurrentFrame() と const { fps } = useVideoConfig() から計算し、interpolate() または spring() を使用してください。

2. ハイブリッドローカルスクラッチ＋Google Driveストレージの規律:

   • 生の動画 ArrayBuffer ブロブを localStorage や IndexedDB に保存しないでください。
   • 編集中のアクティブな読み取りは localFsManager.ts（FileSystemDirectoryHandle）から直接行います。
   • 長期的な永続化とデバイス間同期には googleDriveClient.ts を使用します（メディアには uploadType=resumable、StyleDNAとEditPlanにはマルチパートJSON）。

3. ゼロコストオフラインレジリエンス:

   • すべてのAI機能（styleAnalyzer.ts、feedbackCompiler.ts）には、Ollama URLやGoogle AI Studio APIキーを入力する前でもユーザーがすべての機能をテスト・利用できるように、決定論的なフォールバック実装を必ず含めてください。