diff --git a/.claude/agents/docs-maintainer.md b/.claude/agents/docs-maintainer.md
index 148121a..fcf3183 100644
--- a/.claude/agents/docs-maintainer.md
+++ b/.claude/agents/docs-maintainer.md
@@ -1,13 +1,18 @@
 ---
 name: docs-maintainer
 description: >
-  Делегируй этому субагенту (Sonnet) синхронизацию документации проекта с
-  изменениями в коде — README.md, docs/*.md (ARCHITECTURE, OPEN_QUESTIONS),
-  docs/presentation.html. Используй ВСЕГДА, когда нужно отразить в доках новые
-  инструменты/классы/функции, переименования, удаления или закрытые вопросы
-  OPEN_QUESTIONS — не делай это сам, передавай сводку изменений этому субагенту.
-  Триггеры: «обнови доки», «синхронизируй документацию», «задокументируй
-  изменения», «обнови README/ARCHITECTURE».
+  ОБЯЗАТЕЛЬНО делегируй этому субагенту (Sonnet) ВСЮ синхронизацию документации
+  проекта с кодом — README.md, CLAUDE.md, docs/ARCHITECTURE.md,
+  docs/OPEN_QUESTIONS.md, docs/presentation.html — НЕ правь эти файлы сам.
+  Срабатывает ПРОАКТИВНО как обязательный шаг рабочего цикла, а НЕ по явной команде:
+  как только фича реализована и протестирована, ПЕРЕД коммитом доков передай ему
+  сводку изменений (новые/переименованные/удалённые инструменты, классы, факты
+  реализации, закрытые вопросы OPEN_QUESTIONS, новые счётчики инструментов/тестов
+  для presentation.html). Не жди реплики «обнови доки» — делегируй сам после каждой
+  завершённой единицы работы. Триггеры (включая ТВОИ внутренние): «фича готова, надо
+  отразить в доках», «обнови README/ARCHITECTURE/CLAUDE.md/presentation»,
+  «закрыт вопрос в OPEN_QUESTIONS», «синхронизируй документацию», «задокументируй
+  изменения». Передавай сводку текстом — код/тесты он сам не запускает (Bash нет).
 tools: Read, Edit, Write, Glob, Grep
 model: sonnet
 ---
diff --git a/.claude/agents/kompas-sdk-research.md b/.claude/agents/kompas-sdk-research.md
index 57940cf..20b9aa2 100644
--- a/.claude/agents/kompas-sdk-research.md
+++ b/.claude/agents/kompas-sdk-research.md
@@ -1,14 +1,20 @@
 ---
 name: kompas-sdk-research
 description: >
-  Делегируй этому субагенту (Sonnet) поиск и чтение справки КОМПАС SDK.
-  Источник — структурированная MD-база знаний docs/Kompas3D_SDK/ (статьи по
-  интерфейсам с YAML-тегами, ищется обычным Grep/Read). Используй ВСЕГДА, когда
-  нужно найти интерфейс/метод/константу COM API КОМПАС, его сигнатуру
-  (Automation/COM), значения перечисления, единицы измерения или паттерн
-  использования — не рой справку сам, передавай этому субагенту и получай
-  готовую выжимку. Триггеры: «найди в справке КОМПАС», «какая сигнатура у…»,
-  «какие значения enum…», «как через API КОМПАС сделать…», «что возвращает <метод>».
+  ОБЯЗАТЕЛЬНО делегируй этому субагенту (Haiku, read-only) ЛЮБОЙ поиск по справке
+  COM API КОМПАС в MD-базе docs/Kompas3D_SDK/ — НЕ грепай справку сам. Срабатывает
+  ПРОАКТИВНО, без явной просьбы пользователя: как только при планировании или
+  реализации фичи тебе понадобилась сигнатура метода (Automation/COM), значения
+  перечисления (Obj3dType, ksHoleTypeEnum, ST_MIX_*, стили линий…), нужный
+  интерфейс под задачу («чем/каким интерфейсом построить X»), единицы измерения
+  или цепочка вызовов — СНАЧАЛА спроси этого субагента, ПОТОМ пиши код. Это дёшево:
+  ответ Haiku ты всё равно перепроверяешь рефлексией по libs/kompas-interop/*.dll,
+  поэтому ошибка стоит мало, а сэкономленный контекст Opus — много. Триггеры (в т.ч.
+  ТВОИ внутренние, не только реплики пользователя): «нужна сигнатура …»,
+  «какие значения enum …», «каким интерфейсом сделать X через API КОМПАС»,
+  «что возвращает <метод>», «как через COM API построить …», «найди в справке КОМПАС».
+  НЕ для построения геометрии в КОМПАС (это MCP-инструменты / навык kompas-3d) и
+  НЕ для KsAPI (Qt/C++ — в MD-базе его нет).
 tools: Glob, Grep, Read
 model: haiku
 ---