Перенос в тематические папки сломал бы все ссылки, поэтому обновлены пути:
- 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/ остались корректными (соседние файлы).
1.4 KiB
1.4 KiB
Документация — финальный план P1 (утверждён)
Дата: 2026-08-09 Источник: Sonnet, после серии брифов и уточнений
Что меняется в 05_generate_docs_llm.py
1. SYSTEM_PROMPT — замена
Новый промпт с правилами A-E (см. HISTORY/90_llm/SONNET/docs_prompt_full_response.md)
2. max_tokens: 4096 → 8192
3. Новая функция extract_man(text) → str
Вырезает блок ## MAN из Name.md. Используется как контекст для params/ops.
4. Новая функция build_prompt(file_type, filename, content, man) → str
Формирует сообщение для LLM: тип файла + MAN-контекст + содержимое.
5. Обработка ВСЕХ типов файлов
Было: только Name.md Стало: Name.md, _params_create.md, _params_modify.md, _ops.md, _example.md MAN-контекст: для params и ops, без MAN для главной и примеров.
6. Копирование в docs_llm/
- outputs, params-landing, subresource — копировать as-is
- 30_registry/, guides/, index.md — копировать из docs/
Решения
- Subresource: копировать as-is (не через LLM)
- max_tokens: 8192
- Вывод: docs_llm/
- 30_registry копировать в самом скрипте