dsh-desktop-kit 2.2.1 → 2.7.3

package/plugins/dsh-skill-autopilot/index.js

@@ -21,8 +21,17 @@ import path from "node:path";
 export const inject = ["systemPrompt"];
 
 const STATE_FILE = "dsh-autopilot.json";
-const MAX_HINT_TOKENS = 140;
+const MAX_HINT_TOKENS = 300;
 const SKILL_CACHE_MS = 60_000;
+const AUTO_LOAD_MAX_BYTES = 4200;
+const AUTO_LOAD_MAX_SKILLS = 2;
+const PROJECT_RULES_MAX_BYTES = 2500;
+const QUALITY_CONTRACT = [
+  "<quality-contract>",
+  "Работай как топовый агент: 1) факты, версии, цены и практики — только после web_search/web_fetch; 2) дай 2+ независимых источника, дату и ссылки; 3) для рекомендаций предложи 2–3 конкретных референса/варианта и объясни выбор; 4) UI: до правок — wow-design/ui-craft, после — browser_qa audit 390/768/1440, исправь overflow, console errors и markup (alt, labels, duplicate id, heading order), приложи скриншоты; 5) код — repo_map/checkpoint/план/тесты; 6) не заявляй «готово» без проверки; если проверить нельзя — скажи честно.",
+  "</quality-contract>",
+].join("\n");
+let skillMetaCache = { at: 0, map: new Map() };
 
 /* ------------------------------------------------------------------ */
 /* intent rules                                                        */
