Stage 3: улучшена логика жизненного цикла и очищены ответы ассистента

llm_normalizer/docs/runs/README.md

@@ -1,29 +1,52 @@
-# Run Folders
+# Run Folders
 
-Эта папка используется для чистого хранения артефактов каждого прогона.
+Эта папка используется для хранения артефактов каждой отдельной волны.
 
-Формат:
-- `docs/runs/YYYY-MM-DD_HH-mm-ss[_label]/`
-- внутри:
-  - `reports/`
-  - `logs/traces/`
-  - `logs/assistant_sessions/`
-  - `manifest.json`
+## Обязательный формат имени run-папки
 
-Запуск архивации:
+- `docs/runs/YYYY-MM-DD_Stage_<NN>_Wave_<NN>_<short_topic>/`
+
+Правило порядка строгое:
+- после даты всегда идет `Stage`;
+- после `Stage` всегда идет `Wave`;
+- затем краткая тема волны.
+
+Пример:
+- `docs/runs/2026-03-26_Stage_04_Wave_01_Kickoff/`
+
+## Обязательная структура внутри run-папки
+
+- `README.md` — что проверяли и зачем;
+- `run_summary.json` — команды, результаты, ключевые ссылки;
+- `artifacts/` — отчеты прогонов (test/eval/acceptance/regression);
+- `prompt_dialogs/` — диалоги user/system/assistant и runtime-контекст.
+
+## Обязательная структура `prompt_dialogs`
+
+- `prompt_dialogs/index.json`
+- `prompt_dialogs/<suite>/<case_id>.json`
+- `prompt_dialogs/<suite>/<case_id>.md`
+
+Минимум по каждому кейсу:
+- вопрос пользователя;
+- ответ системы (assistant reply);
+- технический контекст, доступный для анализа (debug/runtime/decomposition/grounding, если есть).
+
+## Важное правило по волнам
+
+Артефакты разных волн нельзя смешивать в одной папке.
+Каждая волна должна иметь собственную run-папку и собственный набор `prompt_dialogs`.
+
+## Архивация
 
 ```bash
 npm run artifacts:bundle
 ```
 
-Архивация с очисткой исходных логов/генерируемых отчетов:
-
 ```bash
 npm run artifacts:bundle:clean
 ```
 
-С меткой захода:
-
 ```bash
-npm run artifacts:bundle:clean -- --label wave2_followup
+npm run artifacts:bundle:clean -- --label stage4_wave1
 ```