# Реколлаж ruflo в иерархии — Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Привести нормативку (Pravila / CLAUDE.md / PSR_v1 / Tooling) к фактическому рантайму ruflo — убрать уровень −1 «entry-point для ВСЕХ задач», вернуть §12 Superpowers и PSR_v1 R0 в hard-rule / top-of-stack gate; §14 queen-триггер сохранить.

**Architecture:** Координированный реколлаж 4 нормативных markdown-файлов + 4 memory-файлов. Каждый нормативный файл — отдельный атомарный коммит (паттерн ruflo big-bang: «5 commits — 4 normative files»). CLAUDE.md правится только через `claude-md-management:claude-md-improver` (CLAUDE.md §5 п.10). Финальная cross-consistency проверка grep'ом по всем 4 файлам.

**Tech Stack:** Markdown-нормативка; git lefthook pre-commit (gitleaks + markdownlint + cspell); lychee — pre-push. Кода нет → TDD неприменим; верификация задачи = lint-gates + структурный grep.

**Спека:** `docs/superpowers/specs/2026-05-16-ruflo-hierarchy-factual-recollage-design.md` (commit `6786127`).

---

## File Structure

| Файл | Ответственность правки | Канал | Bump |
|---|---|---|---|
| `docs/Pravila_raboty_Claude_v1_1.md` | §0 priority note, §12 (title+¶+§12.4), §13.6/§13.9/§13.10 cross-refs, §14.6 cross-ref, шапка | прямой Edit | v1.15 → v1.16 |
| `docs/Plugin_stack_rules_v1.md` | R0 (title+R0.1+R0.2+R0.5), шапка cross-refs | прямой Edit | v3.1 → v3.2 |
| `docs/Tooling_v8_3.md` | §4.10 (реколлаж), §7 (verify), §0 cross-refs, шапка | прямой Edit | v2.1 → v2.2 |
| `CLAUDE.md` | §1 priority chain, §3 title, §3.5, §0 cross-refs, §6, §9 | `claude-md-management:claude-md-improver` | v2.1 → v2.2 |
| `memory/project_state.md`, `reference_archive.md`, `project_ruflo_integration.md`, `MEMORY.md` | sync ruflo-фактов | прямой Write | — |

**Инвариант после всех задач:** во всех 4 файлах priority chain не содержит уровня −1; §12 и R0 — hard-rule / top-gate; §14 — explicit hard-rule без изменения содержания.

**Порядок:** Tasks 1-3 независимы (разные файлы) — могут идти параллельно. Task 4 (CLAUDE.md) — после 1-3, чтобы плагин видел согласованную нормативку. Task 5 — после 1-4. Task 6 — финальная проверка.

---

## Task 1: Pravila — реколлаж §0/§12/§13/§14, v1.15 → v1.16

**Files:**

- Modify: `docs/Pravila_raboty_Claude_v1_1.md`

- [ ] **Step 1: Read целевые секции**

Прочитать §0 (priority chain note), §12 (строки ~591-660), §13.6/§13.9/§13.10 (~707-770), §14.6 (~795-802), шапку (строки 1-12). Зафиксировать текущие формулировки перед Edit.

- [ ] **Step 2: §12 title + первые два абзаца → hard-rule**

Title `## 12. Superpowers — sub-policy (ruflo routing preference)` → `## 12. Superpowers — hard rule (инвокация skills первой)`.

Абзац-1 (`Введено 09.05.2026...`): убрать предложение `Переведено из hard rule в sub-policy 15.05.2026 (v1.14)...`.

Абзац-2 (`С v1.14 (15.05.2026) §12 — sub-policy под ruflo...`) заменить на:

> §12 — **explicit hard-rule**: перед содержательной задачей соответствующий Superpowers-skill (карта §12.2) инвокируется первым. §9 «Отступления» к §12 не применяется (§12.4). Карта §12.2, exclusions §12.3 и детали §12.4 — в силе.

