refactor: разложить рабочие материалы по NOTES/ и HOW_TO/, корневой README — карта проекта

- NOTES/: 10_plans, 20_prompts, 30_analysis, 40_chat_summaries, 60_reference + README в каждой папке
- HOW_TO/: все общие инструкции (сборка/заливка, DevOps-ранбук, добавление сервиса, миграция, генерация доков) + индекс «что нужно -> какой файл»
- новый README.md: карта проекта, пайплайн, стенды, реестр, запреты/грабли
- HOWTO-UPLOAD.md: исправлена легаси-схема версий (prod=1.*, dev=2.*, test=3.*)
- DEVOPS_BUILD_PIPELINE.md: пути скриптов -> TOOLS/scripts, universal_rebuild/main.go -> provider/main.go
- howitwasdone.md / MIGRATION_PLAN_FOR_AGENT.md: пометки о соответствии старых путей
- внутри перенесённых файлов обновлены ссылки на новые пути

HOW_TO/howitwasdone.md

@@ -2,6 +2,13 @@
 <!-- Актуальный API: https://lk-api-gateway.ngcloud.ru/api/v1/svc -->
 # How It Was Done — Developer Guide (закрытая страница)
 
+> ⚠️ **Пути в этом документе — от ПРЕЖНЕЙ раскладки репозитория (`universal_rebuild/*`).**
+> Актуальное соответствие: `universal_rebuild/internal/*` → `provider/internal/*`;
+> `universal_rebuild/resources_yaml` → `generated/<стенд>/resources_yaml`;
+> `universal_rebuild/tools/gen` → `TOOLS/resource-generator`;
+> `universal_rebuild/tools/service_params_gen` → `TOOLS/yaml-generator`.
+> Смысл описанного сохраняется, но пути в тексте сверять по этому соответствию.
+
 **Filename & Versioning:** howitwasdone.md / 2026‑02‑04 / Draft v1
 
 Этот документ — единый технический мануал. Он доступен только по прямой ссылке и не включён в публичную навигацию.