From 8d08ef36847def9072b0664423466a7942d308fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=94=D0=BC=D0=B8=D1=82=D1=80=D0=B8=D0=B9?= Date: Mon, 11 May 2026 15:42:57 +0300 Subject: [PATCH] =?UTF-8?q?docs(brain-routing):=20bump=20v1.1=20=E2=86=92?= =?UTF-8?q?=20v1.2=20with=20Phase=201=20entries;=20chore=20brain-version?= =?UTF-8?q?=20v1.2=20=E2=86=92=20v1.3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Routing.md v1.2 финализирует brain v1.3 release. Changes в routing.md: - §2.1 +1 row context7 (active-in-brain via target=user-level+consumer) - §3.1 +1 row «Документация API/SDK/marketplace» → context7 default, WebFetch fallback - §3.2 +1 tie-breaker #4 (community-managed rule — Context7/telegram precedent) - §4.2 +5 rows status updates (context7 installed, 4 others registered) - История версий +1 entry v1.2 от 2026-05-11 manifest.json:version bumped brain-v1.2 → brain-v1.3. .brain-version bumped с sha=spec-doc-commit (3509260 full SHA, per brain pattern "foundational commit of release cycle"). Это финальный commit Phase 1B. После commit'а — git tag brain-v1.3 + invoke superpowers:verification-before-completion перед claim 'готов'. Co-Authored-By: Claude Opus 4.7 (1M context) --- .brain-version | 4 ++-- docs/brain-plugin-routing.md | 16 ++++++++++------ manifest.json | 2 +- 3 files changed, 13 insertions(+), 9 deletions(-) diff --git a/.brain-version b/.brain-version index a347e71..52141bd 100644 --- a/.brain-version +++ b/.brain-version @@ -1,2 +1,2 @@ -brain-v1.2 -sha: d5172b7a64cf739769a302f28b8379900a22fe0a +brain-v1.3 +sha: 350926057de71be3908440f12d46836f3ca88025 diff --git a/docs/brain-plugin-routing.md b/docs/brain-plugin-routing.md index 8131e81..7e5d486 100644 --- a/docs/brain-plugin-routing.md +++ b/docs/brain-plugin-routing.md @@ -1,4 +1,4 @@ -# Brain Plugin Routing Rules (v1.1) +# Brain Plugin Routing Rules (v1.2) **Дата:** 11.05.2026 **Назначение:** правила выбора плагина при работе в brain repo (`c:/моя/проекты/claude-brain/`). @@ -32,6 +32,7 @@ | **claude-code-setup** *(claude-automation-recommender)* | `anthropics/claude-plugins-official` | `meta` | анализ «какие плагины/хуки ещё поставить в brain» при росте репо | каждодневная работа | | **plugin-dev** | `anthropics/claude-plugins-official` | `meta` | создание нового plugin'а в brain'е (agents/commands/hooks/MCP integration); тест-bed для будущих brain плагинов | каждодневная UI/code работа | | **hookify** | `anthropics/claude-plugins-official` | `meta` | создание нового hook'а в brain by analyzing conversation patterns; complement к 10 ручным .py hook'ам в `user-level-files/hooks/` | каждодневная работа | +| **context7** | `anthropics/claude-plugins-official` | `consumer-universal` (active in brain via target=user-level+consumer) | docs lookup для API/SDK/marketplaces (Anthropic SDK, claude-plugins, future Vue/Vuetify в Liderra); plugin bundles MCP via `npx -y @upstash/context7-mcp` | каждодневный код-write (не doc-lookup) | | **frontend-design** | `anthropics/claude-plugins-official` | `consumer-UI` | ❌ **не использовать в brain'е** (см. §2.2) | весь brain | | **ui-ux-pro-max** | `nextlevelbuilder/ui-ux-pro-max-skill` | `consumer-UI` | ❌ **не использовать в brain'е** (см. §2.2) | весь brain | @@ -76,12 +77,14 @@ | Receive code review | `superpowers:receiving-code-review` | — | один tool | | TDD на код hook'а / скрипта | `superpowers:test-driven-development` (failing test first) | — | hard-required по economy 0% | | «Запутался — какой плагин брать» (meta-question) | прочитать этот документ; если строки нет — спросить + добавить через bump v1.x (см. §6.1) | — | self-referential: правила указывают на самих себя | +| Документация API/SDK/marketplace (Anthropic SDK, claude-plugins-official, Vue/Vuetify в Liderra) | `context7` MCP (через plugin context7 в `enabledPlugins`) | `WebFetch` если context7 npx down/offline ИЛИ источник вне SDK doc trees (общая статья, blog post) | структурированный version-pinned lookup vs unstructured web scrape | ### §3.2. Tie-breakers 1. **Несколько строк подходят одновременно** — побеждает более конкретная по задаче. Equal confidence → спросить пользователя. 2. **Economy mode 0% триггер требует skill X, default говорит Y** — побеждает economy 0% (live-override). 3. **User написал `/skill-name` явно** — выполнить именно его (live-override на одно действие). +4. **Community-managed plugin предложен для активного use** — добавить в `enabledPlugins` только если: (a) Anthropic-marketplace с явной верификацией (community-managed tag там есть, но Anthropic git-hosted), ИЛИ (b) user явно проаппрувил риск, ИЛИ (c) plugin изолирован (read-only queries без PII). Иначе оставить `registered-only-not-cached` для consumer-distribute, не активируя в brain. Применено в brain v1.3 к context7 (active, изолирован read-only) и telegram (registered-only, требует bun + post-install pairing). --- @@ -111,11 +114,11 @@ | #8 | `claude-code-setup` | `meta` | installed Phase 0 (manual-git-clone-Path2) | | #17 | `plugin-dev` | `meta` | installed brain v1.2 (manual-cp-from-marketplace-Path2) | | #18 | `hookify` | `meta` | installed brain v1.2 (manual-cp-from-marketplace-Path2) | -| #1 | `Context7` (MCP) | `consumer-universal` | shortlist Phase 1 | -| #2 | `code-review` | `consumer-universal` | shortlist Phase 1 | -| #7 | `security-guidance` | `consumer-universal` | shortlist Phase 1 | -| #10 | `pr-review-toolkit` | `consumer-universal` | shortlist Phase 1 | -| #12 | `telegram` | `consumer-universal` | shortlist Phase 1 | +| #1 | `context7` | `consumer-universal` (active in brain via target=user-level+consumer) | installed brain v1.3 (manual-cp-from-marketplace-Path2); **community-managed** (Upstash) + npx runtime dep | +| #2 | `code-review` | `consumer-universal` | registered brain v1.3 (registered-only-not-cached); Anthropic-authored | +| #7 | `security-guidance` | `consumer-universal` | registered brain v1.3 (registered-only-not-cached); Anthropic-authored; plugin несёт own hooks.json — потенциальный конфликт с brain economy-hooks при activation | +| #10 | `pr-review-toolkit` | `consumer-universal` | registered brain v1.3 (registered-only-not-cached); Anthropic-authored | +| #12 | `telegram` | `consumer-universal` | registered brain v1.3 (registered-only-not-cached); **community-managed** + bun runtime dep + post-install pairing required | | #5 | `feature-dev` | `consumer-stack-gated` | shortlist Phase 2 conditional | | #6 | `figma` | `consumer-stack-gated` (requires Figma) | shortlist Phase 2 conditional | | #9 | `vercel` | `consumer-stack-gated` (requires Vercel) | shortlist Phase 2 conditional | @@ -252,5 +255,6 @@ ## История версий +- **v1.2 от 2026-05-11** — Brain v1.3 release: Phase 1 deliverables. Added 5 plugins (#1 context7 active-in-brain via target=user-level+consumer, #2 code-review, #7 security-guidance, #10 pr-review-toolkit, #12 telegram — все consumer-universal через target=consumer или user-level+consumer). install-plugins.sh learned `--install-target=user|consumer` flag + filter по `target` ENUM (closing tech-debt из v1.0). §2.1 +1 row (context7), §3.1 +1 row (docs lookup новый класс задачи), §3.2 +1 tie-breaker (community-managed rule), §4.2 +5 status updates. - **v1.1 от 2026-05-11** — Installed brain-meta plugins #17 plugin-dev + #18 hookify. Added 2 rows в §2.1 (реестр), 2 rows в §3.1 routing-table (новые классы задач: «создание plugin'а», «создание hook'а»), 2 status updates в §4.2 (#17 + #18 → installed brain v1.2). - **v1.0 от 2026-05-11** — Initial release. Resolves 8 sources of ambiguity (К1-К8) from [design spec](superpowers/specs/2026-05-11-brain-plugin-routing-design.md). 5 категорий плагинов, 17 routing-rows + 3 tie-breakers, 5 install подпроцедур, update procedure. Implements decisions D1-D12 design spec'а. diff --git a/manifest.json b/manifest.json index 3fd150c..af26844 100644 --- a/manifest.json +++ b/manifest.json @@ -1,5 +1,5 @@ { - "version": "brain-v1.2", + "version": "brain-v1.3", "created": "2026-05-10T22:03:38Z", "min_python_version": "3.10", "required_tools": ["jq", "python", "git", "bash"],