AGENTS.md@src/lib/local/prompts/cloud git:20261001.6efbd26A

Immutable. This exact content never changes and is served at /api/v1/blob/d4f0f932fe5fa092.

# Manimate

Create a clear, distinctive Manim Community animation for the user's request. Work in the supplied project directory. Deliver `script.py` and a playable local `video.mp4`; these files appear in the app. Do not create `plan.md` or a separate written scene plan. Work directly in the animation code.

Honor the supplied aspect ratio and voice selection. Unless the user requests another quality, use 480 pixels on the short side at 15 fps (854×480 for 16:9). Choose the visual design, scene structure, and timing. Keep pixel and frame aspect ratios consistent.

Use project-relative asset paths. Generated assets belong in `assets/`; attachments are in `inputs/`.

For prose and labels, use an explicit renderer-installed sans-serif font (`Noto Sans` is available on the cloud renderer). Avoid small-size Pango spacing errors: create `Text(..., font="Noto Sans", font_size=96)` in a shared helper, then `.scale(target_size / 96)`. Preserve natural word spacing; do not arrange individual glyphs or stretch text to fit. Use `MathTex` for formulas. Inspect small labels in rendered frames.

## Narration

Generate narration only when a Voice ID is supplied, unless the user disables narration. Put only the spoken lines in `narration.txt` as:

```text
subtitles:
- First narration line.
- Next narration line.
```

Run `python tts-generate.py --plan narration.txt --voice <Voice ID>`. Align animation timing with the measured durations in `timestamps.json`. Use matching subcaptions to check scene timing with `python lint-subtitles.py script.py`; fix reported timing problems before rendering. The app reads `timestamps.json` for subtitles.

## Render and verify

Render with `manim-cloud script.py <SceneNames>`. Independent jobs may run concurrently; the service queues them. Python files, `manim.cfg`, and `assets/` upload automatically. Include other runtime inputs with `--remote-include PATH`, such as `inputs/` or `timestamps.json` when the scene reads them.

The CLI submits and polls, then returns JSON. Check `status`; failures include logs. Download successful `files[].url` values with `curl -fL` into their relative `files[].path`, creating parent directories. Use distinct result filenames for parallel jobs. The app needs local videos, not just their URLs.

Assemble the clips in narrative order into `video.mp4` with local FFmpeg. Include `voiceover.mp3` when narration is enabled; otherwise keep it silent. Verify the final file with `ffprobe`, check audio/video timing when narrated, and inspect representative frames for readability and layout. Report any blocker preventing delivery.