refactor: перенести сборку в проекты

- перенесены каноны и VitePress-конфиги в projects/<slug>

- добавлены корневой и проектные build.ts для сборки артефактов

- добавлены shared-библиотеки сборки в projects/_shared/lib

- обновлены CI, Dockerfile, package.json, gitignore и README

- удалена сборка frontend-агента

projects/template-sync-strategy/canons/reference/troubleshooting.md

@@ -0,0 +1,102 @@
+---
+title: Troubleshooting
+description: Типовые ошибки при обновлении проекта от шаблона и способы диагностики.
+---
+
+# Troubleshooting
+
+## fatal: отказ слияния несвязанных историй изменений
+
+Ошибка:
+
+```text
+fatal: отказ слияния несвязанных историй изменений
+```
+
+Причина: `master` приложения не был создан от `template`, поэтому у веток нет общего предка.
+
+Решение: выполнить одноразовую миграцию через `sync/bootstrap-template` по инструкции [Миграция существующего master](../setup/existing-master-migration.md).
+
+Коротко:
+
+```bash
+git switch -c sync/bootstrap-template origin/master
+git merge --allow-unrelated-histories origin/template
+git push -u origin sync/bootstrap-template
+```
+
+## --ff-only падает на template
+
+Ошибка возникает при команде:
+
+```bash
+git merge --ff-only templates/master
+```
+
+Причина: в `template` появились коммиты, которых нет в шаблоне. Значит ветка перестала быть чистым слепком.
+
+Что проверить:
+
+```bash
+git fetch templates
+git --no-pager log --oneline --graph --decorate templates/master..template
+```
+
+Решение зависит от причины. Не продолжайте обновление, пока не станет понятно, какие локальные коммиты попали в `template`.
+
+## Пустой diff в sync-ветке
+
+Симптом:
+
+```bash
+git --no-pager diff --stat origin/master...HEAD
+```
+
+не показывает изменений.
+
+Возможные причины:
+
+- в шаблоне нет новых изменений;
+- `origin/template` не был обновлён;
+- `origin/template` не был влит в `sync/*`;
+- sync-ветка создана не от актуального `origin/master`.
+
+Что проверить:
+
+```bash
+git fetch origin
+git fetch templates
+git --no-pager log --oneline -1 origin/template
+git --no-pager log --oneline -1 templates/master
+git --no-pager log --oneline --graph --decorate --all --max-count=50
+```
+
+## Случайно включили squash
+
+Если sync-PR/MR уже влит squash-merge, история шаблона могла не сохраниться как нормальная merge-связь.
+
+Что сделать:
+
+- зафиксировать факт в описании проекта;
+- проверить, видит ли Git последующие обновления шаблона без повторного применения старых изменений;
+- при следующем обновлении внимательно смотреть diff и конфликты;
+- для будущих sync-PR/MR отключить squash.
+
+Если ситуация стала неуправляемой, может потребоваться отдельная техническая миграция истории.
+
+## cannot run less
+
+Ошибка:
+
+```text
+cannot run less
+```
+
+Причина: Git пытается открыть pager `less`, которого нет в системе.
+
+Решение: использовать `git --no-pager`:
+
+```bash
+git --no-pager log --oneline --graph --decorate --all --max-count=50
+git --no-pager diff template...master
+```