Compare commits

...

1 Commits

Author SHA1 Message Date
Дмитрий 67861270d6 docs(spec): реколлаж ruflo в иерархии — декларация vs фактический рантайм
Дизайн-спека приведения нормативки к рантайму: убрать уровень -1 «ruflo entry-point для ВСЕХ задач» (рантайм — 0 задач, рой idle, 0 enforcement); §12 Superpowers и PSR_v1 R0 → обратно hard-rule/top-gate; §14 queen-триггер сохраняется без изменений; ruflo переописывается advisory/automation-подсистемой. Утверждена заказчиком 16.05.2026.

cspell-words.txt: +реколлажирована/реколлажем/фоллбэк.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-16 10:41:02 +03:00
2 changed files with 87 additions and 0 deletions
+5
View File
@@ -1267,3 +1267,8 @@ pvalid
# economy 5% level — spec/plan (2026-05-16)
коммитятся
# ruflo hierarchy factual recollage spec (2026-05-16) — Russian inflections
реколлажирована
реколлажем
фоллбэк
@@ -0,0 +1,82 @@
# Реколлаж ruflo в иерархии — приведение декларации к фактическому рантайму
**Дата:** 2026-05-16
**Статус:** дизайн утверждён заказчиком (ответ «да», 16.05.2026)
**Тип:** нормативный рефактор (правки документации, без кода)
**Связано:** spec/plan ruflo big-bang `docs/superpowers/{specs,plans}/2026-05-15-ruflo-*`; Pravila §0/§12/§14; CLAUDE.md §1/§3.5; PSR_v1 R0; Tooling §4.10/§7
---
## 1. Проблема
15.05.2026 ruflo-интеграция («big-bang») задекларировала ruflo Queen-led routing **уровнем 1** priority chain — entry-point для ВСЕХ задач, «чистый верх» над всей 8-уровневой иерархией. Под эту инверсию §12 Superpowers (hard-rule) и PSR_v1 R0 (top-of-stack gate) переписаны в **sub-policy под ruflo Queen-led routing**.
Инспекция рантайма 15.05.2026: hive-mind — Queen + ~10 generic-воркеров, **0 задач и 0 раундов консенсуса** за всё время существования; рой idle; Claude-сессии работают **напрямую**, не через Queen. Механизма enforcement «всё идёт через Queen» нет: единственный реальный механизм — UserPromptSubmit-хук `tools/ruflo-queen-hook.mjs` — лишь инжектит директиву на триггер `queen`/`королева` (§14), а не маршрутизирует все задачи.
**Конфликт:** декларация утверждает факт, которого в рантайме нет — «entry-point для ВСЕХ задач». Это нормативная ложь без enforcement.
**Прецедент:** карта `docs/automation-graph.html` уже реколлажирована к рантайму (iter5, 15.05.2026) — нормативка просто отстала от карты.
---
## 2. Решение: ruflo стоит там, где стоит фактически
Заказчик: «посмотри где он стоит в иерархии фактически — там он и будет стоять».
### 2.1. Фактическое размещение компонентов ruflo
| Компонент ruflo | Рантайм (инспекция 15.05) | Фактический уровень иерархии |
|---|---|---|
| Queen-routing «entry-point для ВСЕХ задач» | 0 задач, 0 раундов консенсуса, рой idle, Claude работает напрямую | **не существует** — убрать уровень −1 |
| §14 queen-триггер `ruflo-queen-hook.mjs` | работает — инжектит директиву на queen/королева | *правило* §14 — Pravila (уровень 1, explicit hard-rule); *хук* — settings.json (**уровень 4**) |
| recall-хук `ruflo-recall-hook.mjs` | работает — инжектит memory recall в каждый промпт | settings.json hook — **уровень 4** |
| daemon (PM2, 5 workers) | работает — background map/audit/optimize/consolidate/testgaps, 0 LLM-вызовов | фоновая подсистема — **вне priority chain** |
| memory (sql.js + embeddings 384-dim) | работает — персистит после H7-патча | данные для recall-хука — вне chain |
| MCP-server (~210 tools) | доступен в `.mcp.json`, как playwright/github/boost/semgrep/sentry/redis | инструмент — **уровень 6** (off-phase MCP) |
**Вывод:** ruflo фактически НЕ на уровне −1. Реально работают: два UserPromptSubmit-хука (уровень 4), daemon + memory (фоновая подсистема, вне priority chain), MCP-server (уровень 6). «Entry-point / overlord над иерархией» в рантайме отсутствует.
### 2.2. Целевое состояние — 7 изменений
1. **Убрать уровень 1** из priority chain: CLAUDE.md §1, Pravila §0, PSR_v1 R0.1, Tooling §7. Цепочка возвращается к 8-уровневой `0→6` (форма до 15.05).
2. **§12 Superpowers** — `sub-policy под ruflo Queen-led routing` → обратно **explicit hard-rule** (уровень 0). Откат title §12 + первого абзаца + §12.4 Pravila.
3. **PSR_v1 R0**`Sub-policy: paired-stack delegation pattern (под ruflo Queen-led routing)` → обратно **top-of-stack gate**. R0.1 таблица, R0.2 gate-диаграмма, R0.5.
4. **§14 — содержание не трогаем.** Единственная честная, работающая, заказчиком-заказанная часть ruflo-интеграции; §14.7/§14.8 уже честно описывают: хук инжектит директиву, alpha-spawn может упасть → прямой фоллбэк. Остаётся explicit hard-rule. **Исключение:** §14.6 cross-ref «ruflo — уровень −1, §12 — уровень 0» правится — уровня −1 больше нет; §14 остаётся в Pravila как explicit hard-rule (уровень 1, наравне с §12 уровня 0), ruflo как цель маршрута §14 — инструмент (хук уровня 4 + MCP уровня 6).
5. **Tooling §4.10**`Orchestration layer (ruflo) — entry-point иерархии``ruflo — параллельная advisory/automation-подсистема (off-phase)`. Убрать «entry-point для ВСЕХ задач», «уровень −1», «первичная классификация задач», «delegate в sub-policy». Оставить фактику: §14-хук, recall-хук, daemon, memory, MCP-tools, $-near-zero, alpha-bugs.
6. **CLAUDE.md §3.5** — аналогичный реколлаж: ruflo не «чистый верх над 8-уровневой иерархией», а advisory-подсистема (два хука + daemon + memory + MCP). §3 title «Карта 35 инструментов + ruflo orchestration layer» → «Карта 35 инструментов + ruflo advisory-подсистема» (consistency с реколлажем Tooling §4.10). Через `claude-md-management:claude-md-improver` (CLAUDE.md §5 п.10).
7. **Memory**`project_state.md` NB «ruflo — parallel subsystem, не фактический entry-point Claude-сессий» уже честен; синхронизировать остальные ruflo-факты (`reference_archive.md`, `project_ruflo_integration.md`, MEMORY.md version refs).
---
## 3. Проверка ограничения «функциональность ruflo и Claude не страдает»
- **ruflo:** §14-триггер, recall-хук, daemon (PM2 + Task Scheduler reboot-survival), memory (H7-патч), ~210 MCP-tools — всё работает и **остаётся без изменений**. Меняется только ложная нормативная *рамка* «overlord уровня −1», не код и не функциональность.
- **Claude:** §12 возвращается из «routing preference» в explicit hard-rule → дисциплина Superpowers **усиливается** (15.05 её номинально понизили). PSR_v1 R0 возвращается в top-gate → классификация задач снова детерминирована. Функциональность Claude улучшается, не страдает.
---
## 4. Затрагиваемые файлы и version bumps
| Файл | Что меняется | Bump | Канал правки |
|---|---|---|---|
| `docs/Pravila_raboty_Claude_v1_1.md` | §0 priority note, §12 title + абзац + §12.4, §13.6 tier-table cross-refs, §14.6 cross-ref | v1.15 → v1.16 | прямой Edit |
| `CLAUDE.md` | §1 priority chain (убрать 1), §3 title, §3.5, §0 cross-refs, §6 фаза, §9 changelog | v2.1 → v2.2 | `claude-md-management:claude-md-improver` (§5 п.10) |
| `docs/Plugin_stack_rules_v1.md` | R0 title + R0.1 таблица + R0.2 + R0.5, шапка cross-refs | v3.1 → v3.2 | прямой Edit |
| `docs/Tooling_v8_3.md` | §4.10 (реколлаж), §7 priority chain, §0 cross-refs | v2.1 → v2.2 | прямой Edit |
| `memory/*.md` | sync ruflo-фактов | — | прямой Write |
---
## 5. Вне scope / non-goals
- **НЕ удаляем** ruflo, §14, recall-хук, daemon, memory, MCP-server — функциональность сохраняется полностью.
- **НЕ строим** реальный routing-runtime: требует API-ключей (заказчик: «стоп агенты руфло без api ключа»), противоречит принципу «$-расход near-zero», упирается в alpha-надёжность `hive-mind spawn`.
- **НЕ трогаем** содержание §14 (queen-триггер hard-rule) — кроме cross-ref §14.6 «уровень −1».
- **НЕ трогаем** код рантайма ruflo: daemon, H7-патч, хуки `.mjs`, `.mcp.json`, `.env.local` cost-cap — без изменений.
- **НЕ удаляем** off-phase категорию ruflo в Tooling — она остаётся, переформулируется из «orchestration entry-point» в «advisory/automation subsystem».
---
## 6. Открытые вопросы
0 — дизайн полностью определён, заказчик утвердил направление и factual-placement принцип.