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"