Repinoid
2aa2946700
Перенос в тематические папки сломал бы все ссылки, поэтому обновлены пути:
- HISTORY/OPUS/ -> HISTORY/90_llm/OPUS/, HISTORY/SONNET/ -> HISTORY/90_llm/SONNET/;
- 15 целевых файлов из корня получили свой тематический префикс
(HISTORY/<файл>.md -> HISTORY/<папка>/<файл>.md) — в 33 файлах репозитория.
Затронуто вне HISTORY: README.md, VERSIONS.md, HOW_TO/DEVOPS_BUILD_PIPELINE.md,
NOTES/README.md, NOTES/10_plans/, NOTES/20_prompts/, NOTES/30_analysis/,
NOTES/40_chat_summaries/, docs/curated/{crud,postgres}, docs/help/dev-reference/,
docs/ops/TESTING.md.
Проверки после правки:
- ссылок вида HISTORY/<дата> без тематической папки не осталось;
- все пути HISTORY/*.md из markdown-ссылок существуют (кроме трёх упоминаний,
которые не были файлами и до переноса: HISTORY/90_llm/OPUS/3006_1.md,
3006_0.md — планировавшиеся имена в старых транскриптах,
и HISTORY/HOWTO-UPLOAD.md — ссылка на старый внешний репозиторий tf_registry);
- ссылки по «голому» имени внутри 90_llm/OPUS/ остались корректными (соседние файлы).
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/90_llm/OPUS/, HISTORY/90_llm/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_...). В актуальных документах
ссылки обновлены; в архивных — могли не обновляться: ищите файл по имени, а не по пути.