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: пометки о соответствии старых путей
- внутри перенесённых файлов обновлены ссылки на новые пути

NOTES/40_chat_summaries/CHAT_RESUME_2026-09-21.md

@@ -39,7 +39,7 @@
 ### 3.1. Что просили у Opus
 - Проверить только:
   - `provider/internal/core/client.go`
-  - `docs/DEBUG_REPORT_VC_VDC_500.md`
+  - `NOTES/30_analysis/DEBUG_REPORT_VC_VDC_500.md`
   - `generated/dev/resources_yaml/21_vc_vdc.yaml`
   - `generated/dev/resources_yaml/26_vapp.yaml`
   - `generated/dev/resources_yaml/90_postgres.yaml`

NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md

@@ -61,7 +61,7 @@ k8sShturval -> create
    Файл: `generated/dev/resources_yaml/22_vc_nsxt.yaml`.
 4. **`vIPConfigure` — replace-семантика, НЕ накопительная.** Повторный modify с тем же count не задваивает (1→1),
    работает вверх/вниз/до 0, `count=0` принимается (несмотря на `minvalue:1`), live читается из `state.params`.
-   Источник: `docs/ORG_IP_MODIFIER_TEST_2026-09-22.md` (проверено на стенде DEV_STAND/FullPipe, провайдер 2.0.9).
+   Источник: `NOTES/30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md` (проверено на стенде DEV_STAND/FullPipe, провайдер 2.0.9).
 5. **`ipSpaceName` — выводимое значение:** цепочка `providerVdc → providerGateway → ipSpace`, юзер его не знает.
    Платформа сейчас «подкладывает» недостающие параметры при создании пустой орги. Список доступных ipSpace
    в статической выгрузке (`/instanceOperations/default/{id}`) — пустой, виден только в ЛК/живом инстансе. (Виталий + форензика)
@@ -147,25 +147,37 @@ k8sShturval -> create
 ## 8. Карта файлов
 
 **АКТУАЛЬНО (источник истины):**
-- `docs/CHAT_RESUME_IAC_2026-09-24.md` ← этот файл
-- `docs/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md` — анализ, варианты A–E, мнение
-- `docs/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md` — ответ Opus + поправки (ложные блокеры сняты)
-- `docs/ORG_IP_MODIFIER_TEST_2026-09-22.md` — проверенные факты по vIPConfigure
-- `docs/prompts/prompt_for_opus_iac_shturval_modify.md` — промпт (факты исправлены)
+- `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md` ← этот файл
+- `NOTES/30_analysis/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md` — анализ, варианты A–E, мнение
+- `NOTES/30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md` — ответ Opus + поправки (ложные блокеры сняты)
+- `NOTES/30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md` — проверенные факты по vIPConfigure
+- `NOTES/20_prompts/prompt_for_opus_iac_shturval_modify.md` — промпт (факты исправлены)
 - `generated/dev/resources_yaml/19_vc_org.yaml`, `22_vc_nsxt.yaml` — спеки (факты по операциям/параметрам)
 - `HAR/org_enough_.har`, `HAR/org2.har`, `HAR/edge_.har` — live-семантика modify
 - `!/` — прецедент Cloud Director (3 файла `vcd_*`), НЕ наш код
 
-**LEGACY (история, НЕ источник истины):**
-- `PLAN_modifier_redesign.md` ⛔ (баннер добавлен)
-- `docs/60_strategy/modifier_resources_ideology_and_specification.md` ⛔ (баннер добавлен)
-- `docs/inverse_rollback_analysis_2026-09-23.md`
-- `prompt_for_opus_modifier_global_architecture.md`, `prompt_for_opus_modifier_review_2.md` (корень)
-- `docs/prompts/prompt_for_opus_modifier_*.md`, `docs/prompts/prompt_for_opus_modifiable_architecture.md`
-- `HISTORY/OPUS/2026-09-22_modifier_*.md`
-- `PLAN_regenerate_providers_0.0.1.md` — перекрыт `PLAN_FLASH_reversion_cleanup.md` (0.0.1 объявлен легаси)
+**LEGACY — с баннерами (НЕ источник истины, файлы сохранены для истории):**
 
