docs(tooling): apply 9-attribute template to §4.5-§4.17 off-phase nodes #31-42 + ruflo (ADR-011 A3 sub-batch 5)
Inline pattern (matches Sub-batch 3). 13 Атрибуты blocks placed under each §4.X heading. Includes ruflo §4.10 dormant=true (Pravila §14.9). Other 12 nodes (#31-42) dormant=false. #40 Security Guidance: kind=hook (блокирующий PreToolUse, sys.exit 2). #34 Sentry MCP: pending Б-1 (Sentry instance deployment), READ-ONLY. Per spec §4.1, plan Task A3 sub-batch 5. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -450,6 +450,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.5. Резерв-библиотека UI — UI UX Pro Max plugin (off-phase tool)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #31 | UI UX Pro Max | plugin | off-phase | UI-pool | «резерв UI, стили, палитры, графики, UX-гайдлайны» | PSR_v1 R14.3 pipeline | false | 2026-05-19 |
|
||||
|
||||
> **Введено 10.05.2026 (v1.12 Прил. Н):** формализован как «инструмент-резерв вне фаз». Был фактически включён через `~/.claude/settings.json` ещё с момента активации (до v1.12 — без правил). Координация — **PSR_v1 v1.6+ R10/R11/R14.3** (cross-ref bumped в Tooling v1.14).
|
||||
|
||||
| # | Инструмент | Установка | Состав | Когда использовать |
|
||||
@@ -473,6 +479,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.6. Генератор шаблонов — 21st.dev Magic MCP (off-phase tool)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #32 | 21st.dev Magic MCP | mcp | off-phase | UI-pool | «генератор UI-шаблонов (LLM-based)» | PSR_v1 R14.4 pipeline + Pa11y mandatory | false | 2026-05-19 |
|
||||
|
||||
> **Введено 10.05.2026 (v1.12 Прил. Н):** формализован как «инструмент-резерв вне фаз». Был фактически подключён через `~/.claude.json` (с API-ключом, npm-пакет `@21st-dev/magic@latest`) ещё с момента активации (до v1.12 — без правил). Координация — **PSR_v1 v1.6+ R10/R14.4** (cross-ref bumped в Tooling v1.14).
|
||||
|
||||
| # | Инструмент | Установка | Состав | Когда использовать |
|
||||
@@ -512,6 +524,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.7. Инфраструктурный слой — claude-md-management plugin (off-phase tool)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #33 | claude-md-management | plugin | off-phase | infrastructure | «правки CLAUDE.md, обязательный канал» | CLAUDE.md §5 п.10 + PSR_v1 R10.1 | false | 2026-05-19 |
|
||||
|
||||
> **Введено 10.05.2026 (v1.13 Прил. Н):** формализован как «инструмент-резерв вне фаз, инфраструктурная категория». Был фактически включён через `~/.claude/settings.json` (`enabledPlugins.claude-md-management@claude-plugins-official=true`) с момента появления CLAUDE.md §5 п.10 (требование «правки CLAUDE.md только через плагин») — до v1.13 без формализации в реестре. Категория **инфраструктурная**, отличная от UI-пула (UPM/21st) — поэтому отдельная нумерация и не попадает под Pravila §13 (расширенный UI-пул).
|
||||
|
||||
| # | Инструмент | Установка | Состав | Когда использовать |
|
||||
@@ -533,6 +551,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.8. Debug-инструмент Sentry — Sentry MCP (off-phase tool)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #34 | Sentry MCP | mcp | off-phase | debug-runtime | «отладка production runtime errors» | READ-ONLY, pending Б-1 | false | 2026-05-19 |
|
||||
|
||||
> **Введено 13.05.2026 day +1 (v1.17 Прил. Н):** формализован как «инструмент-резерв вне фаз, debug-категория». Установлен на feat/claude-automation `6f7e7d7` в `.mcp.json`, merged в main через PR #3 (`cc5f63b`); формализован retrospectively в v1.17. Категория **debug-runtime**, отличная от UI-пула (UPM/21st) и инфраструктурного (claude-md-management) — поэтому отдельная нумерация. Pending Sentry instance deployment в Yandex Cloud (зависит от Б-1 ООО registration P0).
|
||||
|
||||
| # | Инструмент | Установка | Состав | Когда использовать |
|
||||
@@ -554,6 +578,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.9. Debug-инструмент Redis — Redis MCP (off-phase tool)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #35 | Redis MCP | mcp | off-phase | debug-runtime | «отладка Redis/Memurai очередей, кэша, Pest-race» | READ-ONLY | false | 2026-05-19 |
|
||||
|
||||
> **Введено 13.05.2026 day +1 (v1.17 Прил. Н):** формализован как «инструмент-резерв вне фаз, debug-категория». Установлен на feat/claude-automation `bd4ec48` в `.mcp.json`, merged в main через PR #3 (`cc5f63b`); формализован retrospectively в v1.17. Package `@modelcontextprotocol/server-redis@2025.4.25` **deprecated** по статусу npm («Package no longer supported»), но Anthropic source, рабочий. Post-MVP migration на community alternative (e.g., `@easy-mcps/redis-mcp-server@1.0.8` или `@wenit/redis-mcp-server@1.0.3`) когда подтвердим trust.
|
||||
|
||||
**Категории off-phase tools (v2.0):** к трём существующим подкатегориям — **UI-пул** (#31 UPM + #32 21st Magic MCP), **infrastructure** (#33 claude-md-management), **debug-runtime** (#34 Sentry MCP + #35 Redis MCP) — в v2.0 добавлена четвёртая: **orchestration** — ruflo (advisory/automation-подсистема, см. §4.10). Эта подкатегория не нумеруется в #-реестре (ruflo — внешний оркестратор с 20 собственными plugins, не один инструмент в фазовой раскладке).
|
||||
@@ -577,6 +607,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.10. ruflo — advisory/automation-подсистема (off-phase)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| (ruflo) | ruflo (~20 plugins) | plugin-bundle | off-phase | orchestration | «queen / королева» (per Pravila §14) | Pravila §14.9 (dormant 18.05.2026) | true | 2026-05-19 |
|
||||
|
||||
> **СТАТУС 18.05.2026: ИЗОЛИРОВАН (dormant).** Заказчик распорядился отрезать ruflo от активного потока, не удаляя артефакты (Rec2 SYSTEM-аудита 18.05.2026). Live-связи отключены: оба `tools/ruflo-*-hook.mjs` сняты из `.claude/settings.json` UserPromptSubmit; `ruflo` MCP-server удалён из `.mcp.json`; PM2 `ruflo-daemon` остановлен (`pm2 delete` + `save --force`, `~/.pm2/dump.pm2` = `[]`); Task Scheduler `PM2-ruflo-daemon` оставлен (идемпотентен). Артефакты сохранены: npm-пакет, файлы хуков, memory `mem_ruflo`, документация. Подробности и план реактивации — Pravila §14.9, memory `feedback_ruflo_isolated.md`. Раздел ниже описывает архитектуру/историю как было до изоляции — для возможной реактивации.
|
||||
|
||||
**ruflo** (npm `ruflo` v3.7.0-alpha.38+, MIT, репозиторий `ruvnet/claude-flow` — legacy-имя после rename Jan-2026; plugin-namespace `@claude-flow/*`). 20 plugins (IPFS-registry, CID `QmeXmAdbWVvT84GfDXPD2Vg1HWhiTW2VdZfRLhkS96KkX2`, Phase 1 pre-flight verified), ~210 MCP tools, 60+ specialized agents (Queen-led hierarchy: Raft/Byzantine/Gossip consensus protocols), HNSW vector memory, SONA neural routing.
|
||||
@@ -601,6 +637,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.11. adr-kit — Architecture Decision Records (off-phase, architecture-tooling)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #36 | adr-kit | plugin | off-phase | architecture-tooling | «архитектурные решения, ADR, enforcement» | adr-judge lefthook job 9 | false | 2026-05-19 |
|
||||
|
||||
**adr-kit** (Claude Code plugin, marketplace `rvdbreemen/adr-kit`, plugin `adr-kit@rvdbreemen-adr-kit`, **v0.13.1**, MIT). 8 skills (`/adr-kit:{adr,init,judge,lint,migrate,setup,upgrade,install-hooks}`) + агент `adr-generator`. **0 Claude Code lifecycle-хуков** (verified `claude plugin details`).
|
||||
|
||||
**Роль:** инструмент **#36**, раздел A6 карты «Архитектура систем». ADR хранятся в `docs/adr/` (формат Nygard, 7 секций); решения с блоком `## Enforcement` проверяются `adr-judge` на staged-дифе.
|
||||
@@ -611,6 +653,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.12. mermaid-skill — C4 / architecture-диаграммы (off-phase, architecture-tooling)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #37 | mermaid-skill | vendored-skill | off-phase | architecture-tooling | «C4, architecture-диаграммы» | none | false | 2026-05-19 |
|
||||
|
||||
**mermaid-skill** (`WH-2099/mermaid-skill`, MIT) — standalone-скил, **вендорен** в `.claude/skills/mermaid/` (`SKILL.md` + 30 references вкл. `c4.md`/`architecture.md` + LICENSE). Генерирует Mermaid-исходник 23 типов диаграмм; рендеринга не требует (`mmdc`/Chromium не нужны — Mermaid-блоки рендерит GitHub). 0 плагинов, 0 хуков, 0 marketplace.
|
||||
|
||||
**Роль:** инструмент **#37**, раздел A6 — визуализация архитектуры. C4-диаграммы → `docs/architecture/`.
|
||||
@@ -619,6 +667,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.13. architecture-patterns — справочник паттернов (off-phase, architecture-tooling)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #38 | architecture-patterns | plugin | off-phase | architecture-tooling | «справочник архитектурных паттернов» | none | false | 2026-05-19 |
|
||||
|
||||
**architecture-patterns** (Claude Code plugin, marketplace `secondsky/claude-skills`, plugin `architecture-patterns@claude-skills`, **v3.3.1**, MIT). 1 skill, 0 агентов, **0 хуков** (verified `claude plugin details`).
|
||||
|
||||
**Роль:** инструмент **#38**, раздел A6 — playbook архитектурных паттернов (Clean / Hexagonal / layered architecture, Domain-Driven Design).
|
||||
@@ -627,6 +681,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.14. Trail of Bits Skills — аудит безопасности (off-phase, audit-security)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #39 | Trail of Bits Skills | plugin | off-phase | audit-security | «deep аудит безопасности, diff, supply-chain» | none | false | 2026-05-19 |
|
||||
|
||||
**Trail of Bits Skills** (Claude Code marketplace `trailofbits/skills`, имя marketplace `trailofbits`, **CC-BY-SA-4.0**, репутабельный AppSec-вендор). Marketplace из 38 плагинов; в `enabledPlugins` включён курированный субсет **8 плагинов** под раздел D3 «Аудит и управление рисками»: `differential-review`, `audit-context-building`, `supply-chain-risk-auditor`, `insecure-defaults`, `sharp-edges`, `static-analysis`, `variant-analysis`, `agentic-actions-auditor`. Все 8 — skill/agent-плагины, **0 Claude Code lifecycle-хуков** (статически верифицировано по репо — ни у одного нет `hooks/`-папки).
|
||||
|
||||
**Роль:** инструмент **#39**, раздел D3 карты «Аудит и управление рисками» — глубокие on-demand аудит-кампании (security-аудит diff, supply-chain риск зависимостей, поиск вариантов уязвимостей по кодбазе).
|
||||
@@ -637,6 +697,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.15. Security Guidance — inline-предупреждения уязвимостей (off-phase, audit-security)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #40 | Security Guidance | hook | off-phase | audit-security | «inline-блокировка уязвимых паттернов» | блокирующий PreToolUse (sys.exit 2) | false | 2026-05-19 |
|
||||
|
||||
**Security Guidance** (Claude Code plugin, marketplace `anthropics/claude-plugins-official`, plugin `security-guidance@claude-plugins-official`, Anthropic Verified). Один PreToolUse `Write|Edit|MultiEdit`-хук — **блокирующий** (не warn-only): при **первом** за сессию срабатывании уязвимого паттерна в данном файле печатает предупреждение в stderr и завершается `sys.exit(2)` → **блокирует правку**. Пара «файл+правило» пишется в session state-файл `~/.claude/security_warnings_state_<id>.json` — повторная попытка той же правки проходит; это **одноразовый speed-bump**, не безусловный блок. 9 правил: 8 контентных (command/shell injection `child_process.exec`/`os.system`, `eval(`, `new Function`, XSS через `innerHTML`/`document.write`/`dangerouslySetInnerHTML`, `pickle`-десериализация) + 1 path-правило на `.github/workflows/*.yml`. Отключается env `ENABLE_SECURITY_REMINDER=0`.
|
||||
|
||||
**Роль:** инструмент **#40**, раздел D3 — real-time inline-напоминание об уязвимостях во время редактирования (дополняет on-demand аудит ToB/Semgrep).
|
||||
@@ -649,6 +715,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.16. CCPM — Claude Code PM (off-phase, project-management)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #41 | CCPM | vendored-skill | off-phase | project-management | «PRD → эпик → issue → код, dev-проекты» | none | false | 2026-05-19 |
|
||||
|
||||
**CCPM** (`automazeio/ccpm`, MIT) — standalone-скил, **вендорен** в `.claude/skills/ccpm/` (`SKILL.md` + `references/` с гайдами + 14 bash-скриптов). **0 Claude Code lifecycle-хуков** (статически верифицировано — нет `hooks/`-папки). Источник: GitHub `automazeio/ccpm`; вендоринг изолирует от upstream-потерь (bus-factor — community-проект — CC1).
|
||||
|
||||
**Роль:** инструмент **#41**, раздел C9 карты «Управление проектами». PRD→эпик→GitHub-issue→код с полной трассируемостью через `/pm` flow. PRD/epic хранятся в `.claude/prds/` + `.claude/epics/`. GitHub-issue-backed модель (конфликт-аудит CP3, зафиксировано в ADR-004). Раздел C9 опирается также на reuse: GitHub MCP (Tooling #3) с `projects` toolset для GitHub Projects v2, Superpowers `writing-plans` (execution plan-files), `q-item-add` (управление реестром вопросов).
|
||||
@@ -659,6 +731,12 @@ Existing prose follows the table.
|
||||
|
||||
### 4.17. product-management — Anthropic product-strategy plugin (off-phase, project-management)
|
||||
|
||||
**Атрибуты:**
|
||||
|
||||
| id | name | kind | phase | subcategory | triggers | boundaries | dormant | last-touched |
|
||||
|---|---|---|---|---|---|---|---|---|
|
||||
| #42 | product-management | plugin | off-phase | project-management | «PRD, роадмап, метрики, продуктовые церемонии» | none | false | 2026-05-19 |
|
||||
|
||||
**product-management** (Claude Code plugin, marketplace `anthropics/knowledge-work-plugins`, plugin `product-management@knowledge-work-plugins`, **Anthropic Verified**). Команды: `/write-spec` (PRD), `/roadmap-update`, `/stakeholder-update`, `/synthesize-research`, `/competitive-brief`, `/metrics-review`. **0 Claude Code lifecycle-хуков** (только команды, не хуки).
|
||||
|
||||
**Роль:** инструмент **#42**, раздел C9 — product-strategy церемонии (problem→spec, roadmap, stakeholder updates, research synthesis, competitive analysis, metrics review). Установлен в user-scope (`claude plugin install product-management@knowledge-work-plugins`).
|
||||
|
||||
Reference in New Issue
Block a user