Дмитрий
7c90285cc9
Atomic bump per D11. Brain-plugin-routing v1.0 released. Also closes missing .brain-version artifact from v1.0 bootstrap. Updates CHANGELOG, manifest.json version field, and CLAUDE.md version header. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
46 lines
3.2 KiB
Markdown
46 lines
3.2 KiB
Markdown
# CLAUDE.md — Brain Repository
|
||
|
||
**Что это:** независимый репозиторий «мозга Claude» — переиспользуемого набора правил, хуков, плагинов и MCP-серверов для консьюмер-проектов (Лидерра и будущие).
|
||
|
||
**Версия:** brain-v1.1 от 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.
|
||
|
||
## Выбор плагина и установка нового
|
||
|
||
Brain имеет собственные правила выбора плагина — **не PSR template** (тот для consumer'а с UI/Vue стеком, в brain не применяется).
|
||
|
||
- Какой плагин брать для задачи / как разрешить overlap / куда поставить новый — см. [docs/brain-plugin-routing.md](docs/brain-plugin-routing.md) (v1.0+)
|
||
- При работе в brain repo плагины `frontend-design` и `ui-ux-pro-max` игнорируются (soft-rule §2.2 routing.md) — несмотря на их `enabledPlugins: true` на user-level
|
||
- При установке нового плагина — atomic procedure из §5 routing.md (6 артефактов)
|
||
|
||
## Безопасность
|
||
|
||
- API_KEY никогда в repo (используется placeholder `<<MAGIC_API_KEY>>`)
|
||
- gitleaks scan — CI workflow на каждый push
|
||
- Подробности: [docs/secrets-and-tokens.md](docs/secrets-and-tokens.md)
|