- [ ] **Step 3: §12.4 первый буллет → откат к hard-rule**

Буллет `ruflo Queen может delegate non-Superpowers tools, если routing-pattern matches non-interactive criteria; §9 «Отступления» формально применяется через ruflo routing layer.` заменить на:

> - §9 «Отступления» к §12 **не применяется** — §12 explicit hard-rule. Единственная отмена — явный запрос заказчика «не используй superpowers сейчас», только на текущее действие.

Остальные буллеты §12.4 (приоритет над §1–§11, запрет рационализации, запрет переформулировки) — без изменений.

- [ ] **Step 4: §0 priority note — убрать ruflo уровень −1**

В §0 priority-chain note: убрать любое упоминание ruflo как уровня −1 / entry-point. §12 и §14 остаются двумя explicit hard-rule. Цепочка начинается с §12 (hard-rule) → §1–§13. Если §0 содержит фразу про «ruflo Queen-led routing уровень −1» — удалить; §14 как hard-rule сохраняется (он про маршрут queen-триггера, не про уровень иерархии).

- [ ] **Step 5: §14.6 cross-ref**

В §14.6 строка `Порядок — по CLAUDE.md §1 priority chain (ruflo — уровень −1, §12 — уровень 0).` → `Порядок — по CLAUDE.md §1 priority chain: §12 — explicit hard-rule (уровень 0), §14 — explicit hard-rule наравне с §12. ruflo как цель маршрута §14 — инструмент (хук + MCP), не уровень иерархии.`

Содержание §14.1–§14.5, §14.7, §14.8 — **не трогать**.

- [ ] **Step 6: §13.9/§13.10 PSR_v1 version cross-refs**

В §13.9 и §13.10 заменить `(v3.0+, R0 → sub-policy под ruflo Queen-led routing)` → `(v3.2+, R0 — top-of-stack gate)`. §13.6 tier-таблица — проверить: §12 уже значится explicit hard-rule (правок не требует, реколлаж устраняет рассинхрон title↔таблица).

- [ ] **Step 7: Шапка — v1.15 → v1.16**

Строка `**Версия:** v1.15` → `v1.16`; дата → `16.05.2026`. Добавить блок `**Что изменилось в v1.16 относительно v1.15:**` — реколлаж ruflo к рантайму: §12 sub-policy → hard-rule, §0/§14.6 убран уровень −1, §13.9/§13.10 cross-refs; связано с CLAUDE.md v2.2 / PSR_v1 v3.2 / Tooling v2.2; spec `docs/superpowers/specs/2026-05-16-ruflo-hierarchy-factual-recollage-design.md`.

- [ ] **Step 8: Verify + commit**

Run: `cd "c:/моя/проекты/портал crm/Документация" && git add docs/Pravila_raboty_Claude_v1_1.md && git commit -m "docs(rules): Pravila v1.16 — реколлаж ruflo, §12 sub-policy → hard-rule"`
Expected: lefthook pre-commit зелёный (gitleaks 0, markdownlint 0, cspell 0); commit создан. Если cspell ругается на новые слова — добавить в `cspell-words.txt` в тот же коммит.

---

## Task 2: PSR_v1 — реколлаж R0, v3.1 → v3.2

**Files:**

- Modify: `docs/Plugin_stack_rules_v1.md`

- [ ] **Step 1: Read целевые секции**

Прочитать шапку (строки 1-23, cross-refs к CLAUDE.md/Pravila/Tooling), R0 целиком (строки ~24-135).

- [ ] **Step 2: R0 title**

`## Правило 0 — Sub-policy: paired-stack delegation pattern (под ruflo Queen-led routing)` → `## Правило 0 — Stack-gate: paired-stack delegation pattern`.

- [ ] **Step 3: R0.1 таблица — убрать строку −1**

