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: пометки о соответствии старых путей - внутри перенесённых файлов обновлены ссылки на новые пути
2026-09-24 07:51:38 +03:00
parent 2d8e435dd4
commit f7fffb9ed7
31 changed files with 549 additions and 56 deletions
@@ -0,0 +1,45 @@
+# 20_prompts — промпты для LLM
+
+Промпты, которые отправлялись внешним моделям (Opus / Sol / Sonnet / DeepSeek Flash / GPT‑5.2‑Codex).
+Ответы моделей лежат отдельно — в `../30_analysis/` и `../40_chat_summaries/`.
+
+> ⛔ = отменённый («ложный») путь, только история. ✅ = актуально.
+
+## Статус: актуальное
+
+| Файл | О чём | Статус |
+|---|---|---|
+| `prompt_for_opus_iac_shturval_modify.md` | IaC-развёртывание Штурвала: проблема `modify` и скрытых зависимостей (5 вопросов). **Факты внутри исправлены** (vIPConfigure — replace-семантика, а не накопительная) | ✅ Актуально |
+| `prompt_for_opus_modifier_global_architecture.md` | Как сделать модификаторы **НЕ инвазивным дополнением**: YAML — чистая выгрузка API, модификаторы — не ветка генератора | ✅ Актуальное направление (не реализовано) |
+| `prompt_for_opus_modifiable_architecture.md` | Простая логика «изменяемости» параметров (CreateOnly vs Modifiable) | ⚠️ Статус не определён |
+| `prompt_for_opus_review.md` | Код-ревью + оценка архитектуры, 3 задачи roadmap (в т.ч. `vcOrg modify` — динамическая аллокация IP) | ⚠️ Статус не определён; ответ — `../30_analysis/opus_review_answer.md` |
+
+## Статус: отменённый заход (модификаторы со метками в YAML)
+
+| Файл | О чём |
+|---|---|
+| `prompt_for_opus_modifier_architecture_full.md` ⛔ | Спроектировать с нуля архитектуру `kind: modifier` |
+| `prompt_for_opus_modifier_architecture_q3.md` ⛔ | Уточнения к архитектуре модификаторов (расхождения с кодом) |
+| `prompt_for_opus_modifier_null_bug.md` ⛔ | Баг: modify-модификатор сбрасывает create-поля (`needEnableAVI` true→false) |
+| `prompt_for_opus_modifier_plan_review.md` ⛔ | Ревью плана редизайна модификаторов |
+| `prompt_for_opus_modifiers_review.md` ⛔ | Код-ревью модификаторов в универсальном провайдере |
+| `prompt_for_opus_modifier_review_2.md` ⛔ | Ревью `vc_nsxt` / `vc_org` + досылка modify-params через `paramValue` |
+| `prompt_for_opus_inverse_architecture.md` ⚠️ | Архитектура inverse-отката модификаторов (`delete_params`, `zero_count`, `off_value`). Модель — от отменённого механизма; факты внутри (count=0, `no-needed`) переиспользуются |
+
+## Промпты по другим темам (не про модификаторы)
+
+| Файл | О чём |
+|---|---|
+| `prompt_for_opus_bugs.md` | Баг: `FindInstanceByDisplayName` не находит существующий инстанс |
+| `prompt_for_opus_duplicate.md` | subresource duplicate/exist + `state_out` |
+| `prompt_for_flash_fix_tainted_replace.md` | ТЗ для DeepSeek Flash: убрать create-time проверку существования из `ModifyPlan` |
+| `prompt_for_sol_dev_generator_bug.md` | Проверка решения бага Dev-генератора |
+| `prompt_for_sonnet_docs_ux.md` | BRIEF: анализ и рекомендации по документации провайдера (UX) |
+| `prompt_deepseek_flash.txt` | Роль: технический редактор документации; правила «не менять параметры/типы/ID» |
+| `gpt5_5.2_codex_universal_provider_prompt.md` | Задачи по `terra`-провайдеру (Codex) |
+
+## Ответы на эти промпты
+
+- `../30_analysis/opus_review_answer.md` — ответ на `prompt_for_opus_review.md`
+- `../30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md` — ответ на `prompt_for_opus_iac_shturval_modify.md`
+- `../HISTORY/OPUS/` и `../HISTORY/SONNET/` — исторические ответы по датам
@@ -15,9 +15,9 @@ Constraints:
 ---

 ## 2) Файлы для изучения (указать полные пути)
- docs/ARCHITECTURE_NEW.md — архитектурный обзор
+- NOTES/30_analysis/ARCHITECTURE_NEW.md — архитектурный обзор
 - docs/README.md, docs/index.md — документация / навигация
