Carta · vol. i · 2026 10.05.2026

# Карта работы
hooks · skills · plugins

Иллюстрированный справочник по внутреннему устройству Claude Code в проекте Лидерра. Что срабатывает в начале промпта, что — посреди вашей работы, и что — в конце. Три типа сущностей, семь хуков, пять событий, четыре плагина.

vIII Edition · Carta
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_v1_1.md
Продуктовые правила работы Claude, утверждены заказчиком (~13 секций).
2a
CLAUDE.md
Общая оперативная карта проекта, ссылается на источники истины.
2b
Tooling Прил. Н
Детальный реестр 33 инструментов. При конфликте с 2a — приоритет у CLAUDE.md как корневой карты.
3
Plugin_stack_rules_v1.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.

Событие
Matcher
Что делает
Тип
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 (audit) и revise-claude-md (capture learnings).
2 skills · инфраструктура 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
Резерв-библиотека: 50+ стилей, 161 палитра, 57 пар шрифтов, 161 тип продукта, 99 UX-гайдлайнов. Off-phase tool — активируется только через R14 pipeline в Plugin Stack Rules.
1 skill · резерв-библиотека UI/UX
VII

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

Все 28 скилов сгруппированы по родительскому плагину. 18 принадлежат одному из 4 установленных плагинов, 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
2 skills · anthropic · claude-plugins-official
claude-md-improver
Audit + targeted updates CLAUDE.md. Единственный канал структурных правок: добавление/удаление секций, версии в шапке, правки правил.
revise-claude-md
Захват session-learnings. Новые квирки, команды, паттерны из текущей сессии → автоматически в CLAUDE.md.
◊
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. 50+ стилей, 161 палитра, 57 пар шрифтов, 99 UX guidelines, 25 типов графиков для 10 стеков. Активируется через PSR_v1 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

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

Где физически лежит каждый компонент. Хук-скрипты живут отдельно от проекта Лидерры — это пользовательская инфраструктура Claude Code. Спеки и планы — в репозитории проекта.

    userC:\Users\Administrator\.claude\
      ├── settings.json                            главный конфиг: permissions + hooks
      ├── settings.json.backup-pre-economy-hardening
      │
      ├── hooks/                                  наши Python-скрипты хуков
      │   ├── 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/                          загруженные плагины
      │   ├── superpowers-dev/superpowers/5.1.0/
      │   ├── claude-plugins-official/claude-md-management/
      │   ├── claude-plugins-official/frontend-design/
      │   └── ui-ux-pro-max-skill/ui-ux-pro-max/
      │
      └── projects/<cwd>/memory/             долгосрочная память
          ├── MEMORY.md (index)
          ├── feedback_superpowers_hard_rule.md
          ├── project_state.md
          └── reference_github.md

    projectc:\моя\проекты\портал crm\Документация\
      ├── CLAUDE.md                                главная карта проекта
      ├── cspell-words.txt                         словарь cspell для pre-commit
      │
      ├── docs/Pravila_raboty_Claude_v1_1.md       §12 hard rule
      ├── docs/Plugin_stack_rules_v1.md            16 правил координации
      ├── docs/Tooling_v8_3.md                     реестр 33 инструментов
      │
      ├── docs/superpowers/specs/                  спеки фич (этот документ — для visualization)
      │   └── 2026-05-10-economy-hook-bypass-closure-design.md
      ├── docs/superpowers/plans/                  пошаговые планы
      │   └── 2026-05-10-economy-hook-bypass-closure.md
      └── docs/visualizations/                     визуализации (вы тут)
          └── hooks-skills-plugins-map.html

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

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

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

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"`