Удалить строку таблицы `| **−1** | **ruflo Queen-led routing (entry-point, v3.0+)** | ✅ stack делегирует ruflo... |`. Таблица начинается с уровня 0. В строке уровня 3 (`PSR_v1 (этот документ)`) колонку «Stack головной?» вернуть с `sub-policy ruflo routing...` на исходное (PSR_v1 — сам stack-документ; формулировка как до v3.0). Текст-преамбулу R0.1 «Stack — головной... под ruflo Queen-led routing» очистить от ruflo-уровня −1.

- [ ] **Step 4: R0.2 gate-диаграмма**

Абзац `Каждая задача проходит через ruflo Queen-led routing первой; ruflo либо делегирует... либо handles напрямую через swarm... Stack-gate активируется как sub-policy через ruflo routing-decision...` заменить на исходную формулировку top-of-stack gate: каждая задача проходит через STACK GATE первой среди слоёв; gate обращается к Superpowers + Frontend Design. ASCII-диаграмма gate — без изменений (она уже про STACK GATE).

- [ ] **Step 5: R0.5 — проверка**

R0.5 «Перекрытие нижних слоёв» — убрать упоминание ruflo как слоя выше stack'а, если есть. Stack ниже только: прямые инструкции пользователя + файлы CLAUDE.md/Pravila/Tooling.

- [ ] **Step 6: Шапка — v3.1 → v3.2 + cross-refs**

Версия → v3.2, дата 16.05.2026. Cross-refs к Pravila → v1.16, CLAUDE.md → v2.2, Tooling → v2.2. Запись в «История версий»: реколлаж R0 sub-policy → top-of-stack gate (ruflo не entry-point по факту рантайма).

- [ ] **Step 7: Verify + commit**

Run: `git add docs/Plugin_stack_rules_v1.md && git commit -m "docs(rules): PSR_v1 v3.2 — реколлаж ruflo, R0 sub-policy → top-of-stack gate"`
Expected: lefthook зелёный; commit создан.

---

## Task 3: Tooling — реколлаж §4.10/§7/§0, v2.1 → v2.2

**Files:**

- Modify: `docs/Tooling_v8_3.md`

- [ ] **Step 1: Read целевые секции**

Прочитать §4.10 (строки ~371-389), §7 (~428-453), §0 cross-refs, шапку.

- [ ] **Step 2: §4.10 — реколлаж заголовка и роли**

Заголовок `### 4.10. Orchestration layer (ruflo) — entry-point иерархии (off-phase)` → `### 4.10. ruflo — advisory/automation-подсистема (off-phase)`.

Удалить/переписать: фразу `встаёт «чистым верхом» над 8-уровневой иерархией ... уровень −1`; блок `**Архитектурная роль:** entry-point для ВСЕХ задач (уровень −1 иерархии)...delegate в sub-policy...`.

Целевая «Архитектурная роль»:

> **Архитектурная роль:** параллельная advisory/automation-подсистема, **не** entry-point. Фактический рантайм (инспекция 15.05.2026): hive-mind idle, 0 задач / 0 раундов консенсуса; Claude-сессии работают напрямую. Реально работают: UserPromptSubmit-хуки `ruflo-queen-hook.mjs` (§14 queen-триггер) и `ruflo-recall-hook.mjs` (memory recall) — уровень settings.json; daemon (PM2) и memory — фоновая подсистема вне priority chain; MCP-server (~210 tools) — off-phase инструмент.

Блоки «Runtime state», «Queen trigger», «Cost-budget», «Plugin discovery риск», «Связано» — сохранить (фактика), убрать из них формулировки «entry-point»/«уровень −1»/«delegate в sub-policy».

- [ ] **Step 3: §7 priority chain — verify**

§7 chain уже без уровня −1 (начинается с `0. Pravila §12`). Проверить grep'ом, что §7 не содержит «ruflo»/«уровень −1» в самой цепочке. Ожидаемо — правок 0; если найдётся ruflo-ссылка — убрать.

