В эксплуатации SF4 чаще всего “ломается не код”, а окружение вокруг него: права записи, кэширование и порядок подключения ассетов.

Что важно держать как регламент:

• Права на запись: всё, что SF4 или админ-инструменты могут сохранять в файлы, упирается в права на {site_dir}/simai.data. Если права нет, поведение часто выглядит как “настройка в интерфейсе изменилась, а на сайте не применилось”.
• Кэш Bitrix: после изменения шаблонов, .property.php, подключений CSS/JS — очищайте кэш, иначе можно часами отлаживать “то, чего уже нет”.
• Кэш браузера: при правках CSS/JS проверяйте Network/DevTools и версионирование файлов (иначе браузер будет показывать старую сборку).
• Запись конфигов: многие конфиги сериализуются в PHP-файлы (через var_export). Это удобно и прозрачно, но плохо переносит “сложные объекты” и требует аккуратности при параллельной записи (две операции записи почти одновременно — типовой риск для файлового хранения).

Отдельный важный нюанс по ассетам: {site_dir}/simai.data/config/.asset.config.php в текущей реализации не используется — проектные CSS/JS подключайте через проектный шаблон (simai.data/template/...), а не через попытку “подменить реестр ассетов”.