preland/AGENTS.md

Инструкции агентов для preland

Область действия — репозиторий preland/. Общие правила рабочей области находятся в AGENTS.md и CLAUDE.md; канонический процесс и каталог ролей — в общей политике. Этот файл и CLAUDE.md содержат одинаковые локальные правила; обновлять их вместе.

Перед работой

• Прочитать README.md, заметку проекта, а для выката — .gitea/workflows/deploy.yml и единственный config.json.
• Проверить состояние ветки и чужие изменения в preland/; изменения API сайта согласовать с его контрактом и инструкциями api/.

Локальные ограничения

• Преленд — PHP без фреймворка и сборки; Yii::t реализован локальной заглушкой i18n.php. Сохранять существующие компоненты и передачу меток трафика на сайт.
• Загрузка идёт на POST /api/images/public/create с file и случайным client_key, переход — через /api/images/public/claim?key=…. Ключ одноразовый, срок 30 минут; переход напрямую на /public/upscale не заменяет передачу владельца через claim.
• host задаёт сайт назначения; HTTPS необходим для crypto.randomUUID(). Не обходить серверные правила доступа к загрузке и результату обработки.
• Рабочий config.json на каждом хостинге настраивает владелец. Деплой не имеет права перезаписывать его значений. При появлении новой обязательной UTM workflow получает текущий хостовый конфиг и меняет только ключи, которые прямо согласованы в задаче. Иные значения, включая уже настроенные UTM, остаются байт-в-байт прежними. Для #274 bin/ensure-focus-config.php — явное исключение: он задаёт только новый focus=face (default и rnd). После каждого такого выпуска фактический stage-config следует забрать и зафиксировать в Git. requisites.html также живёт только на хостинге и не перезаписывается. Не создавать target-specific конфиги или config.json.example.
• Коммит в staging запускает SFTP-автодеплой только на zoomstage.online; откат через git revert также запускает выкат. Коммит, push и изменения хостинга — только по прямому поручению.
• Проверки кода и браузера проводить в Docker без установки ПО на хост. Проверка загрузки по боевому адресу вызывает реальную обработку; выполнять её только в согласованном окружении, не публиковать ключи загрузок и FTP-секреты.

План, журнал и база знаний ведутся в корне рабочей области по общим правилам. Ссылки на политику и документацию не подключают MCP и не дают разрешения на публикацию или выкат.

Актуальная маршрутизация (19.10.2026, preland#4)

До отдельного поручения владельца выкатывать только staging → zoomstage.online. Production zoompixel.ru/.online не обновлять. preland.anton.barbariskatest.ru больше не используется, не является целью и не должен упоминаться как требующий выпуска. CI запускает только stage. Сохранение runtime config и stage-наборов /N/ обязательно. Работа и решения — через Gitea.