# 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
```