# Claude Brain

Переиспользуемый «мозг Claude» — правила, хуки, плагины и MCP-серверы — для подключения к проектам.

## Quick start

### Установить мозг в новый или существующий consumer-проект

```bash
cd c:/моя/проекты/claude-brain
./scripts/install.sh --target=/path/to/my-project --version=brain-v1.0
```

### Установить мозг в `~/.claude/` (user-level хуки + плагины + MCP)

```bash
cd c:/моя/проекты/claude-brain
./scripts/install.sh --target=$HOME/.claude --version=brain-v1.0
```

При первом запуске будет prompt для `MAGIC_API_KEY` (21st.dev). Используй `--skip-secrets` для CI.

### Проверить целостность

```bash
./scripts/verify.sh --target=/path/to/my-project
```

## Структура

См. [CLAUDE.md](CLAUDE.md) для деталей.

## Документация

- [docs/architecture.md](docs/architecture.md) — архитектура brain'а
- [docs/how-to-use-brain.md](docs/how-to-use-brain.md) — workflow использования
- [docs/how-to-experiment.md](docs/how-to-experiment.md) — песочница experiments/
- [docs/secrets-and-tokens.md](docs/secrets-and-tokens.md) — управление секретами
- [docs/consumer-projects.md](docs/consumer-projects.md) — список known consumer projects

## Prerequisites

- `git` ≥2.x
- `jq` ≥1.6
- `python3` ≥3.10
- `bash` (Git Bash на Windows работает)
- Optional: `gh` (для GitHub repo create), `gitleaks` (CI), `claude` CLI (для plugin install)