Files
brain/CLAUDE.md
T
Дмитрий 96b1557fe8 docs(brain): link CLAUDE.md to brain-plugin-routing v1.0
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>
2026-05-11 13:46:24 +03:00

3.2 KiB
Raw Blame History

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