96b1557fe8
Add short section pointing to new routing document and disabled-in-brain soft-rule for FD/UPM. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
3.2 KiB
3.2 KiB
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 (копия из 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 (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