From 8b47aa5a4db4896ca9bbbb6132bfe9f3cb5cf49f 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: Fri, 15 May 2026 17:53:44 +0300 Subject: [PATCH] =?UTF-8?q?docs(sync):=20PSR=5Fv1=20v3.1=20+=20Tooling=20v?= =?UTF-8?q?2.1=20=E2=80=94=20=C2=A714=20queen-trigger=20cross-ref?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/Plugin_stack_rules_v1.md | 6 ++++-- docs/Tooling_v8_3.md | 4 +++- 2 files changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/Plugin_stack_rules_v1.md b/docs/Plugin_stack_rules_v1.md index 2b9f37c6..2a1a9641 100644 --- a/docs/Plugin_stack_rules_v1.md +++ b/docs/Plugin_stack_rules_v1.md @@ -1,8 +1,10 @@ -# Plugin Stack Rules — Superpowers + Frontend Design (v3.0) +# Plugin Stack Rules — Superpowers + Frontend Design (v3.1) **Дата:** 15.05.2026 (afternoon) **Назначение:** свод правил совместного использования плагинов Claude Code в проекте Лидерра — paired-stack ядро `obra/superpowers` (14 skills) + `anthropics/frontend-design`, плюс расширенный пул UI-инструментов `ui-ux-pro-max` (skill, marketplace `nextlevelbuilder/ui-ux-pro-max-skill`) и `21st.dev Magic MCP` (MCP-сервер `magic`), плюс инфраструктурный `claude-md-management` (skills, marketplace `anthropics/claude-plugins-official`), плюс **debug-runtime MCP** `@sentry/mcp-server` + `@modelcontextprotocol/server-redis` (v2.1+, R10.1 Блок 3). +**v3.1** — sync: cross-ref на Pravila v1.15 (новый §14 Ruflo Queen routing hard-rule — триггер queen/королева → безусловный route через ruflo Queen). Содержательных изменений R0–R14: 0. + **v3.0** — major: R0 stack-gate → sub-policy paired-stack delegation pattern под ruflo Queen-led routing. R0.1 +ruflo level −1; R0.6 +п.11 swarm-pause-without-review (sequential continuation после v2.0 R15 removal). Связано: ruflo v3.7.0-alpha.38 big-bang integration 2026-05-15. Снимает запрет CLAUDE.md §5 п.5 на Frontend Design plugin (действовал до v1.77 включительно). Документ — внутренне непротиворечив: 8 первичных конфликтов закрыты в v1.0 + 5 патчей по реальным трениям A–E в v1.1 + 4 новых правила R10–R13 против перекрытий с другими плагинами в v1.2 + 6 уточняющих патчей F–K по найденным трениям второго порядка в v1.3 + 1 новое правило R14 (pipeline внешних UI-генераторов: UPM + 21st Magic MCP) в v1.4 (R15 motion-системы введены в v1.4 и удалены в v2.0) + 5 структурных правок аудита в v1.5 (R10.1 разбит на 3 блока, R0.4.A SoT cross-ref, R10.4/R14.7 tier-метки, R8 +тай-брейкер FD↔21st, R0.1 scope-метка) + 3 правки второго аудита в v1.6 (R0.4.A свёрнут до cross-ref на Pravila §12.3 SoT — устраняет дрейф формулировок; R0.6 hard-стопы пронумерованы 1–11 для надёжности cross-refs «пункт 9/10/11»; R0.1 +Tooling Прил. Н slot уровня 2b) + 1 правка третьего аудита в v1.7 (sync cross-refs на актуальные версии связанных документов после bump'ов CLAUDE.md v1.86 / Tooling v1.15; description-fix описки «уровня 2.5»→«уровня 2b» внутри changelog'а v1.6, сверка с фактическим R0.1) + 1 правка четвёртого аудита в v2.0 (12.05.2026 — снят R15 motion-runtime по решению заказчика; conscious rollback v1.4 audited construction; framer-motion переведён из regulatory hard-запрета в technical-guidance уровень: peerDep на react+react-dom, не работает в Vue физически) + 2 строки R10.1 Блок 3 в v2.1 (13.05.2026 day +1 — debug-runtime MCP формализованы retrospective после PR #3 merge) + R0 major rewrite в v3.0 (stack-gate → sub-policy под ruflo Queen-led routing, 15.05.2026 afternoon). @@ -12,7 +14,7 @@ **Связанные документы:** - [CLAUDE.md](../CLAUDE.md) **v2.0+** — оперативная карта (ruflo big-bang integration); §1 priority chain, §3.3 строка #33, §5 п.5 ссылается на этот документ (расширенный пул UI-инструментов: FD + UPM + 21st), §5 п.11 cross-ref на Pravila §12.3 SoT, §5 п.12 — резерв (R15 motion-runtime снят в v2.0) -- [docs/Pravila_raboty_Claude_v1_1.md](Pravila_raboty_Claude_v1_1.md) **v1.14+** — §12 → sub-policy под ruflo Queen-led routing (v1.14, commit 9c3057b); §12.3 SoT для exclusions, §13 «paired stack + расширенный пул UI-инструментов» + claude-md-management как off-pool, §13.6 hard-rule tier-таблица, §13.9/§13.10 hard-link на R10/R14 +- [docs/Pravila_raboty_Claude_v1_1.md](Pravila_raboty_Claude_v1_1.md) **v1.15+** — §12 → sub-policy под ruflo Queen-led routing (v1.14, commit 9c3057b); §14 (new, v1.15) Ruflo Queen routing hard-rule — триггер queen/королева; §12.3 SoT для exclusions, §13 «paired stack + расширенный пул UI-инструментов» + claude-md-management как off-pool, §13.6 hard-rule tier-таблица (§12 + §14 explicit), §13.9/§13.10 hard-link на R10/R14 - [docs/Tooling_v8_3.md](Tooling_v8_3.md) **v2.0+** — реестр инструментов (+§4.10 Orchestration layer); #30 Frontend Design + #31 UPM + #32 21st Magic MCP + #33 claude-md-management + §6 +5 конфликтов v1.4 (строка «framer-motion ↔ motion-v» — historical после v2.0) + §7 7-уровневая иерархия (с v1.14 +Tooling explicit slot 2b) + §9.2 motion-runtime guidance (technical-only после v1.16); §10.3 шаг 2 sync (14 skills) с v1.14 > **Техническая особенность Claude Code:** при первой установке Frontend Design plugin в долгой сессии плагин не появляется в системном списке доступных skills до старта **новой** сессии (новый чат, не reload). Это конструктивная особенность Claude Code (skill list = constant per conversation), не правило и не баг. Файлы плагина доступны на диске сразу, инвокация через `Skill` tool — только в новом чате. diff --git a/docs/Tooling_v8_3.md b/docs/Tooling_v8_3.md index d5169b4a..57a75b9c 100644 --- a/docs/Tooling_v8_3.md +++ b/docs/Tooling_v8_3.md @@ -382,6 +382,8 @@ **Runtime state (2026-05-15 afternoon — full activation):** ruflo установлен глобально (`npm i -g ruflo`); MCP server в `.mcp.json` (7-й server, stdio mode). **Daemon ACTIVE** под PM2 (`ruflo-daemon`, 5 workers: map/audit/optimize/consolidate/testgaps); reboot-survival — Windows Task Scheduler `PM2-ruflo-daemon` (`pm2 resurrect` onlogon — ruflo native `install-supervisor` поддерживает только launchd/systemd, pm2-windows-service deprecated/broken non-interactive → fallback). **Hive-mind ACTIVE** — Queen-led (`hive-mind init -t hierarchical-mesh -c byzantine`) + 9 worker-агентов idle. **Memory** — sql.js `.swarm/memory.db` + реальные embeddings `Xenova/all-MiniLM-L6-v2` 384-dim (потребовало sharp/libvips fix: `@xenova/transformers` hard-зависит от `sharp`, prebuilt libvips download timeout'ит — curl tarball в `/_libvips/` cache). **Известные alpha-bugs:** `ruflo memory store` CLI не персистит между process-invocations (in-memory sql.js не флашится на диск); daemon worker-jitter усиливает частоту Pest quirk 72 (Redis supplier:session race) — рекомендуется `pm2 stop ruflo-daemon` на baseline regression. **$-расход near-zero** — `ruflo doctor` показывает «No API keys found», daemon/agents не делают платных LLM-вызовов; cost-cap `RUFLO_DAEMON_MAX_USD_PER_DAY=10` в `.env.local` + injected в PM2 daemon env как belt. **Verification:** `ruflo doctor` 10 passed / 7 warnings (alpha/optional); Pest --parallel 0 регрессий от ruflo (quirk 72 flake классифицирован `pest-parallel-debugger` агентом — ruflo grep'ом подтверждённо не трогает Redis :6379). +**Queen trigger (2026-05-15):** триггер-слова `queen`/`королева` в промпте → безусловный route задачи через ruflo Queen (`hive-mind spawn --claude`) — explicit hard-rule **Pravila §14**. Enforcement — UserPromptSubmit-хук `tools/ruflo-queen-hook.mjs`. Перед платным спавном — превью + подтверждение (cost-gate). Без триггера нетривиальные задачи — проактивное предложение ruflo-spawn (§14.3). Связано: spec/plan `docs/superpowers/{specs,plans}/2026-05-15-ruflo-queen-trigger-and-delegation*`. + **Plugin discovery риск:** IPFS gateways Pinata + Cloudflare FAILED 2026-05-15; работает только `ipfs.io`. Operational risk #11 (spec §10.3). **Связано:** spec [superpowers/specs/2026-05-15-ruflo-integration-design.md](superpowers/specs/2026-05-15-ruflo-integration-design.md) (commit `e55572e`+`a68a0a0`), plan [superpowers/plans/2026-05-15-ruflo-big-bang-integration.md](superpowers/plans/2026-05-15-ruflo-big-bang-integration.md) (commit `18c4463`+`9bd1bae`), map fork `automation-graph-ruflo.html` (commit `796d814`, влит в `docs/automation-graph.html` iter4 и удалён `d18b60f`). Нормативная инверсия: Pravila v1.14 §12 sub-policy (commit `9c3057b`), PSR_v1 v3.0 R0 sub-policy (commit `d30cbeb`), CLAUDE.md v2.0 §1 уровень −1 (commit `5df88a1`). @@ -674,7 +676,7 @@ Vuetify-тема — `liderraLight` и `liderraDark` — определена в --- -*Прил. Н v2.0 от 15.05.2026 — Ruflo big-bang: добавлен orchestration layer (ruflo) как четвёртая off-phase подкатегория (§4.10). 55 позиций (35 формализованных позиций + 20 ruflo plugins). ruflo — entry-point уровня −1 над 8-уровневой иерархией Лидерры.* +*Прил. Н v2.1 от 15.05.2026 — Ruflo big-bang: добавлен orchestration layer (ruflo) как четвёртая off-phase подкатегория (§4.10). 55 позиций (35 формализованных позиций + 20 ruflo plugins). ruflo — entry-point уровня −1 над 8-уровневой иерархией Лидерры. v2.1 — §4.10 +абзац «Queen trigger» (Pravila §14, хук ruflo-queen-hook.mjs).* *Прил. Н v1.17 от 13.05.2026 (day +1) — формализация retrospective off-phase MCP #34 Sentry + #35 Redis (debug-runtime category). 35 позиций (29 активных по фазам + 5 off-phase + 1 заменённый PG MCP исторически).*