Карта работы — Hooks · Skills

I

Три типа сущностей

Чтобы не путаться, важно понимать на каком слое живёт каждая вещь. Один и тот же объект может быть одновременно частью плагина, скилом по природе и автоматизированным хуком в действии — но роль у каждого своя.

Слой 01 · Доставка

Плагин

= коробка / упаковка

Контейнер. Сам ничего не исполняет — только доставляет в систему скилы, slash-команды, хуки, MCP-серверы и subagent'ы. Как rpm-пакет или npm-модуль: внутри что-то полезное, наружу — манифест.

Установка: через marketplace в ~/.claude/settings.json.

Слой 02 · Инструкция

Скил·

= инструкция в markdown

Текст, который я (Claude) читаю и которому следую. Например, «брейнсторм, потом план, потом TDD». Я могу его проигнорировать — это soft-правило: дисциплинированное самоприменение, а не runtime gate.

Вызов: через Skill-tool или slash /имя.

Слой 03 · Принуждение

Хук

= shell-скрипт runtime'а

Команда, которую запускает сам Claude Code в момент события (UserPromptSubmit, Stop, etc). Я не могу его обойти и не вижу момент запуска. Это реальный gate.

Зарегистрирован: в hooks блоке settings.json.

II

Иерархия и порядок

Три разные «иерархии» накладываются друг на друга и часто путают. Контейнерная отвечает на «что внутри чего». Приоритетная — на «что важнее при конфликте». Временная — на «что срабатывает раньше».

1 · Контейнерная

Что внутри чего лежит

Плагин — упаковка. Содержит скилы, хуки, slash-команды, MCP-серверы, subagent'ы. Сам плагин ничего не делает. Хуки регистрируются в settings.json и запускаются самим Claude Code. Скилы — это .md-файлы, которые я читаю и которым следую.

ПЛАГИН упаковка / контейнер ├─ Skills .md-инструкции для Claude ├─ Hooks Python/Bash скрипты + регистрация в settings.json ├─ Slash-commands /имя в промпте → запускает skill или агента ├─ MCP servers внешние tool-провайдеры └─ Subagents специализированные агенты-исполнители settings.json главный runtime конфиг ├─ enabledPlugins что включить ├─ permissions allow / deny / ask правила ├─ hooks event → matcher → handler └─ env / mcp / ... остальное ─── ПОТОКИ ВЛИЯНИЯ ─────────────────────────────────── Hook script ──> может запустить ЛЮБУЮ команду (Python, Bash, agent) Skill markdown ──> я читаю и следую (но могу проигнорировать) Plugin ──> ничего не делает сам — только доставляет содержимое

2 · Приоритетная

Что override'ит что при конфликте

Когда правила противоречат — побеждает верхний уровень. Так договорились в CLAUDE.md §1. Уровень 0 — единственный неотменяемый (даже «отступления» не отменяют его).

0

Pravila §12 hard rule

Superpowers hard rule — инвокировать skill ПЕРВЫМ для подходящих задач. §9 «Отступления» к этому не применяется. Неотменяемо.

1

Pravila_raboty_Claude.md

Продуктовые правила работы Claude, утверждены заказчиком (~13 секций).

2a

CLAUDE.md

Общая оперативная карта проекта, ссылается на источники истины.

2b

Tooling Прил. Н

Детальный реестр 33 инструментов. При конфликте с 2a — приоритет у CLAUDE.md как корневой карты.

3

Plugin_stack_rules.md

Координирующий слой между плагинами (Superpowers + Frontend Design + UPM + 21st Magic), 16 правил.

4

~/.claude/settings.json

Runtime config: хуки, permissions, плагины. Исполняется средой Claude Code, не мной.

5

