NODEDC_1C/llm_normalizer/docs/runs/README.md

53 lines
1.8 KiB
Markdown

# Run Folders
Эта папка используется для хранения артефактов каждой отдельной волны.
## Обязательный формат имени 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 stage4_wave1
```