-> Примечание: `docs/ORG_IP_MODIFIER_TEST_2026-09-22.md` — **актуален** (это отчёт по проверке, не план).
+⛔ «ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО. ТАК ДЕЛАТЬ НЕЛЬЗЯ» (метки `kind: modifier` в YAML + реестр в `yaml-generator`):
+- `PLAN_modifier_redesign.md`
+- `docs/60_strategy/modifier_resources_ideology_and_specification.md`
+- `NOTES/20_prompts/prompt_for_opus_modifier_architecture_full.md`, `…_architecture_q3.md`, `…_modifier_null_bug.md`, `…_modifier_plan_review.md`, `…_modifiers_review.md`
+- `NOTES/20_prompts/prompt_for_opus_modifier_review_2.md`
+- `HISTORY/OPUS/2026-09-22_modifier_architecture_project.md`, `…_modifier_null_reset_bug.md`, `…_modifier_plan_review.md`, `…_modifiers_code_review.md`
+
+⚠️ «ЧАСТИЧНО УСТАРЕЛО» (модель отменённого механизма; факты внутри верны и переиспользуются):
+- `NOTES/30_analysis/inverse_rollback_analysis_2026-09-23.md`
+
+✅ «АКТУАЛЬНОЕ НАПРАВЛЕНИЕ, НО НЕ РЕАЛИЗОВАНО»:
+- `NOTES/20_prompts/prompt_for_opus_modifier_global_architecture.md` (требования: YAML без доменных меток; модификаторы — не ветка генератора)
+
+⚠️ «ПЕРЕКРЫТ»:
+- `PLAN_regenerate_providers_0.0.1.md` — версия `0.0.1` объявлена легаси в `PLAN_FLASH_reversion_cleanup.md`
+
+**Статус не определён (не трогал):**
+- `NOTES/20_prompts/prompt_for_opus_modifiable_architecture.md` (тема: CreateOnly vs Modifiable — не относится напрямую к отменённому заходу)
+
+> Примечание: `NOTES/30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md` — **актуален** (отчёт по проверке, не план).
 
 **Инфра-контекст:**
 - `TOOLS/config/<стенд>/profile.env` → `NUBES_API_ENDPOINT`, `TOKEN_FILE`

NOTES/40_chat_summaries/README.md

@@ -0,0 +1,27 @@
+# 40_chat_summaries — выжимки и хендоверы из чатов
+
+Резюме длинных сессий: чтобы новый чат/человек вошёл в контекст, не перечитывая переписку.
+Формат — по конвенции репозитория: `CHAT_RESUME_<тема>_<дата>.md`.
+
+## Файлы
+
+| Файл | Тема | Статус |
+|---|---|---|
+| `CHAT_RESUME_IAC_2026-09-24.md` | **Текущая линия: IaC + `modify` (Штурвал).** Задача, позиции участников (Георгий/Дмитрий/Виталий), 10 подтверждённых фактов, почему не работает простое, каноничное решение, развилка A–E, **исправленные ошибки**, карта файлов, открытые вопросы | ✅ **Актуально — начинать отсюда** |
+| `CHAT_RESUME_2026-09-22.md` | Предыдущая сессия (дата в имени) | ⚠️ История |
+| `CHAT_RESUME_2026-09-21.md` | Предыдущая сессия | ⚠️ История |
+| `CHAT_RESUME_2026-09-20.md` | Предыдущая сессия | ⚠️ История |
+| `CHAT_RESUME_NEW.md` | Хендовер «для нового чата» (без даты — сложно датировать) | ⚠️ Проверить дату перед использованием |
+| `CHAT_RESUME.md` | Первый/базовый хендовер (без даты) | ⚠️ Проверить дату |
+| `CHAT_RESUME_PLAN_VM.md` | Хендовер по плану работ на ВМ | ⚠️ Проверить дату |
+
+## Как пользоваться
+
+1. Открыть `CHAT_RESUME_IAC_2026-09-24.md` — это сводка всей линии по IaC.
+2. Внутри него есть ссылки на детальные документы (`../30_analysis/*`, `../20_prompts/*`).
+3. Устаревшие рестюме **не удалять** — они фиксируют состояние на свою дату (полезно для хронологии).
+
+## Важно про даты
+
+Файлы без даты в имени (`CHAT_RESUME.md`, `_NEW`, `_PLAN_VM`) — потенциальный источник путаницы:
+перед использованием проверьте содержание (даты/версии внутри) на актуальность.