memory/*.md

Кросс-сессионные факты о проекте, заказчике, окружении. Может быть stale — нужно verify.

6

Прочие плагины

claude-md-management, ui-ux-pro-max, frontend-design, и т. д. — поведенческие подсказки.

3 · Временная

В каком порядке всё срабатывает

События имеют фиксированный порядок в жизненном цикле сессии. Цвет верхней полосы — это частота срабатывания: один раз (зелёный), на каждый submit (синий), на каждый tool call (янтарь), нерегулярно (ржавый).

1·once

SessionStart

один раз на старте сессии

economy-self-check.py

2·per submit

UserPromptSubmit

каждый раз когда вы отправляете промпт

economy-mode.py

3·per tool

PreToolUse

перед каждым моим tool-вызовом

skill-marker · skill-check · state-guard

4·per response

Stop

конец моего ответа на вас

Sonnet 4.6 verifier (agent-type)

5·irregular

PostCompact

когда runtime сжимает старые сообщения

economy-postcompact.py

III

Хронология одного запроса

Что именно происходит за кулисами, пока вы пишете промпт и читаете ответ. Пять чёрных дисков — главные события. Внутренний прямоугольник — то, что повторяется на каждый мой tool-вызов.

Шаг 1

Вы пишете промпт

с опциональным «экономия N%» в самом конце

UserPromptSubmit

Парсер уровня

парсит экономию, пишет state-файл, инжектит правила в мой контекст

economy-mode.py

Шаг 3

Я думаю и действую

читаю, вызываю инструменты, привожу аргументы

Stop · agent

Верификатор

Sonnet 4.6 читает ответ, ловит cherry-pick и блокирует

claude-sonnet-4-6

Шаг 5

Вы видите ответ

проверенный, или с пометкой о повторной попытке

Внутри шага 3 · PreToolUse

Маркер скила

matcher: Skill

Каждый раз, когда я вызываю Skill — фиксирует «отметку» в темпе сессии. Часть механизма «дисциплина».

skill-marker.py

Проверка дисциплины

matcher: Edit|Write|MultiEdit

Если я делаю правки без вызова скила — напоминает о §12 правил Claude. Не блокирует, только подсказывает.

skill-check.py

Страж экономии

matcher: Edit|Write|MultiEdit|Bash|Agent

Напоминает активный уровень при каждом действии. Ловит Bash-обходы (sed -i, echo >). Передаёт уровень subagent'у.

economy-state-guard.py

Происходит отдельно

На старте сессии economy-self-check.py проверяет, что все 5 hook-скриптов и Python на месте, а settings.json валиден. При проблемах — видимое предупреждение в UI.

После авто-сжатия economy-postcompact.py re-injects активный уровень обратно в контекст, чтобы я не «забывал» правила после потери начала сессии.

IV

Реестр хуков — построчно

Семь активных хуков, четыре уникальных события, два типа исполнителей. Шесть хуков — обычные shell-команды (Python-скрипты), один — agent-type с моделью Sonnet 4.6.

SessionStart

(any)

economy-self-check.py · Проверяет инфраструктуру: hook-скрипты, Python в PATH, settings.json.

command

UserPromptSubmit

(any)

economy-mode.py · Парсит «экономия N%» в конце промпта, пишет state, инжектит правила.

command

PreToolUse

Skill

skill-marker.py · «Дисциплина»: ставит per-session отметку «скил был вызван».

command

PreToolUse

Edit|Write|MultiEdit

skill-check.py · «Дисциплина»: если отметки нет — напоминание о §12 правил Claude.

command

PreToolUse

Edit|Write|MultiEdit|Bash|Agent

economy-state-guard.py · Reminder активного уровня + Bash-bypass detection + subagent inheritance.

command

PostCompact

(any)

economy-postcompact.py · После авто-сжатия истории re-injects правила активного уровня.

command

Stop

(any)

Sonnet 4.6 verifier · Inline agent в settings.json. Читает мой ответ + tool calls, эмитит decision: «block» при нарушениях. Timeout 90 сек.

agent

V

Блок разрешений — Stage 0 ratchet

Декларативная защита от обхода. Эти правила в settings.json исполняются Claude Code до того, как я успею что-то сделать. После их установки даже я сам не могу нейтрализовать систему через Edit или Bash — проверено на практике.

1

allow

Разрешено
без вопросов

Одно правило: Bash(git push origin main:*) — пуш в main без диалога. Всё остальное идёт по обычным правилам Claude Code.

7

deny

Жёстко
заблокировано

Семь паттернов: rm и mv на hook-скрипты, на settings.json, и на state-файлы экономии. Никаких prompts — просто отказ.

16

ask

Только
с вашим approve

Шестнадцать правил: каждый Edit и Write на settings.json или любой hook-скрипт триггерит permission prompt. Вы видите, что я хочу сделать, и решаете.

VI

Установленные плагины

Четыре плагина, доставленных через marketplace. Каждый включает в себя один или больше скилов. Сами плагины ничего не делают — только привозят содержимое.

superpowers

obra/superpowers · v5.1.0

Главный плагин дисциплины процесса работы. Содержит 14 скилов: brainstorm, plan, execute, TDD, debug, code-review, verify, parallel agents, worktrees, finishing-branch, writing-skills… Связан с §12 Pravila — half-вес проекта.

14 skills · процесс работы

claude-md-management

anthropic · claude-plugins-official

Единственный канал правок корневого CLAUDE.md. Не даёт ему расходиться с Pravila и Tooling. Содержит claude-md-improver (skill — audit) и revise-claude-md (slash-command — capture learnings).

1 skill + 1 slash-command · инфраструктура CLAUDE.md

frontend-design

anthropic · claude-plugins-official

Помощник для построения отличающихся frontend-интерфейсов. Знает 50+ стилей, принципы типографики, цвета, motion, layout. Используется для UI работы — например, для этого документа.

1 skill · UI/UX дизайн

ui-ux-pro-max

nextlevelbuilder · ui-ux-pro-max-skill

Резерв-библиотека: 67 UI styles, 161 palette, 57 font pairings, 99 UX guidelines, 25 chart types (across 15+ tech stacks). Off-phase tool — активируется только через R14 pipeline в Plugin Stack Rules.

1 skill · резерв-библиотека UI/UX

VII

Скилы по плагинам

Все 28 capabilities (27 skills + 1 slash-command) сгруппированы по родительскому плагину. 18 принадлежат одному из 4 установленных плагинов (17 skills + 1 command), 10 — «standalone / встроенные» (не доставляются плагином, идут с Claude Code как часть базовой системы).

⚡

superpowers

14 skills · obra/superpowers v5.1.0

brainstorming

Идея → спек. Через диалог уточняет требования, предлагает 2-3 подхода с trade-off'ами. Не позволяет писать код до утверждения дизайна.

writing-plans

Спек → пошаговый план. Bite-sized задачи (2-5 мин каждая) с точными путями файлов, кодом, командами и TDD-структурой.

executing-plans

План → выполнение. Исполняет существующий план по шагам с checkpoint'ами для ревью между задачами.

test-driven-development

Iron law: тест ДО кода. Red (увидеть как тест падает), потом green (минимальная реализация), потом refactor. Никаких «тестов после».

systematic-debugging

4 фазы перед любым фиксом. Root cause → pattern → hypothesis → fix. Минимум 3 гипотезы. Запрет «быстрых патчей».

requesting-code-review

Перед merge / PR. Двухстадийный review через subagent'ы: spec compliance + code quality.

receiving-code-review

Когда получил feedback ревью. Правила обработки замечаний без слепого согласия и без отвержения любой критики.

verification-before-completion

Перед claim «готово». Обязательно запустить verification команду, проверить exit code и output. Никаких «должно работать».

finishing-a-development-branch

Когда работа на ветке закончена. Структурный выбор: merge / PR / cleanup с обоснованием каждого варианта.

using-git-worktrees

Изоляция feature-работы. Через `git worktree` — отдельный workspace вне current branch.

subagent-driven-development

Диспатч свежего subagent'а на каждую задачу плана. Изоляция контекста + 2-стадийный review между задачами.

dispatching-parallel-agents

2+ независимых задачи без shared state. Параллельные subagent'ы вместо последовательного выполнения. Экономия времени.

using-superpowers

Базовый skill про другие skills. Объясняет как находить и инвокировать остальные. Обычно срабатывает в начале сессии.

writing-skills

Когда создаёшь новый skill. Правила его написания, валидации и deployment.

¶

claude-md-management

1 skill + 1 command · anthropic · claude-plugins-official

claude-md-improver

Audit + targeted updates CLAUDE.md. Единственный канал структурных правок: добавление/удаление секций, версии в шапке, правки правил.

revise-claude-md (command)

Захват session-learnings. Новые квирки, команды, паттерны из текущей сессии → автоматически в CLAUDE.md. Доставляется как slash-command в commands/, не skill.

◊

frontend-design

1 skill · anthropic · claude-plugins-official

frontend-design

Создание distinctive UI. Избегает generic AI-aesthetics. Distinctive fonts, bold direction, осознанные дизайн-выборы. Эта страница построена через него.

△

ui-ux-pro-max

1 skill · nextlevelbuilder · ui-ux-pro-max-skill

ui-ux-pro-max

Резерв-библиотека UI/UX. 67 UI styles, 161 palette, 57 font pairings, 99 UX guidelines, 25 chart types (across 15+ tech stacks). Активируется через PSR R14 pipeline.

⌖

Standalone / встроенные

10 skills · без плагина (часть базовой системы Claude Code)

update-config

Правки settings.json. Хуки, permissions, env vars, MCP servers, plugins. Любая автоматизация behaviour'а — через этот skill.

keybindings-help

Клавиатурные сокращения. Настройка `~/.claude/keybindings.json` — chord-bindings, rebind keys.

simplify

Review недавнего кода. Reuse / quality / efficiency. Находит дубли, over-engineering, dead code — потом фиксит.

fewer-permission-prompts

Снижение шума permission prompts. Сканирует transcript'ы, добавляет allowlist в settings.json для частых read-only действий.

init

Новый проект → новый CLAUDE.md. Инициализация документации для нового codebase с анализом структуры.

claude-api

Claude API / Anthropic SDK apps. Build / debug / optimize. Также миграция между версиями моделей (4.5 → 4.6 → 4.7).

loop

Запуск prompt'а на recurring interval. Например `/loop 5m /foo` — каждые 5 мин. Или self-paced если без интервала. Для polling, мониторинга.

schedule

Cron-расписания для агентов. Создание / управление scheduled remote routines. Также one-time scheduled запуски («сделай это завтра в 15:00»).

review

Review текущего PR на GitHub. Чтение diff'а, замечания по логике, стилю, тестам. Подготовка к merge.

security-review

Security audit pending changes. Полный security review текущей ветки: OWASP top 10, secrets, RLS, injection vectors.

VIII

Карта на диске

Где физически лежит каждый компонент. Три уровня: user (общая инфраструктура Claude Code), brain (source) (репозиторий-источник, который правится осознанно), project (consumer) (любой проект, в который brain установлен через install.sh).

userC:\Users\Administrator\.claude\
  ├── settings.json                            главный конфиг: permissions + hooks (собран из settings-fragment.json)
  ├── settings.json.backup-pre-economy-hardening
  │
  ├── hooks/                                  Python-скрипты хуков (синкаются из brain user-level-files/hooks/)
  │   ├── skill-marker.py                      PreToolUse(Skill)
  │   ├── skill-check.py                       PreToolUse(Edit|Write|MultiEdit)
  │   ├── economy-mode.py            (v3)      UserPromptSubmit + state writer
  │   ├── economy-mode-test.py                 54 теста
  │   ├── economy-self-check.py                SessionStart
  │   ├── economy-self-check-test.py           4 теста
  │   ├── economy-state-guard.py               PreToolUse + Bash detection
  │   ├── economy-state-guard-test.py          6 тестов
  │   ├── economy-verifier.py                  Stop wrapper
  │   └── economy-postcompact.py               PostCompact
  │
  ├── plugins/cache/                          загруженные плагины (marketplace-источники в marketplaces.json)
  │   ├── superpowers-dev/superpowers/5.1.0/   obra/superpowers
  │   ├── claude-plugins-official/claude-md-management/1.0.0/
  │   ├── claude-plugins-official/frontend-design/
  │   └── ui-ux-pro-max-skill/ui-ux-pro-max/2.5.0/
  │
  └── projects/<cwd>/memory/             долгосрочная память (per-project)
      ├── MEMORY.md (index)
      └── ... per-project files

brain (source)c:\моя\проекты\claude-brain\
  ├── manifest.json                            SHA-256 hashes всех файлов brain v1.0
  ├── CLAUDE.md / README.md / CHANGELOG.md
  │
  ├── project-files/                         копируется в consumer-проекты install.sh'ом
  │   ├── CLAUDE.md.template
  │   ├── .mcp.json.template                   playwright + github + semgrep
  │   └── docs/
  │       ├── Pravila_raboty_Claude.template.md
  │       ├── Plugin_stack_rules.template.md
  │       ├── Tooling.template.md
  │       └── visualizations/hooks-skills-plugins-map.html  вы тут
  │
  ├── user-level-files/                      копируется в ~/.claude/ install.sh'ом
  │   ├── hooks/                               7 рантайм + 3 test .py
  │   ├── settings-fragment.json               фрагмент для merge в settings.json
  │   ├── marketplaces.json                    3 marketplace-источника
  │   ├── plugins-manifest.json                4 плагина + версии
  │   └── mcp-user.template.json               magic (21st.dev)
  │
  ├── scripts/                               инструменты sync
  │   ├── install.sh                           copy brain → consumer / ~/.claude
  │   ├── verify.sh                            cross-check hashes vs manifest.json
  │   └── extract.sh                           rescue: consumer → brain
  │
  └── docs/                                    документация brain'а самого
      ├── architecture.md
      ├── how-to-use-brain.md
      ├── secrets-and-tokens.md
      └── sessions/2026-05-11-bootstrap-session.md

project (consumer)<consumer-project>/
  ├── CLAUDE.md                                из template, substitutions заполнены при install
  ├── .mcp.json                                project-mode MCP (playwright/github/semgrep)
  │
  └── docs/
      ├── Pravila_raboty_Claude.md             §12 hard rule (без версии в имени)
      ├── Plugin_stack_rules.md                16 правил координации
      ├── Tooling.md                           реестр инструментов проекта
      ├── CHANGELOG_claude_md.md
      ├── superpowers/{specs,plans}/           создаются по мере работы
      └── visualizations/hooks-skills-plugins-map.html  этот файл, installed copy

IX

Кто за что отвечает

Четыре действующих лица — четыре роли. Каждый делает то, что больше никто не может, и не лезет в чужой огород. Это про разделение обязанностей в системе.

Actor 01

Вы (Дмитрий)

Пишете промпт, опционально ставите «экономия N%» в конце
Approve'ите permission prompts на правки hook-файлов
Можете выключить хуки через settings.json → disableAllHooks
Вне Claude Code — единственный, кто может править settings/hooks без вопросов

Actor 02

Claude Code Runtime

Запускает хуки на нужных событиях, не спрашивая меня
Применяет permissions (deny/ask) к моим действиям
Передаёт мне injected additionalContext от хуков
Auto-mode classifier ловит мои попытки обхода

Actor 03

Я (Claude Opus 4.7)

Читаю injected правила и стараюсь им следовать
Вызываю skills — добровольно или по §12 требованию
Использую tools: Edit/Write/Bash/Read/Skill/etc.
Не могу обойти хуки или permissions — проверено

Actor 04

Sonnet 4.6 verifier

Читает мой финальный ответ + последние tool calls
Сравнивает с активным уровнем экономии
При cherry-pick или claim'е без evidence — блок
До 3 retry попыток за turn, потом — эскалация к вам

X

Связи — интерактивная карта

50 узлов, 52 ребра, 8 типов связей. Кликни на любой узел — подсветятся все его связи + откроется панель с деталями справа. Тяни узлы мышкой для перестановки. Фильтры в верхней панели прячут категории по одной.

Узлы (категории)

Плагин (4)

Скил/команда (28)

Скрипт хука (7)

Событие хука (5)

Файл состояния (1)

Права (3)

Правило (2)

Связи (типы)

содержит

запускает

пишет

читает

обязывает

ссылается

блокирует

запрещает

XI

MCP-серверы — внешние tool-провайдеры

Четыре сервера Model Context Protocol. Один на user-уровне (магазин компонентов), три на project-уровне (браузер, GitHub API, статанализ). MCP — это не плагин и не хук: это отдельный процесс, который запускается рядом с Claude Code и предоставляет дополнительные tools через stdio или HTTP.

magic

user · stdio · npx

UI-генерация компонентов от 21st.dev. Поиск, inspiration, refiner, logo search — для быстрых визуальных набросков. Зарегистрирован в ~/.claude/mcp.json (template: user-level-files/mcp-user.template.json).

npx @21st-dev/magic@latest · API_KEY required

playwright

project · stdio · npx

Headless-браузер. Открытие web/*.html, screenshot, проверка интерактива, навигация по DOM. Используется для визуальной верификации UI-работы.

npx @playwright/mcp@latest

github

project · HTTP · hosted

Официальный hosted GitHub MCP. Issues, PRs, файлы, search, actions. Требует GITHUB_TOKEN (PAT, scopes: repo, read:org). Заменил deprecated @modelcontextprotocol/server-github 06.05.2026.

https://api.githubcopilot.com/mcp

semgrep

project · stdio · npx

SAST. Семантический поиск и анализ кода через Semgrep rules прямо в Claude Code. Для security-review и поиска паттернов уязвимостей.

npx semgrep-mcp

XII

Что вы можете сделать

Шесть практических действий. Каждое — одна команда или одно изменение в одном файле.

1

Если вы хотите…

Активировать экономию для одной задачи

Допишите в самый конец промпта одно из: экономия 0% · экономия 25% · экономия 50% · экономия 75%. 0% — максимум, 75% — мягко, без ключа — обычный режим.

2

Если вы хотите…

Посмотреть, что сейчас включено

python -c "import json; s=json.load(open(r'C:\Users\Administrator\.claude\settings.json',encoding='utf-8')); print(list(s['hooks'].keys()))"

3

Если вы хотите…

Вызвать скил вручную

Напишите в промпте slash-команду: /superpowers:brainstorming · /claude-md-management:claude-md-improver · /init · /review · etc.

4

Если вы хотите…

Выключить все хуки временно

В ~/.claude/settings.json на верхнем уровне добавьте "disableAllHooks": true. Потребует ваш approve через ask-rule (так как Edit на settings.json). Уберёт всё включая дисциплину и верификатор.

5

Если вы хотите…

Проверить, что хуки работают

Откройте новую сессию Claude Code. SessionStart self-check сработает автоматически. Если что-то сломано — увидите «Economy hook self-check FAILED» в начале сессии.

6

Если вы хотите…

Откатить всё на до-economy состояние

copy "C:\Users\Administrator\.claude\settings.json.backup-pre-economy-hardening" "C:\Users\Administrator\.claude\settings.json"