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/ остались корректными (соседние файлы).
68 lines
6.1 KiB
Markdown
68 lines
6.1 KiB
Markdown
# NOTES — рабочие материалы по провайдеру Nubes
|
||
|
||
Здесь лежат **рабочие материалы**: планы, промпты для LLM, анализы, выжимки из чатов, процессные
|
||
и справочные заметки. Это НЕ публикуемая документация пользователя (та — в `docs/`, собирается mkdocs).
|
||
|
||
> **Главное правило:** файлы с баннером ⛔ в первой строке — **отменённый («ложный») путь**.
|
||
> Читать можно, опираться нельзя.
|
||
|
||
---
|
||
|
||
## Карта папок
|
||
|
||
| Папка | Что внутри | Когда идти туда |
|
||
|---|---|---|
|
||
| [`10_plans/`](10_plans/README.md) | Планы работ: актуальные, перекрытые и отменённые | Понять текущие задачи и их статус |
|
||
| [`20_prompts/`](20_prompts/README.md) | Промпты для LLM (Opus/Sol/Sonnet/DeepSeek/Codex) | Понять, что и у кого спрашивали; переиспользовать формулировки |
|
||
| [`30_analysis/`](30_analysis/README.md) | Анализы, форензика, отчёты, ответы LLM-ревью, разборы багов | Найти факты и обоснования решений |
|
||
| [`40_chat_summaries/`](40_chat_summaries/README.md) | Выжимки-хендоверы из чатов (`CHAT_RESUME_*`) | Быстро войти в контекст прошлых сессий |
|
||
| [`60_reference/`](60_reference/README.md) | Справочники: состояния, стадии, API, архитектурный обзор | Уточнить терминологию и внешние факты |
|
||
|
||
> ❗ **Инструкции (сборка/заливка, добавление сервиса, процессы) вынесены из NOTES в корневую папку
|
||
> [`HOW_TO/`](../HOW_TO/README.md)** — там индекс «что нужно → какой файл».
|
||
|
||
---
|
||
|
||
## Что осталось в корне и в других местах (НЕ переносилось)
|
||
|
||
| Путь | Что это | Почему оставлено |
|
||
|---|---|---|
|
||
| `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)», читать в таком порядке:
|
||
|
||
1. [`40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md`](40_chat_summaries/CHAT_RESUME_IAC_2026-09-24.md) — **начинать отсюда**: полный хендовер (задача, факты, позиции участников, развилка, исправленные ошибки).
|
||
2. [`30_analysis/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md`](30_analysis/SHTURVAL_IAC_MODIFY_ANALYSIS_2026-09-23.md) — анализ проблемы и варианты.
|
||
3. [`30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md`](30_analysis/OPUS_ANSWER_IAC_SHTURVAL_MODIFY_2026-09-23.md) — ответ Opus **с поправками** (часть его «блокеров» ложная).
|
||
4. [`30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md`](30_analysis/ORG_IP_MODIFIER_TEST_2026-09-22.md) — единственные проверенные на стенде факты.
|
||
5. [`20_prompts/prompt_for_opus_iac_shturval_modify.md`](20_prompts/prompt_for_opus_iac_shturval_modify.md) — актуальный промпт.
|
||
|
||
---
|
||
|
||
## Статусы файлов (что можно использовать)
|
||
|
||
- ✅ **Актуально** — можно опираться.
|
||
- ⚠️ **Перекрыто / частично** — использовать осторожно, есть более новый документ.
|
||
- ⛔ **Отменённый путь** — только как история (баннер в файле).
|
||
|
||
Точные статусы по каждому файлу — в README соответствующей папки.
|
||
|
||
---
|
||
|
||
## ⚠️ Известная проблема: устаревшие ссылки
|
||
|
||
Файлы переносились из корня и `docs/`, поэтому **внутри исторических документов могли остаться
|
||
старые пути** (например `docs/prompts/...` или `docs/CHAT_RESUME_...`). В актуальных документах
|
||
ссылки обновлены; в архивных — могли не обновляться: ищите файл по имени, а не по пути.
|