# CLAUDE.md — Brain Repository

**Что это:** независимый репозиторий «мозга Claude» — переиспользуемого набора правил, хуков, плагинов и MCP-серверов для консьюмер-проектов (Лидерра и будущие).

**Версия:** brain-v1.0 от 11.05.2026

---

## Что лежит в этом репозитории

- `project-files/` — копируется в consumer-проекты (CLAUDE.md.template, Pravila, Tooling, Plugin_stack_rules, .mcp.json.template, visualization)
- `user-level-files/` — копируется в `~/.claude/` (10 hooks, settings-fragment, marketplaces, plugins-manifest, mcp-user.template)
- `scripts/` — инструменты sync (install.sh, verify.sh, extract.sh + 4 lib helper'а)
- `experiments/` — песочница, не синкается
- `docs/` — документация brain'а самого (architecture, how-to-use, how-to-experiment, secrets, consumer-projects)

## Когда использовать какой скрипт

- **install.sh** — синкать brain в consumer (Лидерра или новый проект) или в `~/.claude/`
- **verify.sh** — проверить целостность после install
- **extract.sh** — обратный rescue если consumer'е сделали правку и она потерялась бы при следующем install

## Источник истины

- Архитектура: [docs/architecture.md](docs/architecture.md) (копия из spec'а Лидерры на момент bootstrap)
- Spec на момент создания: `c:/моя/проекты/портал crm/Документация/docs/superpowers/specs/2026-05-10-claude-brain-extraction-design.md`

## Что НЕ редактировать прямо в этом репо

- Скопированные template'ы — это installed copies brain v1.0. Когда хочется править — править здесь, делать bump и rerun install.sh в Лидерре.
- Plugin/MCP конфиги — bump через update manifest, не редактирование cache.

## Безопасность

- API_KEY никогда в repo (используется placeholder `<<MAGIC_API_KEY>>`)
- gitleaks scan — CI workflow на каждый push
- Подробности: [docs/secrets-and-tokens.md](docs/secrets-and-tokens.md)