Repinoid
f7fffb9ed7
- 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 — рабочие материалы по провайдеру Nubes
Здесь лежат рабочие материалы: планы, промпты для LLM, анализы, выжимки из чатов, процессные
и справочные заметки. Это НЕ публикуемая документация пользователя (та — в docs/, собирается mkdocs).
Главное правило: файлы с баннером ⛔ в первой строке — отменённый («ложный») путь. Читать можно, опираться нельзя.
Карта папок
| Папка | Что внутри | Когда идти туда |
|---|---|---|
10_plans/ |
Планы работ: актуальные, перекрытые и отменённые | Понять текущие задачи и их статус |
20_prompts/ |
Промпты для LLM (Opus/Sol/Sonnet/DeepSeek/Codex) | Понять, что и у кого спрашивали; переиспользовать формулировки |
30_analysis/ |
Анализы, форензика, отчёты, ответы LLM-ревью, разборы багов | Найти факты и обоснования решений |
40_chat_summaries/ |
Выжимки-хендоверы из чатов (CHAT_RESUME_*) |
Быстро войти в контекст прошлых сессий |
60_reference/ |
Справочники: состояния, стадии, API, архитектурный обзор | Уточнить терминологию и внешние факты |
❗ Инструкции (сборка/заливка, добавление сервиса, процессы) вынесены из NOTES в корневую папку
HOW_TO/— там индекс «что нужно → какой файл».
Что осталось в корне и в других местах (НЕ переносилось)
| Путь | Что это | Почему оставлено |
|---|---|---|
docs/ |
Документация + налоговая структура 00_overview … 90_finance, curated/, TODO/, help/, ops/ |
Завязана на mkdocs (mkdocs.yml, exclude_docs) — перенос ломает сборку сайта |
HISTORY/ |
Архив: записи по датам, HISTORY/OPUS/, HISTORY/SONNET/ |
Это канонический архив истории; отменённый заход помечен баннерами внутри |
HAR/ |
Сырые HAR-дампы (live-запросы к API стенда) | Исходные данные для анализа, менять нельзя |
generated/ |
Выхлоп генераторов (resources_yaml, go, docs, provider_build) |
Машинный вывод, не заметки |
TOOLS/, provider/, scripts/, gateway/, apps/, charts/, tf_examples/, secrets/ |
Код и артефакты проекта | Не заметки |
! / |
Прецедент Cloud Director (vmware_org.tf, vdc.tf, network.tf.tmpl) — чужой tf-код на официальном vcd-провайдере |
Оставлено на месте (папка названа «!» специально, чтобы быть на виду) |
README.md, VERSIONS.md, mkdocs.yml |
Точки входа | README.md — карта всего проекта; VERSIONS.md — источник правды по залитым версиям |
TMP/, test_push.md, demo.jpg |
Временное/непонятное | Не трогал (статус не определён) |
Актуальное состояние (2026-09-24)
Если нужен контекст по задаче «IaC + модификаторы (modify)», читать в таком порядке:
40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md— начинать отсюда: полный хендовер (задача, факты, позиции участников, развилка, исправленные ошибки).30_analysis/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md— анализ проблемы и варианты.30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md— ответ Opus с поправками (часть его «блокеров» ложная).30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md— единственные проверенные на стенде факты.20_prompts/prompt_for_opus_iac_shturval_modify.md— актуальный промпт.
Статусы файлов (что можно использовать)
- ✅ Актуально — можно опираться.
- ⚠️ Перекрыто / частично — использовать осторожно, есть более новый документ.
- ⛔ Отменённый путь — только как история (баннер в файле).
Точные статусы по каждому файлу — в README соответствующей папки.
⚠️ Известная проблема: устаревшие ссылки
Файлы переносились из корня и docs/, поэтому внутри исторических документов могли остаться
старые пути (например docs/prompts/... или docs/CHAT_RESUME_...). В актуальных документах
ссылки обновлены; в архивных — могли не обновляться: ищите файл по имени, а не по пути.