# How to experiment

`experiments/` — песочница, **не синкается** в consumer-проекты (`.gitignore` excludes).

## Эксперимент: новый хук

```bash
cd c:/моя/проекты/claude-brain
mkdir experiments/2026-05-20-my-new-hook
# Прототипировать в experiments/2026-05-20-my-new-hook/hook.py
python experiments/2026-05-20-my-new-hook/hook.py < test-input.json

# Тестировать на live ~/.claude/ — через symlink (Windows: mklink)
# Или через add-hook flag в settings.json указывая полный путь к experiments/...
```

## Промоут эксперимента → user-level-files

Когда хук готов:

```bash
git mv experiments/2026-05-20-my-new-hook/hook.py user-level-files/hooks/my-new-hook.py
# Обновить manifest.json — добавить sha256 нового файла
# Обновить CHANGELOG.md
git commit -m "feat: promote my-new-hook from experiments"
git tag brain-v1.1
```

После — `./scripts/install.sh --target=$HOME/.claude --version=brain-v1.1` в нужном моменте.

## Эксперимент: новая редакция Pravila

```bash
mkdir experiments/2026-05-20-pravila-v2-draft
cp project-files/docs/Pravila_raboty_Claude.template.md experiments/2026-05-20-pravila-v2-draft/
# Редактировать draft независимо
# Когда готов — заменить template + bump version
```

## Гарантия

`experiments/*` в `.gitignore` (кроме `README.md` и `.gitkeep`). Никакие изменения там не попадают в consumer'ы.