DubeyDivyansh/opencut-studio

OpenCut Studio — Diretrizes de Engenharia para Agentes

1. Apenas Matemática Determinística de Frames:

   • Dentro de src/remotion-engine/, NUNCA use @keyframes, transition, requestAnimationFrame ou setTimeout do CSS.
   • Sempre calcule posições, escalas, opacidades e rotações 3D a partir de const frame = useCurrentFrame() e const { fps } = useVideoConfig() usando interpolate() ou spring().

2. Disciplina de Armazenamento Híbrido Local + Google Drive:

   • Nunca armazene blobs ArrayBuffer de vídeo bruto dentro de localStorage ou IndexedDB.
   • A edição ativa lê diretamente de localFsManager.ts (FileSystemDirectoryHandle).
   • A persistência de longo prazo e a sincronização entre dispositivos usam googleDriveClient.ts (uploadType=resumable para mídia, JSON multipart para StyleDNA e EditPlan).

3. Resiliência Offline Sem Custo:

   • Cada funcionalidade de IA (styleAnalyzer.ts, feedbackCompiler.ts) DEVE incluir uma implementação de fallback determinística para que o usuário possa testar e usar todos os recursos mesmo antes de inserir uma URL do Ollama ou uma chave de API do Google AI Studio.