Files
tf_provider/HISTORY/SONNET/docs_p1_approved.md
T
“Naeel” c9a881aa84 feat(P1): новый LLM-промпт для документации — правила A-E
- value_list → читаемый текст (Допустимые значения)
- regex → описание формата
- пустые описания → заполнять из MAN
- группы map-fixed → 1 предложение о содержимом
- операции без описания → шаблоны
- MAN-контекст для params/ops файлов
- max_tokens 4096 → 8192
- вывод в docs_llm/ вместо перезаписи docs/
2026-08-09 21:11:03 +04:00

1.4 KiB

Документация — финальный план P1 (утверждён)

Дата: 2026-08-09 Источник: Sonnet, после серии брифов и уточнений

Что меняется в 05_generate_docs_llm.py

1. SYSTEM_PROMPT — замена

Новый промпт с правилами A-E (см. HISTORY/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 копировать в самом скрипте