DubeyDivyansh/opencut-studio

OpenCut Studio — 에이전트 엔지니어링 가드레일

1. 결정론적 프레임 수학만 사용:

   • src/remotion-engine/ 내부에서 CSS @keyframes, transition, requestAnimationFrame 또는 setTimeout을 절대 사용하지 마십시오.
   • 항상 const frame = useCurrentFrame()과 const { fps } = useVideoConfig()를 사용하여 위치, 크기, 불투명도 및 3D 회전을 계산하고 interpolate() 또는 spring()을 사용하십시오.

2. 하이브리드 로컬 스크래치 + Google Drive 스토리지 규율:

   • 원시 비디오 ArrayBuffer blob을 localStorage 또는 IndexedDB에 저장하지 마십시오.
   • 활성 편집은 localFsManager.ts(FileSystemDirectoryHandle)에서 직접 읽습니다.
   • 장기 저장 및 기기 간 동기화는 googleDriveClient.ts를 사용합니다(미디어는 uploadType=resumable, StyleDNA 및 EditPlan은 multipart JSON).

3. 비용 없는 오프라인 복원력:

   • 모든 AI 기능(styleAnalyzer.ts, feedbackCompiler.ts)에는 반드시 결정론적 폴백 구현이 포함되어야 하며, 사용자가 Ollama URL 또는 Google AI Studio API 키를 입력하기 전에도 모든 기능을 테스트하고 사용할 수 있어야 합니다.