Astra DS video — instructions for AI agents (AGENTS.md)

Источник: ds-internal/presentations/component-video-skill/AGENTS.md — вход для агентов без поддержки скиллов, часть скилла astra-component-video

When the user asks for a video in the Astra Design System style — «сделай видео по доработке <компонент>», «ролик о доработке», «видео-презентация», "make an Astra DS video" — read SKILL.md in this folder and follow it step by step. The skill is written in Russian; answer the user in the language they use.

Non-negotiable rules (details in SKILL.md):

Never edit the template: template/engine/, template/tools/, fonts, vendor scripts, the markup of index.html. A video is only videos/<name>.js plus images in assets/<name>/.
Never invent on-screen text, narration or numbers. Captions, tags, lists, the version and the narrator's lines come from the user, their script or the component changelog in Figma; every number needs a source. If missing, ask.
A narrated explainer longer than a minute starts with a storyboard deck for the author's comments (references/storyboard.md); voice is synthesized locally (references/voice.md) and checked with tools/voice_check.py. Texts follow references/infostyle.md.
Build only with node tools/build.mjs <name>; it validates the data, sets index.html, voices changed lines, synthesizes and mixes the music, lints, snapshots and renders. Look at the snapshots before rendering.
On a new machine run node tools/selftest.mjs first; it must end with «Всё совпало с эталоном».

Reference files: references/scenes.md (all scene fields and defaults), references/storyboard.md (script → storyboard → video by blocks), references/voice.md (narrator engines, install, settings, checks), references/infostyle.md (writing rules), references/figma.md (exporting frames from Figma), references/pitfalls.md (troubleshooting), references/engine.md (engine changes — only on explicit request).