Files

T

Repinoid 2c196e8cc8 docs(history): раскладка HISTORY по тематическим папкам (75 файлов)

Было: 41 файл в корне HISTORY/ + авторские папки OPUS/ и SONNET/ (34 файла).
Стало — тематическая нумерация в стиле NOTES/ (10_, 20_, …):

  10_reviews/    ревью кода и разборы от LLM (2)
  20_releases/   заливки версий в реестр, чистки реестра, нумерация версий (8)
  30_provider/   ядро провайдера: архитектура, модификаторы, UUID, nested (6)
  40_generator/  генератор YAML/спеки, формат MAN (3)
  50_docs/       пайплайн документации, навигация, публикация, хостинг S3 (9)
  60_stands/     стенды и примеры: CRUD, FullPipe, Штурвал, TEST_STAND (7)
  70_infra/      реестр, API Gateway, DDoS-Guard, VPN/213, зеркала (4)
  90_llm/        диалоги и промпты с LLM вне тематики: OPUS/, SONNET/, gemini/ (34)

OPUS/ и SONNET/ перенесены как есть в 90_llm/ — чтобы не рвать пары
«бриф → ответ» внутри диалогов. Все переносы — через git mv (история сохранена).
Перед правкой: TMP/backup_2026-10-02/HISTORY_before_restructure.tar.gz.
Перекрёстные ссылки обновляются следующим коммитом.

2026-10-02 07:35:32 +03:00

1.6 KiB

Raw Blame History

Sonnet: финальный план P1 — 05_generate_docs_llm.py

Пайплайн на один сервис

docs/Name.md               ─┐
docs/Name_params_create.md  ─┤  LLM  →  docs_llm/Name.md
docs/Name_params_modify.md  ─┤          docs_llm/Name_params_create.md
docs/Name_ops.md            ─┤          docs_llm/Name_params_modify.md
docs/Name_example.md        ─┘          docs_llm/Name_ops.md
                                        docs_llm/Name_example.md

docs/Name_outputs.md        ─── copy →  docs_llm/Name_outputs.md
docs/Name_params.md         ─── copy →  docs_llm/Name_params.md
docs/Name_subresource*.md   ─── copy →  docs_llm/Name_subresource*.md

Ключевые детали

MAN-контекст

Извлекается из docs/Name.md (raw HTML) функцией extract_man()
Передаётся в том же сообщении что и params/ops файлы
Для главной страницы (Name.md) и примеров (_example.md) — без MAN

Параметры LLM

max_tokens: 4096 → 8192
temperature: 0.15 (без изменений)
model: gpt-oss-120b (без изменений)

Интеграция с 04_build_and_publish_docs.sh

Вариант A: DOCS_GEN_DIR → docs_llm/. Скрипт копирует guides/, 30_registry/, index.md в docs_llm/.

Вопрос: subresource-страницы обрабатывать LLM?

postgres_user.md, postgres_database.md, postgres_backup.md — их структура как у _params_create.md. Пока копировать as-is или тоже через LLM?

1.6 KiB Raw Blame History Unescape Escape