AlexandrAI AGENTS.md
agents-md

make-video2 Remotion Template Agent Guide

Project-specific AGENTS.md guidance for the make-video2 Remotion template project, Root, Scene, timeline, assets, design system, metadata, and render contracts.

AGENTS.md

Guidance for coding agents working on the make-video2 Remotion template project.

Project Overview

The Remotion template under video-agent-team is the reusable rendering project for generated videos. It owns scene composition, timeline logic, asset loading, metadata calculation, design-system tokens, font stack, and typed scene contracts.

Use this guide when changing the template itself rather than the higher-level multi-agent video planning workflow.

Project Map

  • .claude/template/remotion-project/package.json defines the Remotion project package.
  • .claude/template/remotion-project/src/Root.tsx registers compositions.
  • .claude/template/remotion-project/src/Scene.tsx renders scene content.
  • .claude/template/remotion-project/src/timeline.ts defines timing behavior.
  • .claude/template/remotion-project/src/scene-layout.ts handles layout choices.
  • .claude/template/remotion-project/src/assets.ts loads render assets.
  • .claude/template/remotion-project/src/design-system.ts and font-stack.ts define visual constants.
  • .claude/template/remotion-project/src/calculate-metadata.ts computes composition metadata.
  • .claude/template/remotion-project/src/types.ts defines scene contracts.

Setup Commands

bashnpm install
npm run build

Run commands from the template project root. Keep generated output projects separate from the template source.

Change Rules For Agents

  • Keep Root composition registration and scene type contracts synchronized.
  • Keep timeline math deterministic and frame-based.
  • Keep asset references local to the generated project or template.
  • Do not fetch external scripts, fonts, or images at render time unless the workflow explicitly owns that dependency.
  • Keep design-system constants centralized.
  • Avoid hardcoding one video topic into the reusable template.
  • Verify generated projects after template changes.

Verification

bashnpm run build

Render or preview at least one generated sample before shipping template changes.

Security Notes

Video projects can include source media and generated scripts. Do not publish private assets, local paths, API keys, or unreleased client names in template examples.

PR Checklist

  • Template build passes.
  • Scene contracts and Root registration match.
  • Timeline changes are deterministic.
  • Sample generated project still renders.