- [ ] **Step 4: §0 cross-refs + шапка — v2.1 → v2.2**

§0 cross-refs к Pravila → v1.16, PSR_v1 → v3.2, CLAUDE.md → v2.2. Шапка/Прил. Н версия → v2.2, дата 16.05.2026, запись об изменении: §4.10 реколлаж entry-point → advisory-подсистема.

- [ ] **Step 5: Verify + commit**

Run: `git add docs/Tooling_v8_3.md && git commit -m "docs(rules): Tooling v2.2 — реколлаж §4.10 ruflo entry-point → advisory-подсистема"`
Expected: lefthook зелёный; commit создан.

---

## Task 4: CLAUDE.md — реколлаж §1/§3/§3.5/§0/§6/§9, v2.1 → v2.2

**Files:**

- Modify: `CLAUDE.md` — **только через `claude-md-management:claude-md-improver`** (CLAUDE.md §5 п.10; прямой Edit запрещён).

- [ ] **Step 1: Инвокировать плагин**

Вызвать `/claude-md-management:claude-md-improver` с targeted change-set ниже. Плагин синхронно проверяет cross-refs Pravila + Tooling (CLAUDE.md §5 п.7) — к моменту Task 4 они уже v1.16 / v2.2 (Tasks 1-3 закрыты).

- [ ] **Step 2: §1 priority chain — убрать уровень −1**

Удалить строку `−1.  ruflo Queen-led routing (entry-point для ВСЕХ задач...)` + стрелку `↓` после неё + завершающий абзац `**Уровень −1 ruflo Queen-led routing** — entry-point с v2.0...`. Цепочка начинается с `0. Pravila §12 — Superpowers hard rule`. Строка уровня 0 уже корректна («Superpowers hard rule») — не трогать.

- [ ] **Step 3: §3 title**

`## 3. Карта 35 инструментов + ruflo orchestration layer...` → `## 3. Карта 35 инструментов + ruflo advisory-подсистема...`.

- [ ] **Step 4: §3.5 — реколлаж**

§3.5 «Off-phase orchestration: ruflo (entry-point иерархии)»: заголовок → `### 3.5. Off-phase: ruflo — advisory/automation-подсистема`. Тело: убрать `entry-point для ВСЕХ задач (level −1)`, `делает первичную классификацию ... delegate в sub-policy`, `встаёт «чистым верхом»`. Заменить роль на: параллельная advisory-подсистема — §14 queen-триггер хук + recall-хук + daemon + memory + MCP-tools; рантайм 0 задач, рой idle. «Runtime state» и «Queen trigger» абзацы — фактику сохранить, формулировки entry-point убрать.

- [ ] **Step 5: §0 cross-refs**

§0 row'ы: Pravila → v1.16, PSR_v1 → v3.2, Tooling → v2.2 (с краткими аннотациями реколлажа).

- [ ] **Step 6: §6 + §9**

§6 «Текущая фаза» — добавить абзац о реколлаже ruflo (декларация приведена к рантайму). §9 «История версий» — запись v2.2.

- [ ] **Step 7: Verify + commit**

Плагин отвечает за качество по своим quality-criteria. После применения:
Run: `git add CLAUDE.md docs/Pravila_raboty_Claude_v1_1.md docs/Tooling_v8_3.md` (если плагин синхронно дотронул cross-refs) `&& git commit -m "docs(rules): CLAUDE.md v2.2 — реколлаж ruflo, убран уровень −1"`
Expected: lefthook зелёный. Если Pravila/Tooling уже закоммичены в Tasks 1/3 и не менялись — в коммите только `CLAUDE.md`.

---

## Task 5: Memory sync

**Files:**

- Modify: `memory/project_state.md`, `memory/reference_archive.md`, `memory/project_ruflo_integration.md`, `memory/MEMORY.md`

- [ ] **Step 1: Re-Read каждый memory-файл**

