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/DEVOPS_BUILD_PIPELINE.md

@@ -1,6 +1,9 @@
 # DevOps Runbook: Provider Build Pipeline
 
-This repo root contains the 4 scripts for the full provider build pipeline.
+> Перенесено из корневого `README.md` 2026-09-24 (в корне теперь — карта проекта).
+> Пути и версии в тексте приведены к текущему состоянию репозитория.
+
+Пайплайн сборки провайдера. Скрипты живут в `TOOLS/scripts/` (НЕ в корне репозитория).
 
 ## Overview
 
@@ -12,7 +15,7 @@ This repo root contains the 4 scripts for the full provider build pipeline.
 ## Documentation publishing instructions
 
 The verified documentation generation and publishing pipeline is documented in
-[`HISTORY/2026-09-03_docs_upload_pipeline_verified.md`](HISTORY/2026-09-03_docs_upload_pipeline_verified.md).
+[`../HISTORY/2026-09-03_docs_upload_pipeline_verified.md`](../HISTORY/2026-09-03_docs_upload_pipeline_verified.md).
 It covers the generated docs source, MkDocs build, the separate documentation
 S3 bucket, VM upload and mirror steps, stand-specific URLs, and the legacy
 script that must not be used.
@@ -39,10 +42,10 @@ Provider naming defaults:
 
 ## Step 1: Generate YAMLs from API
 
-Script: `01_generate_yamls.sh`
+Script: `TOOLS/scripts/01_generate_yamls.sh --profile TOOLS/config/<стенд>`
 
 Input list of services:
-- `services_list.txt` (service_id only)
+- `TOOLS/config/services_list.txt` (service_id only)
 
 Token options:
 - `TOKEN_FILE=/home/naeel/terra/HH-MM-SS.token`, or
@@ -51,7 +54,7 @@ Token options:
 Example:
 ```bash
 export TOKEN_FILE=/home/naeel/terra/08-33-41.token
-./01_generate_yamls.sh
+./TOOLS/scripts/01_generate_yamls.sh --profile TOOLS/config/dev
 ```
 
 ## Step 2: Generate Go resources and docs
@@ -83,7 +86,7 @@ Example:
 export S3_ENDPOINT=https://s3.msk-1.ngcloud.ru
 export S3_ACCESS_KEY=...
 export S3_SECRET_KEY=...
-./03_build_and_upload_provider.sh 2.0.2
+./TOOLS/scripts/03_build_and_upload_provider.sh --profile TOOLS/config/dev 2.0.18
 ```
 
 ## Step 4: Build and publish docs
@@ -95,7 +98,7 @@ Example:
 export S3_ENDPOINT=https://s3.msk-1.ngcloud.ru
 export S3_ACCESS_KEY=...
 export S3_SECRET_KEY=...
-./04_build_and_publish_docs.sh 2.0.2
+./TOOLS/scripts/04_build_and_publish_docs.sh --profile TOOLS/config/dev 2.0.18
 ```
 
 ## Notes
@@ -103,8 +106,8 @@ export S3_SECRET_KEY=...
 - The GPG private key must remain stable across releases. Do not regenerate per build.
 - If the key is regenerated, the registry server must be updated to serve the new public key.
 - Terraform will fail with `authentication signature from unknown issuer` if the registry public key does not match the signing key.
-- `services_list.txt` is the source of truth for which services are generated.
-- If the provider version changes, update `universal_rebuild/main.go`.
+- `TOOLS/config/services_list.txt` — источник правды по тому, какие сервисы генерируются.
+- Если меняется версия провайдера — обновить `provider/main.go` (ранее `universal_rebuild/main.go` — устаревший путь).
 
 ## One-time GPG bootstrap (do this once, keep the key stable)