git:20261103.325e290 to git:20261104.00e047d

- # CLAUDE.md

-

- Marketing videos, reels, ads and posts made with code, using the **Reel Studio** kit

- (<https://github.com/murathany7/reel-studio>). One deterministic renderer, several engines on one clock, one folder

- per brand, one folder per production.

-

- ## Where to look

-

- | Question | Skill / file |

- |---|---|

- | Making a video, reel, ad or post | `make-video` skill, then the brand folder |

- | A new brand | `new-brand` skill |

- | Which engine for a look | `pick-engine` skill and `engines/README.md` |

- | 3D (Three.js, Blender) | `scene-3d` skill |

- | A cartoon character or mascot | `character-2d` skill |

- | Recording a brand's live website | `capture-site` skill |

- | *Optional:* the person reviews in the desk (frame notes, approvals) | `review-desk` skill, `desk/README.md` |

- | Render, audio and QA commands | `core/README.md` |

- | What is in progress, decided, learned | `STATUS.md` |

-

- | Path | What |

- |---|---|

- | `core/` | `render.mjs` (HTML → MP4/PNG), `lib/runtime.js` (the `Studio` clock), `lib/base.css` |

- | `engines/` | One adapter per engine |

- | `desk/` | *Optional* review app (`node desk/server.mjs`): frame notes, renders, approvals. Nothing else depends on it |

- | `scripts/` | Audio mix, transcription, video QA, frame tools |

- | `brands/<slug>/` | Facts and their sources, look, voice, `compliance.md` (start from `brands/_template`) |

- | `productions/<brand>/<ID>-<slug>/` | One piece (start from `productions/_TEMPLATE`) |

-

- ## Golden rules

-

- 1. Read `STATUS.md` before starting and update it before finishing.

- 2. Brief → storyboard → **approval** → production → **frame-by-frame QA** → delivery. No production before approval.

- 3. Never invent product facts, numbers or testimonials. Every claim traces to a source in the brand's README.

- 4. Every piece passes its brand's `compliance.md`. Brands never borrow each other's look, facts or voice.

- 5. Every frame is a pure function of `t` (rules in `engines/README.md`). If two renders of a frame differ, it is a bug.