Дмитрий
aab7345590
Продолжение SYSTEM-аудита «мозга» 18.05.2026 (срез «дисциплина правил после Rec1-Rec5»). PSR_v1 прочитан целиком (966 строк), R15 «Off-phase routing» проверен против R0/R6/R10/R14. Результат аудита: - R15 vs R0/R6/R10/R14 — содержательных противоречий нет (R15.1 codifies, R15.4 hard-rules перевешивают, R15.6 UI-пул) - routing-off-phase.md прогнан на 7 задачах (5 прямых + 2 граничных) — 7/7 routed cleanly, ADR-границы работают - hard-rules §12/§14/§15 vs §14.9 dormant — согласовано 3 minor-находки исправлены: - M1 — routing-off-phase.md +note: строки UI-пул #31/#32 — делегирующие ссылки на R14, не R15-routed (R15.6 ↔ таблица) - M2 — PSR_v1 R15.1 +абзац «R15 — пост-R1 слой» (off-phase routing срабатывает после классификации R1, не отдельная шестая ветка) — in-place в v3.14 (введён сегодня, 0 изменений R-аппарата) - M3 — routing-off-phase.md +строка «диагностика просадки метрики/конверсии» → process-analysis #53 (discovery-interview SKIP-кейс, симметрия) routing-off-phase.md v1.0 → v1.1. PSR_v1 — без version bump (M2 — in-place уточнение свежей v3.14). snapshot 18.05 +UPDATE секция «Ось 5» + факт-правка строки 97 (R15-слот). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
130 lines
15 KiB
Markdown
130 lines
15 KiB
Markdown
# Routing-аид: задача → off-phase узел
|
||
|
||
> **Назначение.** Quick-reference: триггер задачи → какой off-phase узел тулчейна
|
||
> взять (Tooling §4.11–§4.35). Закрывает пробел SYSTEM-аудита 18.05.2026 (Rec3):
|
||
> 30 off-phase инструментов регулировались плоским 3-блочным реестром PSR_v1 R10.1
|
||
> без матрицы «задача → узел».
|
||
>
|
||
> **Scope.** Только off-phase (#31–#60 + ruflo, infrastructure). Активные фазовые
|
||
> инструменты (#1–#29 + #30 Frontend Design) — карта CLAUDE.md §3.1/§3.2/§3.4.
|
||
> Superpowers-skills и hard-rules — Pravila §12.2 (не дублируется здесь).
|
||
>
|
||
> **Источник истины.** Tooling §4.X (детальное описание каждого узла), Pravila §13.2
|
||
> (категоризация off-phase), PSR_v1 R10.1 (3-блочный реестр ролей).
|
||
>
|
||
> **Версия.** 1.1 (18.05.2026 вечер — аудит дисциплины R15: +строка «диагностика
|
||
> конверсии» → process-analysis #53 (M3); +note про UI-пул #31/#32 как делегирующие
|
||
> строки, не R15-routed (M1). v1.0 — Rec3 SYSTEM-аудита). Триггеры — формулировки
|
||
> заказчика или явные ключевые слова в промпте.
|
||
|
||
---
|
||
|
||
## Таблица routing
|
||
|
||
| Триггер задачи | Узел | # | Категория | Гейт |
|
||
|---|---|---|---|---|
|
||
| Архитектурное решение, ADR, обоснование выбора | **adr-kit** | #36 | architecture-tooling | `adr-judge` в lefthook job 9 |
|
||
| C4 / контекст / контейнер / компонент-диаграмма | **mermaid-skill** | #37 | architecture-tooling | вендорен; рендера не нужно |
|
||
| Справка по архитектурному паттерну (Clean/Hex/DDD/CQRS…) | **architecture-patterns** | #38 | architecture-tooling | knowledge-only |
|
||
| Контроль направления зависимостей / границ слоёв `App\` | **deptrac** | #43 | architecture-tooling | lefthook pre-commit job 10 |
|
||
| Security-аудит diff/PR, supply-chain риск, вариант-анализ | **Trail of Bits Skills** (8 плагинов) | #39 | audit-security | on-demand кампания |
|
||
| Inline-предупреждения уязвимостей при правке кода | **Security Guidance** (PreToolUse-хук) | #40 | audit-security | блокирующий `sys.exit 2` |
|
||
| SAST-сканер всего кода | **Semgrep MCP** | #25 (фаза 3) | — | npm run sast |
|
||
| Полный security-review текущей ветки | `/security-review` (slash-команда) | — | audit-security | customized FP-фильтр |
|
||
| Полный портальный аудит | **audit-portal** (project-скил) | — | audit-security | 14-фазный |
|
||
| PRD → эпик → GitHub-issues → параллельные агенты → код | **CCPM** (vendored skill) | #41 | project-management | `.claude/prds/` + `.claude/epics/` |
|
||
| PRD / roadmap-update / metrics-review / sprint-planning | **product-management** (Anthropic-плагин) | #42 | project-management | 9 slash-команд |
|
||
| GitHub-issues операции (просмотр/создание) | **GitHub MCP** | #3 (фаза 0) | — | через `mcp__github__*` |
|
||
| Извлечь дизайн-токены из Figma | **Figma MCP** | #44 | design-tooling | **DEFERRED** — нет Figma-аккаунта |
|
||
| Вставить SVG-иконку из 10 коллекций (не Lucide) | **Universal Icons MCP** | #45 | design-tooling | ADR-006 D4: Lucide через `lucide-vue-next` |
|
||
| Дизайн-критика / UX-копи / a11y-уровня дизайна / research synthesis | **Design plugin** | #46 | design-tooling | pre-code; Pa11y остаётся технический SoT |
|
||
| Introspection OpenAPI/REST API чужой/своей | **openapi-mcp-server** | #47 | integration-tooling | READ-ONLY |
|
||
| Генерация OpenAPI-спеки своего API | **api-docs agent** (claude-flow) | — | integration-tooling | без Tooling-номера |
|
||
| Eval LLM-промпта / red-team / регрессия на промпт | **promptfoo** (npm CLI) | #48 | ml-ai-tooling | вручную/CI, **никогда в хук** (ML1) |
|
||
| Классический ML-воркфлоу: алгоритм / feature eng / оценка | **Data Scientist skill** | #49 | ml-ai-tooling | knowledge-only |
|
||
| Исполняемый ML-ноутбук с обучением | **Jupyter MCP** | #50 | ml-ai-tooling | **DEFERRED** — нет Python ML-окружения |
|
||
| Документировать/оптимизировать/change-management бизнес-процесс | **operations** (9 скилов) | #51 | business-process | Mermaid-рендер делегирует #37 |
|
||
| BPMN 2.0 to-be модель процесса, RACI, state-машина | **process-modeling** (project-скил) | #52 | business-process | как process-discovery from-head |
|
||
| As-is discovery процесса из кода Laravel + audit-логов, узкие места, KPI | **process-analysis** (project-скил) | #53 | business-process | from-code; ≠ discovery-interview (from-head) |
|
||
| Диагностика просадки метрики/конверсии (почему падает B2, где теряем в воронке) | **process-analysis** (project-скил) | #53 | business-process | from-code + audit-данные; discovery-interview SKIP-кейс |
|
||
| n8n workflow-движок | **n8n-mcp** | #54 | business-process | **DEFERRED** — n8n не в стеке |
|
||
| Интервью-discovery перед фичей (FEATURE) / ориентация по проекту (SYSTEM) | **discovery-interview** (project-скил) | #55 | discovery-tooling | разрез по слою-источнику с #53 (ADR-009) |
|
||
| Brainstorm: проблема не очерчена, нужно вскрыть | `superpowers:brainstorming` | — | (Superpowers, §12.2) | не off-phase, но связан |
|
||
| Создать новый скил из ≥3 повторений workflow | **skill-creator** | #56 | authoring-tooling | политика триггеров ADR-010 |
|
||
| Создать новый Claude Code plugin | **plugin-dev** | #57 | authoring-tooling | knowledge for plugin authoring |
|
||
| Создать хук на повторяющуюся ошибку | **hookify** | #58 | authoring-tooling | **HK1 pre-check** на коллизию economy/skill-discipline |
|
||
| Подсказки настроек Claude Code для проекта | **claude-code-setup** | #59 | dev-support | recommender |
|
||
| Текущая документация библиотеки/SDK/CLI | **context7** | #60 | dev-support | вместо WebSearch для библиотек |
|
||
| Отладка production runtime errors через self-hosted Sentry | **Sentry MCP** | #34 | debug-runtime | READ-ONLY, pending Б-1 deployment |
|
||
| Отладка Redis/Memurai очередей / кэша / Pest-квирков 73/77 | **Redis MCP** | #35 | debug-runtime | READ-ONLY обязательно |
|
||
| Правки `CLAUDE.md` | **claude-md-management** | #33 | infrastructure | §5 п.10 — единственный канал |
|
||
| UI-резерв (50+ стилей / 161 палитра / 99 UX-гайдлайнов / 25 чартов) | **UI UX Pro Max** | #31 | UI-пул † | PSR_v1 R14.3 pipeline; R6.0+R6.1 фильтр |
|
||
| UI стартовый шаблон / иконка-логотип бренда | **21st Magic MCP** | #32 | UI-пул † | PSR_v1 R14.4 pipeline; R6.0+R6.1 фильтр |
|
||
| Оркестрация роя / queen / королева | **ruflo** | — | orchestration | **ИЗОЛИРОВАН 18.05.2026** (Pravila §14.9 dormant) |
|
||
|
||
> **† UI-пул (#31 UPM / #32 21st) — делегирующие строки.** R15.6 явно: к UI-пулу R15
|
||
> не применяется — это UI-задачи по природе, их ведёт R14 pipeline. Строки выше —
|
||
> не off-phase routing, а указатель «иди в R14», включены для полноты единого
|
||
> reference. Фактический регламент UPM/21st — PSR_v1 R14.3/R14.4, не эта таблица.
|
||
|
||
---
|
||
|
||
## Канонические связки 2+ узлов
|
||
|
||
> Закрывает Rec4 SYSTEM-аудита 18.05.2026 («сводного списка рекомендованных комбо
|
||
> нет — синергия размазана по 125 полям `together` в NODE_DETAILS карты»).
|
||
> Здесь — 12 цепочек, где совместная работа узлов даёт эффект сильнее суммы. UI-рендер
|
||
> панели «🔗 Связки» на карте — отдельный future iter; данные ниже — основа для него.
|
||
|
||
| # | Цепочка | Зачем |
|
||
|---|---|---|
|
||
| L1 | `discovery-interview` (FEATURE) → `brainstorming` → `writing-plans` → `subagent-driven-development` | Полный цикл от боли заказчика до атомарных коммитов. Передаёт discovery-brief в brainstorming без re-asking; план потом исполняется параллельными субагентами. |
|
||
| L2 | `discovery-interview` (SYSTEM) + `audit-portal` | Ориентация по состоянию (где мы) + вердикт здоровья портала. Snapshot 18.05 — пример L2 в действии. |
|
||
| L3 | `process-analysis` (#53) ↔ `process-modeling` (#52) | As-is из кода ↔ to-be BPMN. Парная работа: #53 вскрывает узкое место, #52 моделирует целевую схему. Разрез по слою-источнику — ADR-009. |
|
||
| L4 | `mermaid-skill` (#37) ← `adr-kit` (#36) / `process-modeling` (#52) / `operations` (#51) | Mermaid рендерит C4 / BPMN / process-doc для трёх потребителей. Single source of truth для диаграмм. |
|
||
| L5 | `adr-kit` (#36) + `architecture-patterns` (#38) + `deptrac` (#43) | Архитектурный треугольник: решение → паттерн-обоснование → fitness-контроль (статический enforcement через lefthook job 10). |
|
||
| L6 | `Trail of Bits` (#39) + `Semgrep MCP` (#25) + `Security Guidance` (#40) + `/security-review` | Слоистый security: блокирующий PreToolUse-хук на правке → inline SAST → on-demand глубокий аудит → review всего бренча. TB1 / SG1 — границы. |
|
||
| L7 | `openapi-mcp-server` (#47) + `api-docs agent` + `Boost MCP` (#10) | Интеграционная разработка: спека-introspection + генератор спеки + Laravel API. Раздел A3 карты. |
|
||
| L8 | `systematic-debugging` + `Sentry MCP` (#34) + `Redis MCP` (#35) | Runtime-баги: ≥3 гипотезы → факты из production (Sentry) + factual из очередей/кэша (Redis). Snapshot указал как недоиспользуемую связку. |
|
||
| L9 | `CCPM` (#41) + `product-management` (#42) + `GitHub MCP` (#3) | PRD → эпики → GitHub issues. CCPM делает трассируемость; product-management — продуктовые церемонии; GitHub MCP — issue/PR-операции. |
|
||
| L10 | `promptfoo` (#48) + `Data Scientist skill` (#49) + `claude-api skill` (Sonnet 4.6 SDK) | LLM-фича: eval LLM-промптов + ML-воркфлоу + Anthropic SDK. ML1 — promptfoo только вручную/CI. |
|
||
| L11 | `skill-creator` (#56) + `hookify` (#58) + `plugin-dev` (#57) | Расширение Claude-инфраструктуры: ≥3 повторений workflow → новый скил / ошибка повторяется → новый хук (HK1 pre-check) / задача требует плагина → plugin-dev. |
|
||
| L12 | `claude-md-management` (#33) + `revise-claude-md` skill | Захват session-learnings → CLAUDE.md update. Единственный канал §5 п.10. |
|
||
|
||
**Anti-pattern связок** (не комбинировать в одной задаче):
|
||
|
||
- **UPM (#31) ↔ Frontend Design (#30) ↔ 21st (#32)** — PSR_v1 R14.5 запрещает параллельное использование UI-генераторов (один pipeline, один решатель).
|
||
- **ruflo Queen ↔ subagent-driven-development напрямую** — ruflo сейчас изолирован (Pravila §14.9 dormant). При реактивации связь снова работоспособна.
|
||
- **`mcp_figma` (DEFERRED) → Frontend Design code-gen** — ADR-006 FM1: extract-only для Figma; code-gen дублировал бы FD.
|
||
- **`Data Scientist skill` (#49) → решатель в коде** — knowledge-only, не пишет код за вас (R10.2 PSR_v1).
|
||
|
||
---
|
||
|
||
## Дисциплина выбора
|
||
|
||
1. **Не подменяй фазовые инструменты off-phase.** Если задача попадает под фазу
|
||
0/1/2/3 (Tooling §2–§5) — берём фазовый узел. Off-phase — резерв и специализация.
|
||
2. **DEFERRED-узлы (#44 Figma / #50 Jupyter / #54 n8n)** — не использовать без явного
|
||
возобновления (нет аккаунта / нет Python ML / нет n8n в стеке). Запрос «через Figma»
|
||
при текущем состоянии = эскалация заказчику.
|
||
3. **Изолированные узлы (ruflo на 18.05.2026)** — не маршрутизировать. Запрос
|
||
с `queen`/`королева` сейчас выполняется напрямую (§14 dormant). При запросе
|
||
реактивации — план в memory `feedback_ruflo_isolated.md`.
|
||
4. **UI-пул (#31 UPM / #32 21st)** — только через R14 pipeline. Никогда не решатель,
|
||
всегда материал; обязательны R6.0 фильтр + R6.1 hard-override Forest + FD адаптация.
|
||
5. **Hard-rules (Pravila §12 / §14 / §15)** перевешивают этот routing-аид при коллизии.
|
||
6. **Граничные случаи между похожими узлами** — кросс-ссылки в Tooling §4.X (например
|
||
#53 process-analysis ↔ #55 discovery-interview через слой-источник ADR-009;
|
||
#39 ToB ↔ #25 Semgrep MCP через scope TB1).
|
||
|
||
---
|
||
|
||
## Связано
|
||
|
||
- [docs/Tooling_v8_3.md](Tooling_v8_3.md) §4.11–§4.35 — детальные описания узлов.
|
||
- [docs/Pravila_raboty_Claude_v1_1.md](Pravila_raboty_Claude_v1_1.md) §13.2 — категоризация off-phase.
|
||
- [docs/Plugin_stack_rules_v1.md](Plugin_stack_rules_v1.md) R10.1 — 3-блочный реестр ролей; R14 — UI-пул pipeline.
|
||
- `CLAUDE.md` §3.3 — оперативная карта с командами установки.
|
||
- `docs/discovery/2026-05-18-system-audit-brain.md` Rec3 — источник решения.
|
||
- `docs/adr/*.md` — границы между категориями (ADR-003/004/005/006/007/008/009/010).
|