Советы и лучшие практики

Инструкции и CLI для агента

• Focused-инструкции: обычно полезны runtime — Promto Runtime Rules, tech_stack — Promto Tech Stack Rules, dev_servers — Promto Dev Server And Preview Rules и ui_markers — Promto UI Markers And User-Facing Paths. Для GitHub, GitLab или Bitbucket добавьте git — Promto Git Integration Rules.
• Trusted tools основного агента: get_instruction, promto_port, promto_preview, а для проверки реальной квоты диска — promto_disk.
• CLI внутри рабочего пространства: git, rg и только существующие команды test/build из конфигурации проекта. В профессиональном терминале Promto helpers доступны через promto port, promto preview и promto disk.
• Не просите агента использовать предполагаемый инструмент «по привычке»: сначала он должен проверить структуру проекта и доступные scripts.

Полный каталог focused-инструкций

Обычный агент загружает каждую инструкцию отдельным встроенным вызовом get_instruction с одним из перечисленных ниже значений параметра topic.

Topic	Точное название	Когда загружать
runtime	Promto Runtime Rules	Файлы, команды, зависимости и общие правила среды
tech_stack	Promto Tech Stack Rules	Выбор или проверка стека проекта
dev_servers	Promto Dev Server And Preview Rules	Запуск, перезапуск и диагностика Preview
ui_markers	Promto UI Markers And User-Facing Paths	Перед Preview:, OpenFile:, OpenDesign:, Publish: или Addon:
design	Promto Design Instructions	Дизайн-HTML, макеты, UI kit, постеры и первый визуальный вариант
mobile	Promto Mobile And Expo Instructions	Expo, React Native, Android, мобильное Preview, APK и AAB
html_presentations	Promto HTML Presentation Instructions	HTML-презентации; вместе с topic design
git	Promto Git Integration Rules	Clone, import, push и приватные репозитории
publish	Promto Publish Capability	VM, add-ons, домены, DNS, HTTPS и публикация

Встроенные tools и terminal CLI

Обычный агент: trusted tool	Профессиональный терминал	Назначение
get_instruction	promto instructions; отдельно promto publish get-instruction и promto mobile instructions	Загрузить правила работы
promto_port	promto port	Найти, проверить или освободить Preview-порт
promto_preview	promto preview	Сделать снимок локального runnable-приложения
promto_browser	promto browser	Работать с общей облачной браузерной сессией
promto_asset	promto asset	Загрузить готовый файл и получить постоянный URL
promto_disk	promto disk	Проверить фактическую квоту и крупные каталоги
promto_screenshot	Отдельного CLI нет	Проверить публичный адрес после публикации
promto_design_validate	Отдельного CLI нет	Проверить совместимость *_design.html перед OpenDesign:

promto_screenshot и promto_design_validate нельзя вводить в shell: они существуют только как встроенные tools обычного агента. У terminal-агента нет универсальной команды promto get-instruction <topic>.

Готовый промпт для агента

Сначала изучи проект через rg и проверь git status. Через get_instruction загрузи runtime, tech_stack, dev_servers и ui_markers. Внеси только относящиеся к задаче изменения, запусти существующие тесты и сборку, затем проверь интерфейс через promto_preview. Не публикуй.

Как правильно ставить задачи агенту

Будьте конкретны

Агент работает лучше, когда задача чётко сформулирована. Вместо:

«Сделай приложение»

Попробуйте:

«Создай React-приложение — список задач с возможностью добавлять, отмечать выполненными и удалять задачи. Данные храни в localStorage.»

Указывайте технологии

Если у вас есть предпочтения по стеку, укажите их явно:

«Используй TypeScript, React 18, Tailwind CSS и Vite»

Разбивайте сложные задачи

Для большого проекта лучше идти итеративно:

1. Сначала создайте базовую структуру
2. Добавляйте функциональность по одной фиче
3. Просите агента рефакторить код по мере роста проекта

Работа с файлами

• Используйте файловый менеджер (иконка папки в интерфейсе) для просмотра структуры проекта
• Можно редактировать файлы вручную — агент учтёт ваши изменения
• Для крупных изменений в нескольких файлах лучше описать их агенту, чем редактировать вручную

Предпросмотр

• Предпросмотр обновляется автоматически при изменениях в коде (hot reload)
• Если предпросмотр завис — перезагрузите его кнопкой обновления
• Для мобильного предпросмотра уменьшите ширину окна браузера

Сохранение работы

• Весь код автоматически сохраняется в sandbox
• Для долгосрочного хранения подключите GitHub и попросите агента сделать commit и push
• Перед публикацией убедитесь, что все секреты (API-ключи) вынесены в переменные окружения

Частые вопросы

Агент написал неправильный код — что делать? Просто скажите, что именно не так: «Кнопка не работает» или «Нужно исправить дизайн заголовка». Агент внесёт правки.

Как вернуть предыдущую версию кода? Попросите агента: «Откати последние изменения» или «Восстанови файл X до предыдущей версии».

Можно ли работать с готовым репозиторием? Да! Подключите GitHub и скажите агенту: «Склонируй репозиторий https://github.com/...» — он скачает код и продолжит работу с ним.