Окружение облачного агента - это описание того, как из пустой машины получить рабочий проект. Cursor ищет его по порядку: сначала файл в репозитории, затем сохранённое личное окружение, затем командное. Такой порядок разумен: репозиторий - самое конкретное и самое проверяемое место, потому что его видно в ревью и оно едет вместе с кодом. Личное окружение при этом остаётся полезным черновиком, но пока описание живёт только у автора, воспроизводимости у команды нет.

Есть два пути подготовки. Рекомендуемый - дать агенту собрать окружение самому по описанию проекта. Продвинутый - собственный образ через файл сборки. Второй нужен, когда у проекта тяжёлые системные зависимости или жёсткие требования к версиям инструментов. Типичная ошибка при этом - копировать в образ весь проект: код всё равно будет получен заново на нужном коммите, а образ нужен для окружения, а не для исходников. Побочный эффект такой ошибки заметен не сразу - образ перестраивается на каждое изменение кода, и подготовка машины из быстрой становится долгой.

Полезно один раз увидеть цельное описание. Ниже - блок сборки с файлом образа и контекстом, команда установки зависимостей и генерации кода и команда запуска сервисов. Три поля - три разные роли, и путать их не стоит: установка готовит состояние диска, запуск поднимает процессы, сборка задаёт базовый образ. Проверить, что роли не перепутаны, просто: спросите про каждую строку, переживёт ли её результат выключение машины.

Главное требование к команде установки - идемпотентность. Она выполняется при создании сборки и должна давать один и тот же результат при повторном запуске. Сюда входят зависимости, генерация кода, компиляция и прогрев кэшей. Долгоживущие сервисы сюда не входят: их место в запуске или в терминалах, потому что сборка сохраняет состояние диска, но не сохраняет процессы, экспортированные переменные и содержимое памяти.

Это различение объясняет самый частый провал первой облачной задачи. Разработчик поднимает сервер в установочной команде, сборка успешно завершается, а агент потом не может достучаться до сервиса - процесс не пережил границу этапов. Симптом выглядит загадочно, причина проста: сохраняется диск, а не запущенное. То же правило объясняет и вторую по частоте загадку - переменную, экспортированную в установке и исчезнувшую к моменту работы агента.