Files
portal/docs/routing-off-phase.md
T
Дмитрий aab7345590 docs(psr): аудит дисциплины R15 — M1-M3 polish
Продолжение 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>
2026-05-18 16:32:34 +03:00

15 KiB
Raw Blame History

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) → brainstormingwriting-planssubagent-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 §4.11–§4.35 — детальные описания узлов.
  • docs/Pravila_raboty_Claude_v1_1.md §13.2 — категоризация off-phase.
  • docs/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).