liderra/portal
1
0
Fork 0
Code Issues Pull Requests Actions 82 Packages Projects Releases Wiki Activity

chore(spec): Phase 1 pre-flight findings — sync spec + plan + cspell vocab

Browse Source 
Phase 1 Task 0 verifications executed on 2026-05-15 against live Windows
Server 2022 + native PowerShell elevation + Node.js stack:

- Task 1.1 npm view: ruflo v3.7.0-alpha.38 (not alpha.33 as spec assumed),
  MIT, repository.url = ruvnet/claude-flow.git (rename Jan-2026 incomplete
  in npm metadata; plugin namespace also remains @claude-flow/*).
- Task 1.2 CLI: 33+ subcommands available — init, mcp, plugins, daemon,
  doctor, hive-mind (Queen-led consensus), autopilot, claims, cleanup, etc.
- Task 1.3 plugins list: 20 plugins in IPFS-registry (not 32 as spec
  estimated). Registry CID QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2
  fetched via IPFS — gateway.pinata.cloud + cloudflare-ipfs.com FAILED,
  only ipfs.io worked. 6 core + 1 command + 13 integration. 11 CRM-relevant;
  9 nichе (medical/legal/financial/quantum). User decision gate confirmed
  «full big-bang — all 20» despite material delta from spec.
- Task 1.4 disk: 67 GB free (>> 5 GB requirement).
- Task 1.5 elevation: TRUE — pm2-service-install без эскалации заказчику.
- Task 1.5.2 PM2 not yet installed.
- Task 1.6 MCP: stdio mode confirmed (INFO [claude-flow-mcp] Starting
  in stdio mode) — no port conflict with existing MCP entries. Resolves
  spec §12 Q5.

Material changes vs original spec/plan:
- 32 → 20 plugins (1.6× smaller actual scope)
- 100+ → 60+ agents (per npm description)
- Plugin namespace ruflo-* → @claude-flow/* (legacy)
- Added §10.3 risks #11 (IPFS gateway), #12 (alpha version inconsistency
  3.0.0-alpha.1..8), #13 (namespace mismatch documentation cost)
- §3 rewritten with concrete 20-plugin table and CLI subcommand list
- §12 Q1/Q4/Q5/Q7 marked RESOLVED with concrete answers
- §12 +Q11 (IPFS) +Q12 (version inconsistency)

cspell vocab additions: ruvector, ipfs, xenova, onnxruntime (lowercase
per user-dict case rule, see commit e55572e for prior precedent).

Plan synced: alpha.33 → alpha.38 (replace_all), 32 plugins references
patched at 8 specific locations. Tooling §0 row description updated:
+20 plugins (35 → 55 formalized), not +32 (35 → 67).

Awaiting user OK for Phase 2 (destructive scaffolding starts at Task 2.1
CLAUDE.md backup + Task 2.2 npx ruflo init).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Дмитрий
2026-05-15 09:50:53 +03:00
parent 0ae92e2937
commit a68a0a0ccb
3 changed files with 99 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files
cspell-words.txt
+4
View File
@@ -1166,6 +1166,10 @@ ruvnet
hnsw
sona
ruvllm
ruvector
ipfs
xenova
onnxruntime
многоагентный
форк
форка
docs/superpowers/plans/2026-05-15-ruflo-big-bang-integration.md
+13 -13
View File
@@ -6,7 +6,7 @@
**Architecture:** ruflo Queen-led routing — entry-point для всех задач; SONA neural pattern classifier → swarm dispatch / sub-policy delegate. Existing 8-level hierarchy (Pravila §12 → … → memory) становится 9-level где ruflo на уровне −1. Существующие hard rules переезжают в `CLAUDE.local.md` (gitignored) как ruflo sub-policies.
**Tech Stack:** ruflo v3.7.0-alpha.33 (MIT, ruvnet/ruflo, Node.js + Rust WASM kernels), PM2 + pm2-windows-service (Windows daemon), HNSW vector store в `~/.ruflo-cache/`, vis-network 9.1.9 (карта-форк), lefthook pre-commit gauntlet (gitleaks/markdownlint/cspell/pint/larastan/squawk/eslint), Pest 4 + Vitest регрессионные test runners.
**Tech Stack:** ruflo v3.7.0-alpha.38 (MIT, ruvnet/ruflo, Node.js + Rust WASM kernels), PM2 + pm2-windows-service (Windows daemon), HNSW vector store в `~/.ruflo-cache/`, vis-network 9.1.9 (карта-форк), lefthook pre-commit gauntlet (gitleaks/markdownlint/cspell/pint/larastan/squawk/eslint), Pest 4 + Vitest регрессионные test runners.
**Spec reference:** [docs/superpowers/specs/2026-05-15-ruflo-integration-design.md](../specs/2026-05-15-ruflo-integration-design.md) (commit `e55572e`).
@@ -31,7 +31,7 @@
- `docs/Tooling_v8_3.md` — §0 35 → ~67; +§4.10; v1.17 → **v2.0**
- `docs/CHANGELOG_claude_md.md` — entries для v1.14/v3.0/v2.0/v2.0
- `.mcp.json` — +ruflo entry
- `~/.claude/settings.json` — enabledPlugins.ruflo-* (32) + watchdog hook
- `~/.claude/settings.json` — enabledPlugins для 20 `@claude-flow/*` (post Phase 1 Task 1.3) + watchdog hook
- `.gitignore` — +.claude-flow/, +CLAUDE.local.md, +.env.local, +CLAUDE.md.pre-ruflo.bak, +.ruflo-cache/
- `lefthook.yml` — +cost-watchdog job (опционально)
- `cspell-words.txt` — добавлены ruflo/ruvnet/hnsw/sona/ruvllm/многоагентный/форк/форка/bak (уже в commit `e55572e`)
@@ -86,7 +86,7 @@ npx ruflo@latest --help
Expected: список subcommands (`init`, `mcp`, `plugins`, `daemon`, `doctor`, `config`, `cost`, и т. д.). Скопировать output в spec §12 Q10 в Task 1.7. Verify конкретно: `init`, `mcp`, `plugins`, `daemon` subcommands есть.
### Task 1.3: Enumerate 32 plugins
### Task 1.3: Enumerate plugins (фактически 20 в registry)
**Files:** none
@@ -342,7 +342,7 @@ Edit `.mcp.json`, добавить под `mcpServers`:
"ruflo": {
"command": "npx",
"args": ["-y", "ruflo@latest", "mcp", "start"],
"comment": "Ruflo orchestration MCP server — exposes ~210 tools (Core/Intelligence/Agents/Memory/DevTools). v3.7.0-alpha.33+ MIT. Pending sync в Tooling §4.10 (Day 3 Task 3.4)."
"comment": "Ruflo orchestration MCP server — exposes ~210 tools (Core/Intelligence/Agents/Memory/DevTools). v3.7.0-alpha.38+ MIT. Pending sync в Tooling §4.10 (Day 3 Task 3.4)."
}
```
@@ -492,7 +492,7 @@ Expected: .env.local создан, `git status` не показывает его
> 4. §5 ПДн: добавить inline note «(execution-layer rule: gitleaks pre-commit фильтр обеспечивает технический catch; не regulatory rule выше ruflo)»
> 5. §0 cross-refs row: «v2.0+» → «v3.0+» для PSR_v1; «v1.92+» → «v2.0+» для CLAUDE.md; «v1.17+» → «v2.0+» для Tooling
> 6. Header version: v1.13 → v1.14; добавить «Дата: 2026-05-15»
> 7. §9 «История версий» (если есть) или создать раздел: добавить запись «v1.14 от 2026-05-15 — ruflo big-bang sub-policy conversion: §12 hard rule → sub-policy; §5 ПДн execution-layer note. Связано: ruflo v3.7.0-alpha.33 integration via spec/plan 2026-05-15»
> 7. §9 «История версий» (если есть) или создать раздел: добавить запись «v1.14 от 2026-05-15 — ruflo big-bang sub-policy conversion: §12 hard rule → sub-policy; §5 ПДн execution-layer note. Связано: ruflo v3.7.0-alpha.38 integration via spec/plan 2026-05-15»
>
> Return: diff против существующего файла. Не commit yourself, не запускай тесты. Return raw diff as text.»
@@ -575,9 +575,9 @@ git commit -m "docs(psr_v1): R0 → sub-policy + R0.1 +ruflo level −1 + R0.6 +
> ```
>
> Остальные уровни (0-6) — без изменений в нумерации (они становятся «execution layer» под ruflo).
> 4. §3 «Карта 35 инструментов» → «Карта 35 + ruflo (orchestration layer) инструментов»; добавить §3.4 «Off-phase orchestration: ruflo (32 plugins, ~210 MCP tools)» — короткая ссылка на Tooling §4.10
> 4. §3 «Карта 35 инструментов» → «Карта 35 + ruflo (orchestration layer) инструментов»; добавить §3.4 «Off-phase orchestration: ruflo (20 plugins из IPFS-registry `@claude-flow/*`, ~210 MCP tools)» — короткая ссылка на Tooling §4.10
> 5. §5 п.10 «Не править этот CLAUDE.md без…» — добавить inline note «(sub-policy ruflo: claude-md-management остаётся preferred channel через ruflo routing; ruflo agents могут править напрямую при явном routing-decision)»
> 6. §6 «Текущая фаза»: bump «Post-MVP (10.05.2026)» → добавить параграф «**2026-05-15 ruflo big-bang integration:** Установлен ruflo v3.7.0-alpha.33 как Queen-led routing на уровне −1 иерархии. 4 normative files переписаны под sub-policy paradigm. Карта-форк `docs/automation-graph-ruflo.html` (Day 5). Pre-flight Task 0 results: [TBD reference spec §12]. Day 6 regression: [TBD baseline numbers].»
> 6. §6 «Текущая фаза»: bump «Post-MVP (10.05.2026)» → добавить параграф «**2026-05-15 ruflo big-bang integration:** Установлен ruflo v3.7.0-alpha.38 как Queen-led routing на уровне −1 иерархии. 4 normative files переписаны под sub-policy paradigm. Карта-форк `docs/automation-graph-ruflo.html` (Day 5). Pre-flight Task 0 results: [TBD reference spec §12]. Day 6 regression: [TBD baseline numbers].»
> 7. §9 «История версий» — добавить «v2.0 от 2026-05-15 — ruflo big-bang…»
>
> Return diff. Do NOT commit, do NOT touch other files.»
@@ -611,14 +611,14 @@ git commit -m "docs(claude_md): §1 +уровень −1 ruflo + §3.4 orchestra
> Prompt: «Edit `docs/Tooling_v8_3.md`. Read full file first (~3000-5000 lines). Then:
>
> 1. Header version v1.17 → v2.0; date 2026-05-15
> 2. §0 сводка таблица: добавить row «**ruflo orchestration layer** (off-phase, post-MVP 2026-05-15) | npx ruflo@latest + 32 plugins | +32 plugins». Также: bump «Итого формализованных позиций: 35» → «Итого формализованных позиций: 35 + 32 ruflo plugins = ~67»
> 2. §0 сводка таблица: добавить row «**ruflo orchestration layer** (off-phase, post-MVP 2026-05-15) | npx ruflo@latest + 20 plugins | +20 plugins». Также: bump «Итого формализованных позиций: 35» → «Итого формализованных позиций: 35 + 20 ruflo plugins = 55»
> 3. §3.3 «Off-phase tools» — добавить упоминание о новом category «orchestration» с pointer на §4.10
> 4. Новый §4.10 «Orchestration layer (ruflo) — entry-point иерархии (off-phase)»:
>
> ```markdown
> ### §4.10. Orchestration layer (ruflo) — entry-point иерархии (off-phase)
>
> ruflo (ruvnet/ruflo, MIT, v3.7.0-alpha.33+) встаёт «чистым верхом» над 8-уровневой иерархией (см. CLAUDE.md §1). 32 plugins, ~210 MCP tools, 100+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip), HNSW vector memory, SONA neural routing.
> ruflo (npm `ruflo` v3.7.0-alpha.38+, MIT, `ruvnet/claude-flow` legacy repo после rename Jan-2026; plugin-namespace `@claude-flow/*`) встаёт «чистым верхом» над 8-уровневой иерархией (см. CLAUDE.md §1). 20 plugins (IPFS-registry), ~210 MCP tools, 60+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip), HNSW vector memory, SONA neural routing.
>
> **Архитектурная роль:** entry-point для ВСЕХ задач. Делает первичную классификацию (interactive vs autonomous) и delegate в sub-policy stack-gate (paired-stack: Superpowers + Frontend Design) ИЛИ executes via swarm.
>
@@ -631,7 +631,7 @@ git commit -m "docs(claude_md): §1 +уровень −1 ruflo + §3.4 orchestra
> **Связано:** [docs/superpowers/specs/2026-05-15-ruflo-integration-design.md](superpowers/specs/2026-05-15-ruflo-integration-design.md), Pravila v1.14+ §12 sub-policy, PSR_v1 v3.0+ R0 sub-policy, CLAUDE.md v2.0+ §1 уровень −1.
> ```
>
> 5. История версий: добавить «v2.0 (2026-05-15) — ruflo big-bang: §0 +ruflo orchestration row +32 plugins (35 → 67); новая §4.10. Major bump reflects architectural inversion. Связано: spec/plan 2026-05-15, Pravila v1.14, PSR_v1 v3.0, CLAUDE.md v2.0.»
> 5. История версий: добавить «v2.0 (2026-05-15) — ruflo big-bang: §0 +ruflo orchestration row +20 plugins (35 → 55); новая §4.10. Major bump reflects architectural inversion. Связано: spec/plan 2026-05-15, Pravila v1.14, PSR_v1 v3.0, CLAUDE.md v2.0.»
>
> Return diff.»
@@ -1099,12 +1099,12 @@ Edit: «HEAD origin/main = `aa39763`» → «HEAD origin/main = `NEW_HEAD` (rufl
```markdown
---
name: project-ruflo-integration
description: ruflo big-bang integration — Queen-led routing уровень −1, sub-policy paradigm, 32 plugins, daemon mode, 2026-05-15 migration
description: ruflo big-bang integration — Queen-led routing уровень −1, sub-policy paradigm, 20 plugins (post Phase 1), daemon mode, 2026-05-15 migration
metadata:
type: project
---
**2026-05-15 ruflo big-bang merged into main `<new-head>`.** ruflo v3.7.0-alpha.33 встал уровнем −1 как Queen-led routing entry-point. 4 normative files переписаны под sub-policy paradigm: Pravila v1.14 (§12 → sub-policy), PSR_v1 v3.0 (R0 → sub-policy), CLAUDE.md v2.0 (§1 +уровень −1, §3.4 ruflo chapter, §5 п.10 sub-policy note), Tooling v2.0 (§4.10 +Orchestration layer, 35 → ~67 plugins). Карта-форк `docs/automation-graph-ruflo.html` показывает TO-BE архитектуру.
**2026-05-15 ruflo big-bang merged into main `<new-head>`.** ruflo v3.7.0-alpha.38 встал уровнем −1 как Queen-led routing entry-point. 4 normative files переписаны под sub-policy paradigm: Pravila v1.14 (§12 → sub-policy), PSR_v1 v3.0 (R0 → sub-policy), CLAUDE.md v2.0 (§1 +уровень −1, §3.4 ruflo chapter, §5 п.10 sub-policy note), Tooling v2.0 (§4.10 +Orchestration layer, 35 → ~67 plugins). Карта-форк `docs/automation-graph-ruflo.html` показывает TO-BE архитектуру.
**Cost-budget:** `RUFLO_DAEMON_MAX_USD_PER_DAY=10` в `.env.local` (gitignored).
@@ -1132,7 +1132,7 @@ Add line: `- [Ruflo integration](project_ruflo_integration.md) — 2026-05-15 bi
| §1 Goals | Phase 2-7 (полный execution) |
| §1 Non-goals | Plan не упоминает production data / new tests / 35 dupe — respected |
| §2 Architecture (8→9 levels) | Tasks 3.1-3.4 переписывают все 4 normative files |
| §3 Scope (32 plugins) | Task 1.3 enumerate + Task 2.5 enabledPlugins |
| §3 Scope (20 plugins post Phase 1) | Task 1.3 enumerate + Task 2.5 enabledPlugins |
| §4 Sequencing | Phase 1-7 mirror Day 1-7 |
| §5 Map fork | Phase 5 Tasks 5.1-5.9 |
| §6 Memory bridge | Pending — Task 5.8 partial (карта overlay); ruflo memory reindex hook — добавить в plan post-MVP (out of plan scope per §1.7 «no new tests» если interpret as «no new system»). **Gap noted:** добавляю в open questions ниже. |
docs/superpowers/specs/2026-05-15-ruflo-integration-design.md
+82 -45
View File
@@ -10,7 +10,7 @@ related:
- docs/Plugin_stack_rules_v1.md (v2.1 → v3.0 sub-policy)
- docs/Tooling_v8_3.md (v1.17 → v2.0 +ruflo chapter §4.10)
- CLAUDE.md (v1.93 → v2.0 — priority chain rewrite)
- https://github.com/ruvnet/ruflo (upstream, MIT, v3.7.0-alpha.33)
- https://github.com/ruvnet/claude-flow (upstream, MIT, npm ruflo v3.7.0-alpha.38 verified 2026-05-15)
---
# Ruflo integration — full big-bang («чистый верх»)
@@ -19,7 +19,7 @@ related:
**Триггер 15.05.2026 сессия:** заказчик «продолжим работать с картой. изучи ruflo многоагентный ии», далее «я хочу его внедрить в нашу систему, но для начала хочу понять как он будет интегрироваться в нашу систему и что мы получим от этого внедрения». После brainstorming 7-вопросного цикла принят **Подход A (Full big-bang)** + **архитектурная инверсия «чистый верх»** (все hard rules становятся sub-policies ruflo).
**ruflo** (ruvnet/ruflo, v3.7.0-alpha.33 на момент design, MIT, экс-Claude-Flow) — orchestration sidecar: CLI + MCP server + daemon, 32 plugins, ~210 MCP tools, 100+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip protocols), HNSW vector memory, SONA neural routing, 9 RL algos. Source: WebFetch 15.05.2026 на upstream GitHub.
**ruflo** (npm: `ruflo`, v3.7.0-alpha.38 на момент Phase 1 pre-flight 2026-05-15, MIT, `ruvnet/claude-flow` legacy repo после rename Jan-2026; plugin-namespace `@claude-flow/*`) — orchestration sidecar: CLI + MCP server + daemon, **20 plugins** (Phase 1 Task 1.3 enumerated), 60+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip protocols), HNSW vector memory, SONA neural routing, 9 RL algos. Source: WebFetch 15.05.2026 + Phase 1 actual verifications.
## 1. Цели и не-цели
@@ -118,42 +118,65 @@ User prompt → ruflo Queen receives
По решению заказчика «чистый верх, всё sub-policy» — три hard rule (Pravila §12, CLAUDE.md §5 п.10, Pravila §5 ПДн) теряют hard-rule статус. Технические компенсаторы остаются (см. §9).
## 3. ruflo scope — 32 plugins (Full big-bang)
## 3. ruflo scope — 20 plugins (Full big-bang, post Phase 1 pre-flight 2026-05-15)
Точный enumerate — pre-flight Task 0 (см. §4 Day 1).
**Phase 1 pre-flight confirmed (см. §12 Q1-Q10):** ruflo `v3.7.0-alpha.38`, **20 plugins** в IPFS-registry `claude-flow-official` (CID `QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2`), namespace `@claude-flow/*` (legacy после rename Jan-2026 → ruflo, npm-package переименован, plugin-namespace остался). Пользовательский выбор Phase 1 decision gate: **установить все 20** (full big-bang).
**Известные категории (из WebFetch upstream GitHub):**
**Фактический enumerate (Task 1.3 output 2026-05-15):**
| # | Категория | Что входит | ~Count |
|---|---|---|---|
| 1 | Core | `ruflo-core`, `ruflo-intelligence`, `ruflo-memory` | 3 |
| 2 | Agents | `ruflo-agents` — 100+ agent types | 1 plugin |
| 3 | Memory / RAG | `ruflo-rag`, `ruflo-memory-hnsw`, `ruflo-memory-bridge` | 3 |
| 4 | DevTools | `ruflo-devtools`, `ruflo-browser` (18-tool gallery) | 2 |
| 5 | Loop-workers (daemon) | `ruflo-loop-workers` | 1 |
| 6 | LLM routing | `ruflo-ruvllm` (Ollama, Claude, GPT, Gemini, Cohere) | 1 |
| 7 | Federation / swarm | `ruflo-federation` (Raft, Byzantine, Gossip) | 1 |
| 8 | Web scraping | `ruflo-bright-data` | 1 |
| 9 | MCP tools | ~210 tools через `npx ruflo@latest mcp start` (5 server groups) | exposed via MCP |
| 10 | Остальные plugins | Точные имена — Task 0 enumerate | ~19-20 |
| # | Plugin | Version | Type | Downloads | Категория |
|---|---|---|---|---|---|
| 1 | `@claude-flow/embeddings` | 3.0.0-alpha.1 | core | 2 684 | Memory/Vector |
| 2 | `@claude-flow/security` | 3.0.0-alpha.1 | core | 520 | Security |
| 3 | `@claude-flow/plugin-agentic-qe` | 3.0.0-alpha.5 | integration | 289 | QE/Testing |
| 4 | `@claude-flow/plugin-prime-radiant` | 0.1.5 | integration | 216 | Generic |
| 5 | `@claude-flow/claims` | 3.0.0-alpha.8 | core | 156 | Auth/AuthZ |
| 6 | `@claude-flow/plugin-gastown-bridge` | 0.1.4 | integration | 150 | Integration |
| 7 | `@claude-flow/neural` | 3.0.0-alpha.7 | core | 94 | Neural routing (SONA) |
| 8 | `@claude-flow/plugins` | 3.0.0-alpha.1 | core | 44 | Plugin meta |
| 9 | `@claude-flow/performance` | 3.0.0-alpha.1 | command | 22 | Perf metrics |
| 10 | `@claude-flow/teammate-plugin` | 1.0.0-alpha.1 | integration | 0 | Coordination |
| 11 | `@claude-flow/plugin-healthcare-clinical` | 3.0.0-alpha.2 | integration | 0 | Domain-specific (нерелевантно CRM) |
| 12 | `@claude-flow/plugin-financial-risk` | 0.1.0 | integration | 0 | Domain (нерелевантно) |
| 13 | `@claude-flow/plugin-legal-contracts` | 3.0.0-alpha.2 | integration | 0 | Domain (нерелевантно) |
| 14 | `@claude-flow/plugin-code-intelligence` | 0.1.0 | integration | 0 | Code analysis (релевантно) |
| 15 | `@claude-flow/plugin-test-intelligence` | 0.1.0 | integration | 0 | Test analysis (релевантно) |
| 16 | `@claude-flow/plugin-perf-optimizer` | 3.0.0-alpha.2 | integration | 0 | Perf (релевантно) |
| 17 | `@claude-flow/plugin-neural-coordinator` | 0.1.0 | integration | 0 | Coordination (релевантно) |
| 18 | `@claude-flow/plugin-cognitive-kernel` | 0.1.0 | core | 0 | Reasoning (релевантно) |
| 19 | `@claude-flow/plugin-quantum-optimizer` | 0.1.0 | integration | 0 | Esoteric (нерелевантно) |
| 20 | `@claude-flow/plugin-hyperbolic-reasoning` | 0.1.0 | integration | 0 | Esoteric (нерелевантно) |
**Categories summary:** 6 core + 1 command + 13 integration. **CRM-релевантно:** 11 plugins (6 core + 5 integration). **Нерелевантно но устанавливается** (per user choice «full big-bang»): 9 integration (medical/legal/financial/quantum/hyperbolic).
**CLI subcommands (Task 1.2.2 output):** 33+ subcommands — `init`, `start`, `status`, `agent`, `swarm`, `memory`, `task`, `session`, `mcp`, `hooks`, `neural`, `security`, `performance`, `embeddings`, `hive-mind` (Queen-led consensus), `ruvector`, `guidance`, `autopilot`, `config`, `doctor`, `daemon`, `migrate`, `workflow`, `analyze`, `route`, `progress`, `providers`, `plugins`, `deployment`, `claims`, `issues`, `update`, `process`, `appliance`, `cleanup`.
**Agent count correction:** npm description строго пишет **«60+ specialized agents»** (не «100+» как изначально assumed из WebFetch на README). Agents — внутри plugin'ов, не отдельные plugins.
**MCP server:** stdio-mode (Task 1.6 verified — `INFO [claude-flow-mcp] Starting in stdio mode`) — **нет port-конфликта** с existing MCP entries в `.mcp.json`. Resolves Q5.
**Plugin discovery — IPFS-based, operational risk:**
Plugin registry fetched via IPFS (CID `QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2`). На 2026-05-15 при Task 1.3 — Pinata `gateway.pinata.cloud` + Cloudflare `cloudflare-ipfs.com` **gateways failed** (network errors), сработал только `ipfs.io` (324ms). Это материальный operational risk: если все gateways down → plugin discovery offline. Mitigation: после первоначального install ruflo кеширует plugin list локально (точное поведение не верифицировал — pre-flight Q11 для будущего).
**Disk + runtime footprint:**
- `~/.ruflo-cache/` — HNSW vector store, ~1-5 GB на dev
- `~/.ruflo-cache/` — HNSW vector store + npm-cache npx (`@xenova/transformers + onnxruntime-web` — heavy ML deps уже скачаны Task 1.2, ~100-500 MB)
- `.claude-flow/` — scaffold в репо (gitignored)
- `CLAUDE.local.md` — новый файл, gitignored
- `.mcp.json` — +1 entry
- `~/.claude/settings.json` — +32 enabledPlugins entries
- Windows daemon — PM2 + pm2-windows-service (elevated PS install once)
- `.mcp.json` — +1 entry `ruflo`
- `~/.claude/settings.json` — +20 enabledPlugins entries (не 32)
- Windows daemon — PM2 + pm2-windows-service (elevated PS install, **elevation verified True** Task 1.5.1)
- Disk available: 67 GB free (Task 1.4.1)
**Pre-flight verifications (Task 0):**
**Pre-flight verifications COMPLETED (Task 0 closed 2026-05-15 commit `e55572e..` post-Phase-1):**
1. `npm view ruflo` — точная version + dist-tags.
2. `npx ruflo@latest plugins list` — enumerate 32 plugins → polish этот раздел.
3. `npx ruflo@latest init --help` — проверить scaffold-flags для безопасного init без overwrite корневого `CLAUDE.md`.
4. `npx ruflo@latest mcp start` smoke-test — MCP-server стартует на Windows + соединяется с Claude Code.
5. `pm2-service-install` — требует elevated PowerShell (Блокер 2 в §12 Q4).
6. Disk space check — `~/.ruflo-cache/` 1-5 GB.
1. ✅ `npm view ruflo` → v3.7.0-alpha.38, license MIT, repo points `ruvnet/claude-flow.git` (rename incomplete)
2. ✅ `npx ruflo@latest plugins list` → 20 plugins enumerated (table выше)
3. ⏸ `npx ruflo@latest init --help` — Phase 2 step 2.2.1 (deferred to install moment)
4. ✅ `npx ruflo@latest mcp start` → starts pid alive 15s, stdio mode
5. ✅ PowerShell elevation = True; PM2/pm2-windows-service not installed (Phase 2 step 2.8)
6. ✅ Disk space 67 GB free
**Cost-budget setting в pre-flight:**
@@ -359,7 +382,10 @@ pm2 save
| 7 | PII leak через daemon agent | Low | Critical | gitleaks remains; RLS на DB; dev DB only |
| 8 | Alpha-ruflo deprecated за 3-6 мес | Medium | Very High | Spec/plan позволяют revert; ruflo MIT — fork-able |
| 9 | Cognitive load: 2 nav layers (ruflo + legacy) | Medium | Medium | Map fork визуализирует hybrid; Tooling §4.10 объясняет |
| 10 | PostgreSQL/Memurai порт-конфликт с ruflo MCP | Low | Medium | Pre-flight Task 0 verifies; alt-port |
| 10 | PostgreSQL/Memurai порт-конфликт с ruflo MCP | Low | Medium | **Resolved Task 1.6**: stdio mode, no port |
| 11 | IPFS gateway unavailability → plugin discovery offline (Pinata + Cloudflare gateways failed 2026-05-15; только ipfs.io worked) | Medium | Medium | Local plugin cache (если ruflo поддерживает) + monitor IPFS health; fallback на direct npm install plugin packages |
| 12 | Alpha plugin version inconsistency (core plugins на 3.0.0-alpha.1..8 — разные alphas; breaking changes возможны между ними) | Medium | Medium | Pin versions через ruflo lockfile (если есть) + Day 6 регрессия после любого update |
| 13 | Namespace mismatch `ruflo` package vs `@claude-flow/*` plugins (incomplete rename) | Low | Low | Documentation сохраняет оба имени; не блокирует функционал |
### 10.4. Net decision matrix
@@ -418,20 +444,22 @@ claude mcp list
3. Revert этого commit'а; повторить регрессию.
4. Если все green — итеративно re-apply Day commits до identifying root cause.
## 12. Open questions (resolve в pre-flight Task 0)
## 12. Open questions — Phase 1 Task 0 resolution (2026-05-15)
| # | Вопрос | Resolution |
| # | Вопрос | Resolution status |
|---|---|---|
| Q1 | Точный список 32 ruflo plugins | `npx ruflo@latest plugins list` |
| Q2 | Path к `~/.ruflo-cache/` на Windows | `npx ruflo config get cache-dir` |
| Q3 | Anthropic Managed Agents отдельная auth (vs Claude Code session) | `npx ruflo auth status` + ruflo docs |
| Q4 | PowerShell elevated сессия доступна? | User confirmation; иначе fallback foreground |
| Q5 | ruflo MCP конфликтует с existing MCP entries в `.mcp.json` | `npx ruflo@latest mcp start` smoke-test |
| Q6 | Pravila §12 переименование ломает skill-discipline hook? | Day 6 regression catches |
| Q7 | Push direct to main vs PR? | Memory `reference_github.md`: `Bash(git push origin main:*)` rule активна → direct main ОК |
| Q8 | Бэкап CLAUDE.md перед init | `cp CLAUDE.md CLAUDE.md.pre-ruflo.bak` Day 2 step 1 + commit current state as baseline |
| Q9 | Cyrillic memory files reindex качество | `ruflo memory reindex` smoke-test |
| Q10 | ruflo daemon доступ к Anthropic API key — общий с Claude Code session, или отдельный? | `npx ruflo config get auth` |
| Q1 | Точный список 20 ruflo plugins (не 32) | **✅ RESOLVED Task 1.3.** 20 plugins в IPFS-registry namespace `@claude-flow/*`. Полный enumerate — §3 таблица |
| Q2 | Path к `~/.ruflo-cache/` на Windows | ⏸ Phase 2 Task 2.2.3 verify через `npx ruflo config get cache-dir` после init |
| Q3 | Anthropic Managed Agents отдельная auth | ⏸ Phase 2 verify (cli `ruflo providers` + `ruflo config get auth`) |
| Q4 | PowerShell elevated сессия доступна? | **✅ RESOLVED Task 1.5.1.** `True` — pm2-service-install без эскалации |
| Q5 | ruflo MCP конфликтует с existing MCP entries | **✅ RESOLVED Task 1.6.** stdio mode (`INFO [claude-flow-mcp] Starting in stdio mode`) — нет port-конфликта |
| Q6 | Pravila §12 переименование ломает skill-discipline hook | ⏸ Phase 6 regression catches |
| Q7 | Push direct to main vs PR | **✅** Memory `reference_github.md`: `Bash(git push origin main:*)` rule активна → direct main ОК |
| Q8 | Бэкап CLAUDE.md перед init | **✅ Procedure documented** Phase 2 Task 2.1 — `cp CLAUDE.md CLAUDE.md.pre-ruflo.bak` + commit current state as baseline |
| Q9 | Cyrillic memory files reindex качество | ⏸ Phase 2 Task 2.10 + smoke во время реального reindex'а |
| Q10 | ruflo daemon доступ к Anthropic API key | ⏸ Phase 2 Task 2.9 при настройке `.env.local` |
| **Q11 (new)** | IPFS gateway availability + local cache behavior | **⚠️ MATERIAL RISK** — Pinata + Cloudflare gateways FAILED 2026-05-15; только `ipfs.io` worked. Mitigation: §10.3 risk #11 |
| **Q12 (new)** | Plugin version inconsistency 3.0.0-alpha.1..8 — breaking changes между ними? | **⚠️ MATERIAL RISK** — §10.3 risk #12; pin versions если ruflo поддерживает lockfile |
## 13. Termination conditions
@@ -465,9 +493,18 @@ Big-bang считается завершённым когда:
- [x] Section 11 Verification — baseline numbers конкретные; failure protocol.
- [x] Section 12 Open questions — 10 Q's, resolve в Task 0.
- [x] Section 13 Termination — 7 acceptance criteria.
- [ ] **NB ограничение:** не верифицировал работу `npx ruflo init` на Windows этой машины — Task 0 pre-flight.
- [ ] **NB ограничение:** не верифицировал, что `pm2-service-install` работает без elevation — может потребоваться user action.
- [ ] **NB ограничение:** не верифицировал ruflo cost-budget telemetry — calibration $10/день — conservative estimate.
- [ ] **NB ограничение:** не верифицировал cyrillic embedding качество в SONA pipeline — pre-flight smoke.
- [ ] **NB ограничение:** не верифицировал работу `npx ruflo init` на Windows этой машины — отложено в Phase 2 Task 2.2 (с `--dry-run` safety).
- [x] **Verified Phase 1:** PowerShell elevation = True — `pm2-service-install` доступна без эскалации.
- [ ] **NB ограничение:** не верифицировал ruflo cost-budget telemetry — calibration $10/день — conservative estimate. Phase 6 regression telemetry откалибрует.
- [ ] **NB ограничение:** не верифицировал cyrillic embedding качество в SONA pipeline — отложено в Phase 2 Task 2.10.
**Phase 1 verified additionally (2026-05-15):**
- [x] ruflo `v3.7.0-alpha.38` install via npx works on this Windows machine
- [x] **20 plugins** in registry (not 32 как изначально assumed) — full big-bang scope adjusted
- [x] ruflo MCP server starts in stdio mode — no port conflict
- [x] IPFS-based plugin discovery operational, но 2/3 gateways failed → **material risk** documented §10.3 #11
- [x] Plugin namespace `@claude-flow/*` (legacy, не `ruflo-*`) — documentation note
- [x] Disk space 67 GB free (>> 5 GB requirement)
**Конец spec.**