Files
brain/docs/how-to-experiment.md
T
Дмитрий 917ef337b2 docs: brain meta documentation + manifest.json
- CLAUDE.md (brain repo meta)
- README.md (root quick start)
- CHANGELOG.md (brain-v1.0 release notes)
- manifest.json (sha256 + min-python + required tools)
- docs/architecture.md (copy of Liderra spec)
- docs/how-to-use-brain.md
- docs/how-to-experiment.md
- docs/secrets-and-tokens.md
- docs/consumer-projects.md
- user-level-files/README.md
- project-files/README.md

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-11 01:05:10 +03:00

43 lines
1.6 KiB
Markdown

# 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'ы.