From 9003b7d529e4e0876b94db995071641a524b5a02 Mon Sep 17 00:00:00 2001
From: Shahovalov MIkhail <m.shahovalov@yandex.ru>
Date: Tue, 26 May 2026 10:52:40 +0300
Subject: [PATCH] =?UTF-8?q?@=20chore:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=B8=D1=82=D1=8C=20=D0=BD=D0=B0=D0=B2=D1=8B=D0=BA=20docs-dele?=
 =?UTF-8?q?gate=20=D0=B2=20=D1=80=D0=B5=D0=BF=D0=BE=D0=B7=D0=B8=D1=82?=
 =?UTF-8?q?=D0=BE=D1=80=D0=B8=D0=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Навык делегирует обновление документации субагенту Sonnet. В таблицу файлов
добавлены docs/presentation.html (синхронизировать всегда) и CLAUDE.md —
закрыт пробел: ранее навык не упоминал презентацию, которую нужно держать актуальной.
.claude/settings.local.json остаётся в .gitignore.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@
---
 .claude/skills/docs-delegate/SKILL.md | 89 +++++++++++++++++++++++++++
 1 file changed, 89 insertions(+)
 create mode 100644 .claude/skills/docs-delegate/SKILL.md

diff --git a/.claude/skills/docs-delegate/SKILL.md b/.claude/skills/docs-delegate/SKILL.md
new file mode 100644
index 0000000..522f600
--- /dev/null
+++ b/.claude/skills/docs-delegate/SKILL.md
@@ -0,0 +1,89 @@
+---
+name: docs-delegate
+description: >
+  Делегирует обновление документации субагенту на модели Sonnet.
+  Используй ВСЕГДА, когда нужно синхронизировать README.md или docs/*.md
+  (ARCHITECTURE, OPEN_QUESTIONS) с изменениями в коде — не делай это сам,
+  передавай Sonnet. Триггер: «обнови доки», «синхронизируй документацию»,
+  «пусть Sonnet обновит README/ARCHITECTURE», «задокументируй изменения».
+---
+
+# docs-delegate — делегирование документации Sonnet
+
+Этот навык позволяет Opus (основной модели) не тратить контекст на рутинное
+обновление документации: нужно только описать, что изменилось, — Sonnet
+сделает остальное.
+
+## Шаги выполнения
+
+### 1. Составь сводку изменений
+
+Перед вызовом агента сформируй краткий список:
+- Что добавлено (новые инструменты, классы, функции)
+- Что изменилось (переименования, рефакторинг, изменение поведения)
+- Что удалено или устарело
+- Какие вопросы из OPEN_QUESTIONS теперь закрыты
+
+### 2. Запусти Agent с моделью Sonnet
+
+Используй инструмент `Agent` со следующими параметрами:
+
+```
+subagent_type: "general-purpose"
+model: "sonnet"
+description: "Обновление документации: <одна строка что изменилось>"
+prompt: <см. шаблон ниже>
+```
+
+### 3. Шаблон промпта для Sonnet
+
+Заполни `<СВОДКА_ИЗМЕНЕНИЙ>` и передай Sonnet:
+
+---
+
+Ты — помощник по документации проекта **kompas3d-mcp** (MCP-сервер для
+автоматизации CAD-системы КОМПАС-3D через COM API, .NET 8, C#).
+
+**Задача:** обнови документацию так, чтобы она точно отражала текущее состояние
+проекта. Вот что изменилось:
+
+```
+<СВОДКА_ИЗМЕНЕНИЙ>
+```
+
+**Файлы для обновления** (трогай только те, которых касаются изменения):
+
+| Файл | Что содержит |
+|------|-------------|
+| `docs/presentation.html` | **Презентация проекта — синхронизируй ВСЕГДА.** Счётчики (число инструментов, тестов), бейдж статуса, прогресс-бар, панель инструментов, дорожная карта |
+| `README.md` | Обзор проекта, список возможностей, команды сборки/запуска |
+| `CLAUDE.md` | Гайд для агента: «Current state», ключевые факты реализации, что не сделано |
+| `docs/ARCHITECTURE.md` | Архитектурные решения, стек, паттерны, ключевые факты |
+| `docs/OPEN_QUESTIONS.md` | Нерешённые вопросы и ограничения |
+
+**Правила:**
+
+1. Прочитай каждый файл перед правкой — не угадывай содержимое.
+2. Обновляй только секции, которые реально затронуты изменениями.
+   Не переписывай то, что остаётся актуальным.
+3. Если изменение закрывает вопрос из `OPEN_QUESTIONS.md` — удали его
+   или перенеси в раздел «Решено» (если такой есть).
+4. Сохраняй стиль, структуру и тон существующих документов.
+5. Будь лаконичен: одно предложение вместо абзаца, если смысл не теряется.
+6. Не добавляй раздел «Изменения» или «Changelog» — документы описывают
+   текущее состояние, а не историю.
+
+После правок кратко сообщи, что именно было изменено в каждом файле.
+
+---
+
+## Пример вызова
+
+```
+Запусти docs-delegate со следующей сводкой:
+- Добавлен инструмент get_part_info (масса, объём, материал)
+- QueryTools.cs перенесён в отдельный файл
+- Закрыт вопрос из OPEN_QUESTIONS про get_part_info
+```
+
+Или короче: «обнови доки — добавил get_part_info».