DubeyDivyansh/opencut-studio

OpenCut Studio — Agent Engineering Guardrails

1. Deterministic Frame Math Only:

   • Inside src/remotion-engine/, NEVER use CSS @keyframes, transition, requestAnimationFrame, or setTimeout.
   • Always compute positions, scales, opacities, and 3D rotations from const frame = useCurrentFrame() and const { fps } = useVideoConfig() using interpolate() or spring().

2. Hybrid Local Scratch + Google Drive Storage Discipline:

   • Never store raw video ArrayBuffer blobs inside localStorage or IndexedDB.
   • Active editing reads directly from localFsManager.ts (FileSystemDirectoryHandle).
   • Long-term persistence and cross-device sync use googleDriveClient.ts (uploadType=resumable for media, multipart JSON for StyleDNA and EditPlan).

3. Zero-Cost Offline Resilience:

   • Every AI feature (styleAnalyzer.ts, feedbackCompiler.ts) MUST include a deterministic fallback implementation so the user can test and use every feature even before entering an Ollama URL or Google AI Studio API key.