Перед правкой — Read каждого (memory-факты не доверять stale).

- [ ] **Step 2: Правки**

- `project_state.md` — NB «ruflo — parallel subsystem, не фактический entry-point» уже честен; добавить факт реколлажа нормативки (Pravila v1.16 / CLAUDE.md v2.2 / PSR_v1 v3.2 / Tooling v2.2) + commit-хеши.
- `reference_archive.md` — version refs Pravila/CLAUDE.md/PSR/Tooling → новые версии; пометка «ruflo — advisory-подсистема, не entry-point».
- `project_ruflo_integration.md` — добавить S6: реколлаж декларации к рантайму (откат бумажной инверсии §12/R0).
- `MEMORY.md` — обновить однострочники-указатели на изменённые файлы.

- [ ] **Step 3: Verify**

`reference_archive.md` / `MEMORY.md` — внутренняя консистентность версий. Memory вне git lefthook scope (вне репо-tracked? — проверить: memory-каталог в `C:\Users\...\.claude\projects\...` вне репозитория проекта, git-коммит не требуется).

---

## Task 6: Финальная cross-consistency проверка

**Files:** все 4 нормативных файла (read-only проверка).

- [ ] **Step 1: Grep остатков уровня −1**

Run: `cd "c:/моя/проекты/портал crm/Документация"` затем grep по `docs/Pravila_raboty_Claude_v1_1.md`, `CLAUDE.md`, `docs/Plugin_stack_rules_v1.md`, `docs/Tooling_v8_3.md` паттернов: `уровень −1`, `уровня −1`, `entry-point для ВСЕХ`, `sub-policy под ruflo`, `Queen-led routing` (как уровня иерархии), `чистым верхом`.
Expected: 0 совпадений в значении «ruflo = overlord». Допустимы вхождения в §9/История версий (описание прошлой версии) и §14 (queen-триггер маршрут) — глазами отделить.

- [ ] **Step 2: Grep консистентности priority chain**

Проверить, что priority chain во всех 4 файлах начинается с уровня 0 (Pravila §12 hard-rule) и идентичен по уровням 0–6.

- [ ] **Step 3: Verify §14 не повреждён**

Grep §14 в Pravila: §14.1–§14.5/§14.7/§14.8 — содержание прежнее; изменён только §14.6 cross-ref. §14 остаётся explicit hard-rule.

- [ ] **Step 4: lychee (pre-push)**

Run: `npm run links` — проверка ссылок в изменённых .md (новые spec/plan ссылки, cross-refs).
Expected: 0 broken.

- [ ] **Step 5: Итог**

`superpowers:verification-before-completion` перед claim «реколлаж завершён». Сводка: 4 коммита нормативки + memory sync; grep-проверки чистые; lychee 0 broken. Push — по явному «пуш» от заказчика.

---

## Self-Review (выполнен при написании плана)

- **Spec coverage:** 7 изменений спеки §2.2 → Task 1 (изм. 2,4 §12; часть 4 §14.6), Task 2 (изм. 3 R0), Task 3 (изм. 1 chain в §7 + изм. 5 §4.10), Task 4 (изм. 1 chain §1 + изм. 6 §3.5), Task 5 (изм. 7 memory). Изм. 1 (убрать уровень −1) распределено по всем файлам — покрыто Tasks 1-4 + проверено Task 6. ✓
- **Placeholders:** нет TBD/TODO; целевые формулировки даны для title/cross-ref/priority chain; для длинных рерайтов (§4.10/§3.5/§0-note) — структурный спек с required/forbidden фразами + «read current first». ✓
- **Type consistency:** версии сквозные — Pravila v1.16, PSR_v1 v3.2, Tooling v2.2, CLAUDE.md v2.2 во всех cross-ref'ах и шапках. ✓
- **Ограничение:** §14 содержание не трогается ни в одной задаче (только §14.6 cross-ref); код рантайма ruflo не затрагивается. ✓
