- 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: пометки о соответствии старых путей - внутри перенесённых файлов обновлены ссылки на новые пути
60_reference — справочные материалы
Справочники и внешние факты: состояния инстансов, матрицы переходов, списки API, обзор универсального ядра. Это не планы и не анализы — это «шпаргалки».
Файлы
| Файл | Что внутри | Статус |
|---|---|---|
INSTANCE_STATES.md |
Матрица состояний ресурсов в облаке ngcloud | ✅ Справочник |
STATE_TRANSITIONS.md |
Матрица переходов состояний инстансов ngcloud | ✅ Справочник |
apis.txt |
Список API. В самом файле предупреждение: старые API закрываются, не использовать для генерации; актуальные — lk-api-gateway*.ngcloud.ru/api/v1/svc |
⚠️ Читать с учётом шапки файла |
ai_universal_provider_gen.md |
Подробный отчёт по универсальному ядру и генератору ресурсов | ⚠️ Проверить актуальность (описывает общее устройство) |
Где искать более точные данные
| Нужно | Где |
|---|---|
| Endpoint + токен стенда | ../../TOOLS/config/<стенд>/profile.env → NUBES_API_ENDPOINT, TOKEN_FILE |
| Спеки сервисов (операции/параметры/ID) | ../../generated/<стенд>/resources_yaml/<id>_<svc>.yaml |
| Live-ответы API | ../../HAR/*.har |
| Залитые версии провайдера | ../../VERSIONS.md |
| Схема нумерации стендов | ../10_plans/PLAN_FLASH_reversion_cleanup.md |
Состояния после modify (примеры) |
../30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md |