38 lines
2.4 KiB
Markdown
38 lines
2.4 KiB
Markdown
|
# 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)
|