@@ -38,8 +47,32 @@ const RULES = [
     id: "ui",
     label: "UI/дизайн",
     any: ["вёрстк", "верстк", "дизайн", "интерфейс", " ui ", "ux", "лендинг", "страниц", "компонент", "адаптив", "css", "tailwind", "макет", "красив", "темн", "светл", "кнопк", "форм"],
-    skills: ["wow-design", "ui-design-system"],
-    follow: { any: ["критик", "аудит", "оцен", "улучш", "передела"], skills: ["design-critique"] },
+    skills: ["wow-design", "ui-design-system", "ui-craft"],
+    follow: { any: ["критик", "аудит", "оцен", "улучш", "передела", "скриншот", "отступ", "мобил", "планшет", "overflow", "горизонт"], skills: ["design-critique", "visual-qa"] },
+  },
+  {
+    id: "quality",
+    label: "Качество UI",
+    any: ["отступ", "адаптив", "горизонт", "overflow", "скриншот", "мобил", "планшет", "поехал", "съехал", "вёрстк", "верстк"],
+    skills: ["ui-craft", "visual-qa"],
+  },
+  {
+    id: "markup",
+    label: "Разметка и доступность",
+    any: ["разметк", "html", "валид", "alt", "aria", "a11y", "доступн", "семант", "label", "заголовк"],
+    skills: ["ui-craft", "visual-qa"],
+  },
+  {
+    id: "subagents",
+    label: "Субагенты",
+    any: ["субагент", "subagent", "команда агентов", "параллельн", "ревьюер", "независимый аудит"],
+    skills: ["subagent-playbook"],
+  },
+  {
+    id: "orchestrate",
+    label: "Оркестрация",
+    any: ["весь проект", "все плагины", "комплексн", "рефакторинг", "архитектур", "оркестр", "workflow", "несколько задач", "параллельн", "релиз всего", "сложн"],
+    skills: ["subagent-playbook", "requirements-and-planning", "delivery-gate"],
   },
   {
     id: "seo",
@@ -57,14 +90,15 @@ const RULES = [
   {
     id: "research",
     label: "Актуальные факты",
-    any: ["актуал", "новост", "цена", "курс", "верси", "закон", "документац", "сравни", "найди в интернете", "последн", "сегодня", "2026", "рынок"],
-    skills: ["web-research"],
+    any: ["актуал", "новост", "цена", "курс", "верси", "закон", "документац", "сравни", "найди в интернете", "последн", "сегодня", "2026", "рынок", "лучшие практики", "best practice"],
+    skills: ["web-research", "research-first"],
   },
   {
     id: "plan",
     label: "Планирование",
     any: ["план", "тз", "требован", "декомпоз", "оцен", "архитектур", "вариант", "исследован", "предложи", "концепц"],
     skills: ["requirements-and-planning", "dev-workflow"],
+    follow: { any: ["субагент", "параллельн", "ревьюер"], skills: ["subagent-playbook"] },
   },
   {
     id: "debug",
@@ -207,6 +241,90 @@ function loadSkillCosts() {
   return map;
 }
 
+/**
+ * Read SKILL.md metadata + body lazily. `autoLoad: true` in frontmatter lets the
+ * autopilot inject the core instructions instead of only naming the skill.
+ */
+function loadSkillMeta(name) {
+  const now = Date.now();
+  if (now - skillMetaCache.at > SKILL_CACHE_MS) skillMetaCache = { at: now, map: new Map() };
+  if (skillMetaCache.map.has(name)) return skillMetaCache.map.get(name);
+  const file = path.join(dshHome(), "skills", name, "SKILL.md");
+  let meta = null;
+  try {
+    const text = fs.readFileSync(file, "utf8");
+    const match = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/u);
+    const front = match ? match[1] : "";
+    const autoLoad = /^autoLoad:\s*true\s*$/mu.test(front);
+    const body = (match ? text.slice(match[0].length) : text).trim();
+    meta = { autoLoad, body, bytes: Buffer.byteLength(body, "utf8") };
+  } catch {
+    meta = null;
+  }
+  skillMetaCache.map.set(name, meta);
+  return meta;
+}
+
+function loadAutoSkills(names) {
+  const blocks = [];
+  let used = 0;
+  for (const name of names) {
+    if (blocks.length >= AUTO_LOAD_MAX_SKILLS) break;
+    if (used >= AUTO_LOAD_MAX_BYTES) break;
+    const meta = loadSkillMeta(name);
+    if (!meta || !meta.autoLoad || meta.body.length === 0) continue;
+    const remaining = AUTO_LOAD_MAX_BYTES - used;
+    let body = meta.body;
+    if (Buffer.byteLength(body, "utf8") > remaining) {
+      body = body.slice(0, Math.max(0, remaining - 200)).trimEnd() + "\n…";
+    }
+    if (body.length === 0) continue;
+    blocks.push(`<auto-skill name="${name}">\n${body}\n</auto-skill>`);
+    used += Buffer.byteLength(body, "utf8");
+  }
+  return blocks;
+}
+
+/**
+ * Project rules: <cwd>/.dsh/rules/*.md. Rules with `always: true` or without
+ * `paths` are injected on every prompt; path-scoped rules are left for a
+ * future file-aware loader to avoid leaking irrelevant instructions.
+ */
+function loadProjectRules(session) {
+  const cwd = typeof session?.header?.cwd === "string" ? session.header.cwd : "";
+  if (cwd.length === 0) return "";
+  const directory = path.join(cwd, ".dsh", "rules");
+  let entries = [];
+  try {
+    entries = fs.readdirSync(directory, { withFileTypes: true }).filter((entry) => entry.isFile() && entry.name.endsWith(".md"));
+  } catch {
+    return "";
+  }
+  const blocks = [];
+  let used = 0;
+  for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
+    try {
+      const text = fs.readFileSync(path.join(directory, entry.name), "utf8");
+      const front = text.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/u);
+      const metadata = front ? front[1] : "";
+      const hasPaths = /^paths\s*:/mu.test(metadata);
+      const always = /^always:\s*true\s*$/mu.test(metadata);
+      if (hasPaths && !always) continue;
+      const body = (front ? text.slice(front[0].length) : text).trim();
+      if (body.length === 0) continue;
+      const remaining = PROJECT_RULES_MAX_BYTES - used;
+      if (remaining <= 0) break;
+      const clipped = body.length > remaining ? `${body.slice(0, Math.max(0, remaining - 120)).trimEnd()}\n…` : body;
+      blocks.push(`### ${entry.name}\n${clipped}`);
+      used += Buffer.byteLength(clipped, "utf8");
+    } catch {
+      /* unreadable rule */
+    }
+  }
+  if (blocks.length === 0) return "";
+  return `<project-rules>\n${blocks.join("\n\n")}\n</project-rules>`;
+}
+
 /** The latest durable user message of a session, read from the surface tail. */
 const lastMessageCache = new Map();
 function latestUserMessage(session) {
@@ -287,16 +405,18 @@ export function routeMessage(rawText, available = loadSkillCosts(), maxSkills =
   /* Prefer skills from the most specific (later, rarer) rules? Keep rule order:
    * it is ordered from the most common task families to the narrow ones. */
   const ordered = [];
+  const allNames = [];
   const seen = new Set();
   for (const hit of hits) {
     for (const name of hit.names) {
       if (seen.has(name) || !available.has(name)) continue;
       seen.add(name);
+      allNames.push(name);
       ordered.push({ name, tokens: available.get(name) });
     }
   }
   const skills = ordered.sort((left, right) => (right.tokens || 0) - (left.tokens || 0)).slice(0, maxSkills);
-  return { intents: hits.map((hit) => hit.label), skills };
+  return { intents: hits.map((hit) => hit.label), skills, allSkills: allNames };
 }
 
 function renderHint(route) {
@@ -427,9 +547,12 @@ export function apply(ctx) {
         const message = latestUserMessage(session);
         if (!message) return "";
         const route = routeMessage(message.text, loadSkillCosts(), readState().maxSkills);
-        if (route.skills.length === 0) return "";
-        const hint = renderHint(route);
-        if (hint.length > MAX_HINT_TOKENS * 4) return "";
+        const hint = route.skills.length > 0 ? renderHint(route) : "";
+        const autoSkills = loadAutoSkills(route.allSkills ?? []);
+        const autoBlock = autoSkills.length > 0 ? `<auto-skills>\n${autoSkills.join("\n")}\n</auto-skills>` : "";
+        const rules = loadProjectRules(session);
+        const value = [QUALITY_CONTRACT, rules, autoBlock, hint].filter((part) => part.length > 0).join("\n");
+        if (route.skills.length === 0) return value;
         const now = Date.now();
         lastHintAt = now;
         lastMatches.set(String(session.id), {
@@ -437,13 +560,13 @@ export function apply(ctx) {
           at: new Date(now).toISOString(),
           intents: route.intents,
           skills: route.skills,
-          chars: hint.length,
+          chars: value.length,
         });
         if (lastMatches.size > 40) {
           const oldest = [...lastMatches.entries()].sort((a, b) => a[1].at.localeCompare(b[1].at))[0];
           if (oldest) lastMatches.delete(oldest[0]);
         }
-        return hint;
+        return value;
       } catch (error) {
         logger?.warn?.(`[skill-autopilot] route failed: ${String(error)}`);
         return "";
@@ -459,3 +582,4 @@ export function apply(ctx) {
     };
   }, "skill-autopilot: lifecycle");
 }
+

package/skills/delivery-gate/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: delivery-gate
+description: "Финальный гейт перед сдачей: критерии, тесты, скриншоты, безопасность, источники, отсутствие дублей. Не отдавать результат без проверки."
+whenToUse: "Перед финальным ответом, релизом, публикацией, PR или после крупной правки."
+user-invocable: true
+autoLoad: true
+---
+
+# Delivery Gate — сдавать только проверенное
+
+> ≈350 токенов. Короткий чек-лист; детали — `code-review-checklist`, `testing-strategy`, `visual-qa`.
+
+## 1. Чек-лист
+- [ ] Требование и критерий «готово» сформулированы до кода.
+- [ ] `plan` согласован для крупной задачи; код не начат до approve.
+- [ ] Тесты/проверки прошли; нет скрытых падений и «пока не проверял».
+- [ ] UI: `browser_qa action=audit` на 1440/768/390, light/dark, нет overflow и обрезаний.
+- [ ] `guardrails action=check` перед коммитом: секреты, `.env`, защищённые пути, `git diff --check`.
+- [ ] Безопасность: нет секретов, публичных данных, опасных дефолтов.
+- [ ] Нет дублей: один сценарий = одно место/один источник правды.
+- [ ] Внешние факты — со ссылками и датами.
+- [ ] Отчёт: что сделано, как проверено, риски, что дальше.
+
+## 2. Красные флаги
+- «Должно работать» без запуска; скриншот без просмотра; источник без ссылки.
+- Два экрана делают одно и то же; новый компонент копирует старый вместо переиспользования.
+- Фикс без регрессионного теста/проверки, миграция без бэкапа, публикация без checksum.
+
+## 3. Формат отчёта
+Короткий итог → проверки (команды/скриншоты) → коммиты/артефакты → ограничения → следующий шаг.
+

package/skills/git-and-ci/SKILL.md

@@ -8,6 +8,7 @@ user-invocable: true
 # Git и CI (универсально)
 
 ## 0. Когда применять
+- В DSH для PR используй `github_review` (status/pr/checks/comments/diff); comment — только с confirm.
 - Создаёшь репозиторий, `.gitignore`, первый коммит.
 - Коммитишь, ветвишься, мержишь, ставишь тег.
 - Настраиваешь/чинишь CI или pre-commit.
@@ -18,7 +19,8 @@ user-invocable: true
 **Репозиторий**
 - `.gitignore` до первого коммита: зависимости, сборки, `.env*`, runtime, IDE, дампы; lock-файлы — в git.
 - Перед коммитом: `git status --short`, `git diff --check`, `git diff --stat`; в индекс — только осознанные файлы.
-- Не коммитить: `vendor/`, `node_modules/`, `public/build`, `storage/`-рантайм, дампы, PII.
+- Не коммитить: `vendor/`, 
+ode_modules/`, `public/build`, `storage/`-рантайм, дампы, PII.
 
 **Ветки и коммиты**
 - `main` — стабильная и защищённая; работа — в `feature/<кратко>` / `fix/<кратко>`.
@@ -58,3 +60,5 @@ CI гоняет те же команды, что локально; `main` — т
 - [ ] Линтер, статанализ, тесты зелёные; для UI — E2E.
 - [ ] Тег на проверенном коммите; CI на `main` зелёный.
 - [ ] Секрет ротирован, история очищена.
+
+

package/skills/manifest.json

@@ -1,7 +1,7 @@
 {
   "schema": 1,
-  "kitVersion": "2.2.1",
-  "generatedAt": "2026-11-06T12:03:12.122Z",
+  "kitVersion": "2.7.2",
+  "generatedAt": "2026-11-10T05:35:22.614Z",
   "skills": {
     "code-review-checklist": {
       "hash": "e665bf72cfbfb77948a3cd6df6ebced38777f9aff543d7b9c80b2ced8cccc662",
@@ -28,6 +28,11 @@
       "files": 1,
       "bytes": 4443
     },
+    "delivery-gate": {
+      "hash": "7b76909a8d5ce099d03813533a1f935aef62d8fe11e63080961c38fd9835e47f",
+      "files": 1,
+      "bytes": 2409
+    },
     "design-critique": {
       "hash": "bbc6ca34b0b76798d581dcd78e83a59040dfac028b5e10d8e7a9be28225410b8",
       "files": 6,
@@ -39,9 +44,9 @@
       "bytes": 17194
     },
     "git-and-ci": {
-      "hash": "0681041edb935da2c124265bbdacd3b6a0a96c7f163323960cff8c8ea67fd2f4",
+      "hash": "a2dc59c5920190bbc715a4a523f3a1592e1914e6d06385ec07341fb76897a6b6",
       "files": 1,
-      "bytes": 4192
+      "bytes": 4318
     },
     "pg-upgrade-verify": {
       "hash": "d734178c5dad317fc55842215bbeeba85230cdd8e7b0ea46d74eed92910b8dea",
@@ -64,9 +69,14 @@
       "bytes": 4409
     },
     "requirements-and-planning": {
-      "hash": "532cbccfb2d0f7eca06343927aba100bd653145ccd9b9173ca50299194631a05",
+      "hash": "16f3235a9dcdcd1858112806854ef03d76f77588b56434bbacab803bd204f005",
       "files": 4,
-      "bytes": 12964
+      "bytes": 13078
+    },
+    "research-first": {
+      "hash": "3a18814f9817a6843962c1c5bdd7c5c0bc535cf864a5039d5e3ac359990579a4",
+      "files": 2,
+      "bytes": 4273
     },
     "security-review": {
       "hash": "8665b2c469de8e83aca670021d5c335fa8c9b93b8dc6bb866759e6062b1abde4",
@@ -108,16 +118,31 @@
       "files": 3,
       "bytes": 13888
     },
+    "subagent-playbook": {
+      "hash": "72d10995462d43891e7ec2d028caa0ccbca7932875410d4a0d6cfa75c5fe2df9",
+      "files": 2,
+      "bytes": 5375
+    },
     "testing-strategy": {
       "hash": "773fdf1e389e59841b7766862f8890a11fba4a2fce42a2022b9c4bfaae8f6ecc",
       "files": 1,
       "bytes": 4279
     },
+    "ui-craft": {
+      "hash": "0fbca80ca2ca434828b3238ecd901fce54b5dc306456cb81a4ed52f7a95921c5",
+      "files": 1,
+      "bytes": 3387
+    },
     "ui-design-system": {
       "hash": "19244221171995b758dbad02f2e3602859308370b50cc37d93c6f2a6d44cd6f1",
       "files": 4,
       "bytes": 19454
     },
+    "visual-qa": {
+      "hash": "97ff6c9c02bbab4bb38c8591a39792f4f51c45bfe278dd7ea839d6cad27c7cf9",
+      "files": 2,
+      "bytes": 4118
+    },
     "web-research": {
       "hash": "9bf4d8ba6d2a0fc39c241cdd9f5fe54835af28872473aa617941589c526387c8",
       "files": 3,

package/skills/requirements-and-planning/SKILL.md

@@ -9,6 +9,7 @@ user-invocable: true
 > ≈1 600 токенов. Это ядро; детали — по ссылкам и только когда реально нужны.
 
 ## 0. Когда применять
+- В DSH крупную задачу веди через `plan` (`.dsh/PLAN.md`): draft → approve → код.
 - Новая задача: фича, страница, релиз, миграция — до первой правки.
 - Запрос расплывчат: «сделай красиво», «ускорь», «почини», «улучши как-то».
 - Нужны ТЗ, оценка, сравнение вариантов, критерии «готово»; результат — выводы и план, а не осмотр.
@@ -47,3 +48,5 @@ user-invocable: true
 - [ ] План с проверками и откатом выполнен; scope не расширен молча, «потом» вынесено.
 - [ ] Подобраны скиллы (`skills-router`), пройдены их гейты: тесты/скриншоты/SEO/бэкап.
 - [ ] Отчёт «сделано / как проверено / риски / дальше»; память и версия обновлены.
+
+

package/skills/research-first/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: research-first
+description: "Перед задачей проверить интернет, собрать факты и лучшие практики, сравнить 2–3 варианта и только потом делать. Ссылки, даты, источник — обязательны."
+whenToUse: "Почти любая задача, где есть версии, API, цены, законы, конкуренты, дизайн-референсы, «как правильно», «лучшие практики», новые технологии или риск устаревших знаний."
+user-invocable: true
+autoLoad: true
+---
+
+# Research-first — сначала факты и варианты, потом код
+
+> ≈600 токенов. Ядро; глубина — по `references/`.
+
+## 1. Когда поиск обязателен (по умолчанию — почти всегда)
+- Версии, API, библиотеки, плагины, цены, тарифы, законы, даты, релизы.
+- «Лучшие практики», архитектура, дизайн, UX, безопасность, релиз.
+- Есть риск, что знания модели устарели или это спорный факт.
+- Не ищи только если задача чисто локальная и проверяемая кодом/файлом.
+
+## 2. Протокол (до реализации)
+1. **2–4 запроса**: русский + английский, официальные термины, `site:` для docs.
+2. **2–3 независимых источника**, приоритет: официальная документация → первоисточник/paper → крупный инженерный блог. Маркетинг — только как мнение.
+3. **Открой ключевые страницы** (`web_fetch`), не ограничивайся сниппетами.
+4. Зафиксируй: дата поиска, версия/дата источника, расхождения.
+5. Сделай **матрицу вариантов**: 2–3 подхода, плюсы, минусы, риски, стоимость, рекомендация. Для мелкой задачи — 3 строки, не эссе.
+6. Только после этого — план и код. Ссылки — в ответе и в отчёте.
+
+## 3. Проверка качества
+- Нет ссылки — нет утверждения о внешнем факте.
+- Не выдавай пересказ за первоисточник; платный/закрытый источник помечай.
+- Не используй данные старше ~12 месяцев без пометки (кроме исторических).
+- Если поиск не дал ответа — скажи прямо и предложи, что уточнить.
+
+## 4. Выход
+Короткий вывод (1–3 предложения) → факты с датами → матрица вариантов → рекомендация → источники.
+

package/skills/research-first/references/query-patterns.md

@@ -0,0 +1,20 @@
+# Query patterns
+
+## Свежесть
+- Версии/API: `site:docs.<project> <api> <year>`, `release notes <project>`
+- Цены/тарифы: `<vendor> pricing <year>`, официальная страница
+- Законы: `site:gov.ru <тема>`, официальный документ
+- Дизайн: `site:dribbble.com <pattern>`, `site:mobbin.com <pattern>`, `site:linear.app changelog`
+
+## Источники
+1. Официальная документация / спецификация / changelog.
+2. Первоисточник (paper, RFC, закон, датасет).
+3. Инженерный блог/конференция с деталями реализации.
+4. Маркетинг/обзор — только как мнение, не как факт.
+
+## Матрица вариантов
+| Вариант | Плюсы | Минусы | Риск | Стоимость | Рекомендация |
+|---|---|---|---|---|---|
+
+## Пометки
+Актуально на: YYYY-MM-DD. Источник: URL (дата публикации). Если данные устарели — скажи явно.

package/skills/subagent-playbook/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: subagent-playbook
+description: "Когда и как привлекать субагентов: research-scout, ui-critic, responsive-qa, release-auditor, code-reviewer. Готовые промпты и разделение ролей."
+whenToUse: "Сложная задача, много файлов, нужен независимый аудит/ресёрч/визуальная критика/релизная проверка, или параллельная работа без общего контекста."
+user-invocable: true
+autoLoad: true
+---
+
+# Subagent Playbook — роли, которые усиливают
+
+> ≈550 токенов. Промпты — `references/prompts.md`.
+
+## 1. Когда spawn
+- Задача > ~1 часа или затрагивает несколько областей (дизайн + код + релиз).
+- Нужен свежий взгляд: критика UI, security/release аудит, независимый факт-чек.
+- Исследование, которое не должно съедать основной контекст.
+- Если независимых потоков ≥3 — сначала план, затем `workflow`; 1–2 роли — обычный `subagent`.
+- Не spawn ради количества: 1–2 роли на задачу, с чётким deliverable.
+
+## 2. Роли
+| Роль | Что делает | Выход |
+|---|---|---|
+| **research-scout** | 2–4 запроса, официальные источники, даты, варианты | матрица + ссылки |
+| **ui-critic** | скриншоты 1440/768/390, иерархия, отступы, состояния | 5–7 приоритетных правок |
+| **responsive-qa** | overflow, переносы, тач-цели, safe-area | список багов + доказательства |
+| **release-auditor** | тесты, версии, changelog, security, откат | go/no-go |
+| **code-reviewer** | диффы, риски, тесты, совместимость | блокеры/ниты |
+
+## 3. Как формулировать
+- Дай контекст, файлы/URL, ограничения, формат результата и критерий «готово».
+- Запрети менять чужие файлы, если роль только читает.
+- Проси ссылки/скриншоты/логи, а не мнение без доказательств.
+- Результаты своди в решение сам: субагент советует, Lead отвечает за итог.
+
+## 4. Параллельность
+Независимые роли (research + UI review) запускай одним сообщением; зависимости — через `wait_agent`/задачи. Не дублируй одну и ту же работу двумя ролями.

package/skills/subagent-playbook/references/prompts.md

@@ -0,0 +1,39 @@
+# Subagent prompt templates
+
+## research-scout
+```
+Ты research-scout. Собери актуальные факты по теме: <тема>.
+Сделай 2–4 запроса (RU/EN), приоритет официальной документации и первоисточникам.
+Сверь ≥2 независимых источника. Для каждого факта: утверждение, источник (URL), дата,
+расхождение/ограничение. В конце — матрица 2–3 вариантов решения (плюсы/минусы/риски) и
+рекомендация. Не пиши код и не меняй файлы. Верни только выжимку + ссылки.
+```
+
+## ui-critic
+```
+Ты ui-critic. Оцени интерфейс по скриншотам <пути/URL> на 1440/768/390.
+Критерии: иерархия, сетка 4/8, отступы, типографика, состояния, контраст, дубли,
+горизонтальный скролл, обрезания. Дай 5–7 приоритетных правок с «до/после» и
+ссылками на конкретные элементы. Не меняй файлы. Верни список и вердикт go/no-go.
+```
+
+## responsive-qa
+```
+Ты responsive-qa. Проверь <URL/HTML> на 390/768/1440: scrollWidth vs clientWidth,
+overflow-элементы, переносы длинных путей, тач-цели, safe-area, модалки/тосты.
+Приложи измерения и скриншоты проблем. Не меняй файлы. Верни баги по приоритету.
+```
+
+## release-auditor
+```
+Ты release-auditor. Проверь готовность релиза <версия/репозиторий>: тесты, CI, package,
+security (gitleaks/audit), миграции, откат, checksums, changelog. Верни go/no-go,
+блокеры и точные команды для исправления. Файлы не меняй.
+```
+
+## code-reviewer
+```
+Ты code-reviewer. Проверь диффы/файлы <список>. Ищи баги, регрессии, безопасность,
+производительность, несовместимость API, отсутствие тестов. Дай только конкретные
+замечания с файлом/строкой и severity. Не переписывай код без просьбы.
+```

package/skills/ui-craft/SKILL.md

@@ -0,0 +1,43 @@
+---
+name: ui-craft
+description: "Инженерная дисциплина UI: сетка и шкала отступов 4/8, типографика, состояния, адаптив 1440/768/390, отсутствие случайных сдвигов и дублей. Использовать при любой вёрстке и правке стилей."
+whenToUse: "Вёрстка, стили, карточки, формы, адаптив, исправление «поехавших» отступов, полировка интерфейса, дизайн-апгрейд."
+user-invocable: true
+autoLoad: true
+---
+
+# UI Craft — аккуратная геометрия и адаптив
+
+> ≈750 токенов. Дополняет `wow-design` и `ui-design-system`, не дублирует их.
+
+## 1. Сетка и отступы (жёстко)
+- Одна шкала: **4 / 8 / 12 / 16 / 24 / 32 / 48**. Никаких 7, 13, 23 px «на глаз».
+- Внешние отступы карточки = внутренние + 4/8; одинаковые интервалы по вертикали.
+- Заголовок → описание: 4–6 px; описание → контрол: 12–16; контролы между собой: 8–12.
+- Один контейнер = один max-width; текст не прилипает к краям (мин. 16–20 px).
+- Не выравнивай «по центру» то, что должно быть по базовой линии; проверяй по левому краю.
+
+## 2. Типографика
+- 2–3 размера текста + иерархия заголовков; line-height 1.35–1.55.
+- Числа и таймеры — `font-variant-numeric: tabular-nums`.
+- Не более 70–75 символов в строке; длинные пути/имена — `word-break` и `min-width:0`.
+
+## 3. Адаптив
+- Проверяй **1440, 768, 390** и промежуточные 560/640.
+- Вертикальный скролл допустим; **горизонтального быть не должно**.
+- Flex/grid: `min-width:0`, `flex-wrap`, `minmax(0,1fr)`, без фиксированных ширин больше контейнера.
+- Таблицы и пары ключ–значение на мобиле — в колонку, а не в обрез.
+- Тач-цели ≥ 40–44 px; отступы у краёв с `env(safe-area-inset-*)`.
+- Модалки/тосты: `max-height`, внутренний скролл, не перекрывают композер.
+
+## 4. Состояния и дубли
+- default / hover / focus-visible / active / disabled / loading / empty / error.
+- Фокус видимый, не только цветом; `prefers-reduced-motion`.
+- Одна мысль — один компонент. Если два экрана делают одно и то же, разведи роли или удали дубль.
+
+## 5. Гейт сдачи
+1. Снять скриншоты 1440/768/390 (light/dark, если тема есть).
+2. Проверить `scrollWidth <= clientWidth` и отсутствие обрезанных текстов.
+3. Свериться с референсами из `wow-design`, но не копировать вслепую.
+4. Только после этого отдавать результат; см. `visual-qa`.
+

package/skills/visual-qa/SKILL.md

@@ -0,0 +1,29 @@
+---
+name: visual-qa
+description: "Скриншот-проверка интерфейса: 1440/768/390, light/dark, поиск горизонтального скролла, обрезанных текстов и сдвигов; сравнение до/после."
+whenToUse: "После любой правки UI, перед сдачей или релизом; при жалобах на отступы, адаптив, скролл, «поехало»."
+user-invocable: true
+autoLoad: true
+---
+
+# Visual QA — снимки и объективная проверка
+
+> ≈500 токенов. Команды и шаблоны — `references/commands.md`.
+
+## 1. Что проверяем
+- **Горизонтальный скролл:** `document.documentElement.scrollWidth <= clientWidth` на 390/768/1440.
+- **Обрезания:** текст не выходит за карточку; кнопки не наезжают; длинные пути/числа переносятся.
+- **Ритм:** одинаковые отступы, выравнивание по сетке, нет «прыжков» между секциями.
+- **Контраст:** текст ≥ 4.5:1, крупный ≥ 3:1; фокус видим.
+- **Состояния:** loading/empty/error/disabled, тёмная тема, reduced-motion.
+
+## 2. Как снимать
+1. В DSH сначала инструмент `browser_qa action=audit url=... widths=[390,768,1440] outDir=...` — он сам даёт PNG, overflow и console errors.
+2. Живой DSH (если есть авторизованный URL) или preview-harness с реальным клиентским кодом.
+3. Смотреть каждый PNG глазами; сомнительные — увеличить/переснять. Для API-страниц без авторизации используй preview.
+4. Для overflow — доверяй `browser_qa`, а не угадыванию; при необходимости CDP-замер.
+5. После правок — повторный снимок и сравнение «до/после».
+
+## 3. Гейт
+Не отдавать UI без: 3 ширин, отсутствия горизонтального скролла, проверенных текстов и фокуса. Если снять нельзя — честно сказать и запросить скриншот пользователя.
+

package/skills/visual-qa/references/commands.md

@@ -0,0 +1,32 @@
+# Visual QA commands
+
+## Скриншоты Chrome (Windows)
+```powershell
+$chrome = "C:\Program Files\Google\Chrome\Application\chrome.exe"
+& $chrome --headless=new --disable-gpu --hide-scrollbars `
+  --window-size=1440,900 --virtual-time-budget=1500 `
+  --screenshot="$env:TEMP\ui-1440.png" "file:///C:/path/preview.html"
+```
+Повтори для 768×1024 и 390×844. Для локального файла с кириллицей скопируй HTML в `%TEMP%` с ASCII-именем.
+
+## Overflow через DevTools/CDP
+```js
+({
+  scrollWidth: document.documentElement.scrollWidth,
+  clientWidth: document.documentElement.clientWidth,
+  overflow: document.documentElement.scrollWidth > document.documentElement.clientWidth,
+});
+```
+Также проверь:
+```js
+[...document.querySelectorAll("*")].filter(el => el.scrollWidth > el.clientWidth + 1 && getComputedStyle(el).overflowX === "visible")
+```
+— исключи намеренные скролл-контейнеры.
+
+## Preview-harness
+- `dsh-memory-bridge/docs/preview/capture.mjs` — реальные клиентские компоненты, точные viewport, overflow-флаг.
+- `dsh-desktop-kit/tools/peak-toast-preview.mjs` — пример статического превью из настоящего CSS.
+- Всегда открывай итоговый PNG глазами; цифры не заменяют взгляд.
+
+## Приёмка
+1440×900, 768×1024, 390×844 · light/dark (если есть) · нет горизонтального скролла · нет обрезанных строк/кнопок · фокус видим · длинные пути переносятся.