Files
tf_provider/HISTORY/90_llm/SONNET/docs_p1_approved.md
T
Repinoid 2aa2946700 docs(history): обновлены перекрёстные ссылки на файлы HISTORY после переноса
Перенос в тематические папки сломал бы все ссылки, поэтому обновлены пути:
- 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/ остались корректными (соседние файлы).
2026-10-02 07:36:09 +03:00

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 копировать в самом скрипте