- docs/howitwasdone.md — история решений
+- NOTES/50_process/howitwasdone.md — история решений
 - docs/ai_universal_provider_gen.md — процесс генерации провайдера (YAML → Go)
 - universal_rebuild/tools/gen/main.go — генератор (основная логика)
 - universal_rebuild/internal/resources_gen/* — примеры сгенерированных ресурсов
@@ -27,7 +27,7 @@ k8sShturval -> create
 - Провайдер генерируется из YAML-спеков. Схема tf-ресурса строится ТОЛЬКО из операции `create`.
 - `vIPConfigure` (array-map-fixed, sub: name/count) есть только в `modify` vc_org (id 207); в `create` (136) его нет.
 - `ipSpaceName` (string) есть только в `modify` vc_nsxt (id 111); в `create` (10) его нет.
- `vIPConfigure` — **не накопительный, а replace-семантика** (подтверждено `docs/ORG_IP_MODIFIER_TEST_2026-09-22.md`): повторный `modify` с тем же `count` не аккумулирует IP (1→1), работает в обе стороны (вверх/вниз/до 0), `count=0` принимается. Значение задаётся целиком, читается из `state.params`.
+- `vIPConfigure` — **не накопительный, а replace-семантика** (подтверждено `NOTES/30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md`): повторный `modify` с тем же `count` не аккумулирует IP (1→1), работает в обе стороны (вверх/вниз/до 0), `count=0` принимается. Значение задаётся целиком, читается из `state.params`.
 - `ipSpaceName` выводится из цепочки `providerVdc -> providerGateway -> ipSpace`, которую пользователь не знает. Сейчас платформа «подкладывает» недостающие параметры при создании пустой орги.
 - Допущение платформы: в организации один T0/провайдер-шлюз. Рост числа T0 отложен.
 - Платформа в движении: форма ресурсов зависит от новых спеков (ждут, придут сначала в sandbox).
@@ -1,3 +1,7 @@
+> ⛔ **ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО (пометка 2026-09-24). ТАК ДЕЛАТЬ НЕЛЬЗЯ.**
+> Отменённый заход (`kind: modifier` в YAML + реестр в генераторе). Сохранён как история.
+> Актуально: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Спроектировать С НУЛЯ архитектуру/логику «ресурсов-модификаторов» (kind: modifier)

 ## Цель
@@ -1,3 +1,7 @@
+> ⛔ **ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО (пометка 2026-09-24). ТАК ДЕЛАТЬ НЕЛЬЗЯ.**
+> Отменённый заход (`kind: modifier` в YAML + реестр в генераторе). Сохранён как история.
+> Актуально: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Уточнения к архитектуре модификаторов — расхождения с фактическим кодом

 Не принимаю предыдущие ответы за истину. Сверка с реальным кодом выявила расхождения.
@@ -1,3 +1,8 @@
+> ✅ **АКТУАЛЬНОЕ НАПРАВЛЕНИЕ (пометка 2026-09-24), НО ЕЩЁ НЕ РЕАЛИЗОВАНО.**
+> Требования отсюда действительны: YAML — чистая выгрузка API без доменных меток; модификаторы — НЕ ветка
+> универсального генератора. Ответ Opus по нему см. в `NOTES/30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md`.
+> Состояние и развилка: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Глобальная архитектура модификаторов: как сделать их НЕ инвазивным дополнением

 ЗАПРЕЩЕНО лезть в файлы репозитория. Отвечай только по тексту. Формат: тезисы, кратко, по пунктам моего вопроса. Без лишнего.
@@ -1,3 +1,7 @@
+> ⛔ **ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО (пометка 2026-09-24). ТАК ДЕЛАТЬ НЕЛЬЗЯ.**
+> Баг относится к отменённому заходу (`kind: modifier` в YAML + реестр в генераторе).
+> Сохранён как история. Актуально: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Баг: modify-модификатор сбрасывает create-поля в дефолт (needEnableAVI true→false)

 ## Симптом
@@ -1,3 +1,7 @@
+> ⛔ **ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО (пометка 2026-09-24). ТАК ДЕЛАТЬ НЕЛЬЗЯ.**
+> Ревью плана отменённого захода (`kind: modifier` в YAML + реестр в генераторе).
+> Сохранён как история. Актуально: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Ревью плана реализации: редизайн модификаторов

 Прошу отревьюить план `PLAN_modifier_redesign.md` (10 шагов). Это проект к реализации,
@@ -1,3 +1,8 @@
+> ⛔ **ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО (пометка 2026-09-24). ТАК ДЕЛАТЬ НЕЛЬЗЯ.**
+> Ревью реализации отменённого захода (`kind: modifier` в YAML + реестр в генераторе,
+> досылка modify-params через `paramValue`). Сохранён как история.
+> Актуально: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Ревью: модификаторы vc_nsxt / vc_org + досылка modify-params (Terraform Provider Nubes)

 Ты — ревьюер. Ничего не правь. Прочитай и выдай:
@@ -1,3 +1,7 @@
+> ⛔ **ЛОЖНЫЙ ПУТЬ — ОТМЕНЕНО (пометка 2026-09-24). ТАК ДЕЛАТЬ НЕЛЬЗЯ.**
+> Код-ревью отменённого захода (`kind: modifier` в YAML + реестр в генераторе).
+> Сохранён как история. Актуально: `NOTES/40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`.
+
 # Код-ревью: модификаторы (kind: modifier) в универсальном провайдере

 ## Контекст
@@ -280,7 +280,7 @@ CSS скрывает обе боковые панели mkdocs:
 2. **TOOLS/docs-generator/internal/writers/writers.go** — ВСЯ генерация .md (~1000 строк, ключевой файл)
 3. **TOOLS/docs-generator/main.go** — CLI, флаги, оркестрация
 4. **TOOLS/scripts/05_generate_docs_llm.py** — LLM-обогащение, SYSTEM_PROMPT
-5. **docs/LLM_DOCS_GENERATION.md** — архитектурная документация
+5. **NOTES/50_process/LLM_DOCS_GENERATION.md** — архитектурная документация
 6. **docs/30_registry/assets/extra.css** — CSS-стили
 7. **docs/30_registry/javascripts/fix-slash.js** — JS (trailing slash fix)