dsh-desktop-kit 0.0.0-stage → 2.0.0

package/skills/context-economy/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: context-economy
+description: "Экономия токенов и контекста: какие навыки и references грузить, как читать файлы и логи без перерасхода, когда сжимать сессию. Применять при длинных задачах, больших файлах, отладке и любых вопросах про расход токенов."
+whenToUse: "Когда задача длинная или многофайловая, когда контекст приближается к лимиту, когда нужно загрузить навык/справочник, или когда пользователь спрашивает про расход токенов."
+user-invocable: true
+---
+
+# Контекст-экономика — ядро
+
+> ≈1k токенов. Это ядро; приёмы и цифры — в `references/`.
+
+## 0. Когда применять
+- Длинная/многошаговая задача, работа с большими файлами и логами.
+- Контекст > 50–60% окна, приближается компакция.
+- Выбор, какой навык или reference загрузить.
+- Вопросы «почему так дорого», «сколько токенов», «как сократить расход».
+
+## 1. Правила загрузки навыков
+1. Сначала **ядро** навыка (`SKILL.md`). References — только когда без них нельзя принять решение.
+2. Не более **3 навыков** на задачу; если тянет больше — выбери 1–2 главных, остальные по мере надобности.
+3. Не грузи навык «на всякий случай» и не перезагружай уже загруженный.
+4. Каждый reference читай **целиком один раз**, а не по кускам; если файл > 40 КБ — сначала оглавление/заголовки.
+5. Если ядро и reference противоречат — побеждает более специфичный документ, но безопасность важнее.
+
+## 2. Чтение файлов и данных
+1. Сначала `grep`/`glob` — потом `read` только нужного диапазона (`offset`/`limit`).
+2. Не читай файл повторно, если он не менялся; держи в голове номера строк.
+3. Для больших логов/JSON — сначала структура (ключи, размеры), потом выборка.
+4. Не выводи в контекст целые деревья каталогов: `glob` по шаблону точнее.
+5. Перед чтением 100 КБ спроси: «какое решение это изменит?» Нет ответа — не читай.
+
+## 3. Экономия на инструментах
+1. Один точный вызов лучше трёх «на всякий случай».
+2. Долгие операции — в фон, результат забирай один раз.
+3. Для проверки — минимальный воспроизводимый тест, а не весь набор.
+4. Не дублируй результат инструмента в ответе целиком: цитируй 1–3 значимые строки.
+
+## 4. Сжатие и память
+1. При 60–70% окна: зафиксируй состояние в память проекта (решения, файлы, следующий шаг), затем сжимай.
+2. В памяти — ссылки на файлы и выводы, а не копии кода.
+3. После компакции первым делом перечитай свой план и список изменённых файлов, а не всю переписку.
+4. Не храни в контексте промежуточные версии текста — только финальные.
+
+## 5. Ответы
+1. Пиши плотно: решение, проверка, риск. Без пересказа задания.
+2. Длинные листинги — в файл/артефакт, в чат — сводка.
+3. Не повторяй один и тот же факт в плане, ходе и итоге.
+
+## 6. Куда грузить дальше
+| Нужно | Файл | ≈токенов |
+|---|---|---|
+| Цифры, лимиты, формулы оценки | `references/token-math.md` | ≈1k |
+| Приёмы для конкретных инструментов | `references/tool-recipes.md` | ≈1k |
+| Чек-лист длинной сессии | `references/long-session.md` | ≈0.8k |
+
+## 7. Гейт перед сдачей
+- [ ] Загружены только нужные навыки и references.
+- [ ] Нет повторных чтений неизменённых файлов.
+- [ ] Контекст не превышает 70% без плана сжатия.
+- [ ] Итог содержит решение и проверку, а не пересказ.

package/skills/context-economy/references/long-session.md

@@ -0,0 +1,35 @@
+# long-session — часть навыка context-economy
+
+≈0.8k токенов. Читать перед сжатием длинной сессии или при приближении к лимиту.
+
+## Порог
+- 60% окна — план сжатия.
+- 75% — сжимай на ближайшем безопасном шаге (после завершённого действия, не посреди правки).
+
+## Протокол сжатия
+1. Собери **handoff** (5–9 строк):
+   - цель и критерий готовности;
+   - что уже сделано (файлы/артефакты);
+   - что проверено и каким тестом;
+   - открытые вопросы и риски;
+   - следующий конкретный шаг.
+2. Запиши handoff в память проекта (journal) или в файл `HANDOFF.md`.
+3. Только потом запускай компакцию.
+4. После сжатия перечитай handoff и список изменённых файлов; не перечитывай переписку.
+
+## Что нельзя терять
+- Пути к ключевым файлам и команды запуска.
+- Результаты тестов/аудита (числа, а не «всё ок»).
+- Принятые решения и почему отвергнуты альтернативы.
+- Незакоммиченные изменения и бэкапы.
+
+## Признаки, что пора сжимать
+- Ответы становятся общими, теряются детали.
+- Приходится повторно читать те же файлы.
+- Контекст > 90k токенов, а задача ещё не закончена.
+- Появились длинные простыни логов в истории.
+
+## Дешёвая альтернатива сжатию
+- Закрыть завершённую подзадачу коротким итогом.
+- Удалить из истории промежуточные версии текста (оставить финал).
+- Перейти на узкую задачу: «сейчас только тест X».

package/skills/context-economy/references/token-math.md

@@ -0,0 +1,42 @@
+# token-math — часть навыка context-economy
+
+≈0.9k токенов. Читать, когда нужно оценить расход, сравнить варианты или посчитать бюджет.
+
+## Оценка без токенизатора
+| Материал | Символов на токен | Байт на токен |
+|---|---|---|
+| Русский текст | ≈2.2–2.8 | ≈4.4–5.6 (UTF-8, 2 байта/буква) |
+| Английский текст | ≈3.8–4.2 | ≈3.8–4.2 |
+| Код (JS/PHP/SQL) | ≈3.0–3.5 | ≈3.0–3.5 |
+| Markdown с таблицами | ≈2.5–3.0 | — |
+
+Практическое правило: **токены ≈ байты / 3.2** для смешанного русского markdown; это оценка сверху, погрешность 10–20%.
+
+Пример: SKILL.md 12 КБ → ≈3 800 токенов (12 000 / 3.2). Если такой файл грузится в каждой задаче — это ≈3.8k на задачу.
+
+## Бюджеты
+| Объект | Комфортно | Предел |
+|---|---|---|
+| Ядро навыка (`SKILL.md`) | 2–4k токенов | 6k |
+| Один reference | 1–4k | 8k |
+| Навыков на задачу | 1–3 | 5 |
+| Дайджест памяти проекта | 500–900 | 2 000 |
+| Ответ агента | 300–800 | 2 000 |
+
+## Контекстное окно
+- Типичное окно DeepSeek: **128 000** токенов; у части моделей — 64k.
+- Рабочий порог: 60% (≈77k) — начинай думать о сжатии; 75% (≈96k) — сжимай.
+- Запас нужен на ответ и инструменты: не заходи за 85%.
+- Стоимость запроса растёт линейно с контекстом: каждый лишний 1k в системном промпте умножается на число шагов.
+
+## Что реально экономит
+1. Компактные ядра навыков: −60–70% против полного текста.
+2. Загрузка references по требованию, а не сразу.
+3. Чтение диапазонов вместо файлов целиком.
+4. Один фон-джоб вместо серии синхронных вызовов.
+5. Компакция с записанным состоянием, а не «забыть и начать заново».
+
+## Чего не делать
+- Не считать «страницу = 500 токенов»: страница плотного текста — 800–1200.
+- Не экономить на проверке безопасности/данных — цена ошибки выше токенов.
+- Не резать references, которые меняют решение: это ложная экономия.

package/skills/context-economy/references/tool-recipes.md

@@ -0,0 +1,34 @@
+# tool-recipes — часть навыка context-economy
+
+≈1k токенов. Читать, когда нужны конкретные приёмы экономии в инструментах DSH.
+
+## Поиск и чтение
+```
+grep  pattern: "class Foo|function bar"  include: "*.php"     # сначала границы
+read  file_path  offset: 120  limit: 40                      # диапазон, не весь файл
+glob  pattern: "src/**/*.test.ts"                            # файлы, не каталоги
+```
+- 3–5 точных grep дешевле одного чтения 100-КБ файла.
+- После правки перечитывай только изменённый участок.
+- Если файл уже менялся в сессии — помни номера строк; повторное чтение только после внешней правки.
+
+## Команды и логи
+- Длинный вывод: `... | Select-Object -Last 80` или `2>&1 | Select-String "error"`.
+- Для сборки/тестов проси краткий формат (`--reporter=dot`, `--no-progress`).
+- Повторяющиеся проверки — в один скрипт, а не в пять команд.
+- Фоновые задачи: запусти, продолжай работу, забери результат один раз.
+
+## Веб
+- `web_search` — 1–4 запроса за вызов, не по одному.
+- Повторно не тяни тот же URL; сохрани нужные цитаты сразу.
+- `web_fetch` — только конкретная страница, не «весь сайт».
+
+## Плагины и конфиги
+- `cordis_inspect_query` точечно: один сервис/слот, а не весь каталог.
+- Не запрашивай типы, если хватает сигнатуры метода.
+- Перед правкой плагина проверь его `package.json` и точку входа.
+
+## Долгие сессии
+- Каждые 10–15 шагов фиксируй: что сделано, какие файлы изменены, следующий шаг.
+- Перед компакцией — короткий handoff в 5 строк.
+- После компакции не восстанавливай всю переписку: план + изменённые файлы + последний тест.

package/skills/database-safety/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: database-safety
+description: "Безопасность БД: бэкап и проверка, запрет destructive без разрешения, аддитивные миграции, копия живой базы, восстановление."
+whenToUse: "Перед миграциями, сидами, массовыми UPDATE/DELETE, импортом, восстановлением и релизом с изменениями схемы или данных."
+user-invocable: true
+---
+
+# Безопасность БД
+
+## 0. Когда применять
+- Миграции, сиды, импорт, массовые `UPDATE/DELETE`, восстановление, релиз со схемой/данными, инцидент.
+
+## 1. Главное
+
+**Железные правила:**
+- **Боевая БД неприкосновенна для экспериментов.** Тесты — отдельная БД на той же СУБД, что прод.
+- **Destructive — только с явным разрешением пользователя И проверенным бэкапом; без обоих запрещено:** `DROP/TRUNCATE`, `db:wipe`, `drop database`, `migrate:fresh/reset/refresh`, `migrate:rollback` без плана, массовые `UPDATE/DELETE` без WHERE, пересоздание контейнера БД.
+- Бэкап без проверки = бэкапа нет: `pg_restore --list`, `PRAGMA integrity_check` или тестовое восстановление.
+- Миграции аддитивные (таблица/колонка/индекс), с `down()`; применённые не редактировать; схема на проде — после копии, при риске — maintenance.
+- Многозаписные — в транзакции; гонки — `lockForUpdate()`; массовые — батчами; тяжёлые — `EXPLAIN`.
+- Инспекция прода — только read-only; не запускай прод-команды с dev-машины.
+
+**Бэкап (проверь восстановлением):**
+- PostgreSQL: `pg_dump -Fc -f backup_$(date +%F_%H%M).dump "$DATABASE_URL"` → `pg_restore --list backup.dump | head`.
+- MySQL: `mysqldump --single-transaction --routines --triggers db > backup.sql`.
+- SQLite: `sqlite3 app.db ".backup 'backup.db'"` → `PRAGMA integrity_check;`.
+- Копия вне сервера; `php artisan migrate:status`, `php artisan migrate --pretend` — до изменений.
+
+**Перед миграцией/релизом:**
+1. Сравни наборы миграций старой/новой версии, прочитай новые (drop/rename/NOT NULL/типы).
+2. `--pretend`/SQL-план + прогон на копии живой БД (`pg-upgrade-verify`).
+3. Бэкап и проверка.
+4. Выкатка (maintenance при риске) → smoke + сверка счётчиков.
+
+**Восстановление:** останови приложение; восстанавливай в пустую БД; проверь целостность, счётчики, smoke; живую не перезаписывай без разрешения, старый бэкап не удаляй до проверки.
+
+**Гигиена:** секреты — в `.env`/хранилище, не в коде/гите/логах; PII — не в тестовых данных/скриншотах (фабрики/анонимизация); ежедневный бэкап + проверка + копия вне сервера, минимум прав. Инцидент: стоп записи, снимок, не затирать бэкапы, зафиксировать, сообщить.
+
+## 2. Куда грузить дальше
+Смежные: `pg-upgrade-verify`, `service-desk-db-safety`, `release-and-deploy`.
+
+## 3. Гейт перед сдачей
+- [ ] На destructive — явное разрешение и проверенный бэкап.
+- [ ] Боевая не тронута; эксперименты на отдельной БД.
+- [ ] Миграции аддитивные, с `down()`, проверены на копии; `--pretend` прочитан.
+- [ ] План отката/восстановления проверен; maintenance при риске.
+- [ ] После — smoke, счётчики, чистые логи; секреты и PII не утекли.

package/skills/debugging-playbook/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: debugging-playbook
+description: "Отладка бага: воспроизведение, факты и логи, изоляция, одна гипотеза, фикс в причине, регрессионный тест и проверка."
+whenToUse: "Когда что-то не работает: падает тест, ошибка в логах, поведение не совпадает с ожидаемым или баг только на проде."
+user-invocable: true
+---
+
+# Плейбук отладки
+
+## 0. Когда применять
+- Ошибка, красный тест, «не работает» без деталей; поведение ≠ ожидаемое.
+- Баг только на проде/у части пользователей; нужна причина, а не маскировка симптома.
+
+## 1. Главное
+1. **Симптом:** ожидалось / произошло; где (URL, экран, команда), шаги, частота, окружение, версия.
+2. **Факты, а не догадки:** полный текст ошибки и стек; логи (`storage/logs/laravel.log`, `journalctl -u <service> -n 200 --no-pager`, браузер); состояние БД; конфиг; недавние изменения (`git log --oneline -10`, `git diff`, `git status`).
+3. **Минимальное воспроизведение:** один тест/запрос/сценарий; убери лишнее; не воспроизводится — собери факты, не меняй код наугад.
+4. **Сузить область:** бинарный поиск (отключай middleware/события/кеш, комментируй блоки, `git bisect`); сравни «работает / не работает»; проверь кеши (`php artisan config:clear`, `route:clear`, `view:clear`, `cache:clear`), порты, данные (NULL, кодировки, FK), права, `.env`, версии.
+5. **Гипотеза → проверка:** одна за раз, «если …, то …»; подтверждай логом/дампом/тестом.
+6. **Фикс:** минимальный, в причине, а не в симптоме. Добавь **регрессионный тест**: без фикса красный, с фиксом зелёный.
+7. **Проверка:** исходный сценарий на реальных данных/экране; соседние сценарии; полный набор тестов.
+8. **Закрыть:** причина и фикс — в память/CHANGELOG; как предотвратить повтор (валидация, guard, тест, алерт).
+
+**Стоп-правила:**
+- Не отлаживай на боевой БД; только чтение или копия. Деструктивные эксперименты запрещены.
+- Не отключай auth/CSRF/права, чтобы «проверить»; не коммить `dd`/`var_dump`/временные логи; не удаляй улики.
+- Прод-баг: сравни конфиг, версию, данные и кеши с локалью; не воспроизводи на живых пользователях.
+
+**Частые ловушки:**
+- «Помогло после очистки кеша» / «после перезапуска» — причина в кеше, состоянии или деплое.
+- Только на проде — конфиг/версия/данные/права.
+- Тест зелёный, баг есть — тест проверяет не то поведение.
+
+## 2. Куда грузить дальше
+Смежные: `testing-strategy`, `code-review-checklist`.
+
+## 3. Гейт перед сдачей
+- [ ] Есть воспроизведение и подтверждённая причина (факт, не догадка).
+- [ ] Фикс в причине, минимальный; симптом исчез на реальном сценарии.
+- [ ] Регрессионный тест падает без фикса и проходит с ним; полный набор зелёный.
+- [ ] Соседние сценарии проверены; нет временного кода/логов/`dd`.
+- [ ] Причина, фикс и профилактика записаны в память/CHANGELOG.

package/skills/design-critique/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: design-critique
+description: "Дизайн-критик: аудит готового UI по 12 критериям, скриншоты, axe, правки «до/после»; вердикт SHIP/NEEDS WORK/REDESIGN."
+whenToUse: "Оценить интерфейс, понять «почему выглядит дёшево», ревью страницы/дашборда/формы, сравнить варианты, поднять UI до WOW."
+user-invocable: true
+---
+
+# DESIGN-CRITIQUE — дизайн-критик
+
+> Строгий, но справедливый арт-директор: видишь то, что не видит автор, и превращаешь «нормально»
+> в «дорого». Формула: что вижу → почему плохо → как исправить (в px/rem/токенах).
+
+## 1. Контекст и «до»
+Когда: оценка, второй взгляд перед сдачей, сравнение 2–3 вариантов.
+Аудитория, задача экрана, что важнее (скорость/доверие/конверсия/плотность) — без этого «красиво» нет.
+Собери «до»:
+`node ../wow-design/assets/scripts/capture.mjs <file|url> --name before --out <dir>`
+`node ../wow-design/assets/scripts/audit.mjs <file|url> --out <dir>`
+Нужны 1440 light, 390, dark; смотри PNG через `read_image`.
+
+## 2. Быстрые тесты (10 минут)
+5 секунд · squint/blur 8px · grayscale · zoom 200% · 390/768 · Tab/Escape · dark · axe.
+Что ловит и пороги — `references/quick-tests.md`.
+
+## 3. Рубрика: 12 критериев, 1–5
+К1 впечатление 15% · К2 иерархия 12% · К3 типографика 12% · К4 цвет/контраст 10% · К5 сетка 10% ·
+К6 воздух 8% · К7 компоненты/состояния 8% · К8 консистентность 7% · К9 детали 6% · К10 адаптив 5% ·
+К11 доступность 4% · К12 оригинальность 3%.
+Балл = Σ(оценка×вес); 5 — Linear/Stripe/Apple, 3 — «нормально», 1 — сломано.
+**Сдача: ≥4.4/5 и все ≥4.** Блокеры вне баллов: axe critical/serious, overflow 390, контраст <4.5,
+сломанные состояния. Дескрипторы — `references/rubric-fast.md`.
+
+## 4. Приоритеты и фиксы
+P0: нечитаемый контраст, сломанный мобильный, нет иерархии, AI-slop, нерабочие состояния, axe.
+P1: типографика, воздух, ритм, тени/радиусы, отступы, слабый первый экран.
+P2: микродетали, motion, selection/scrollbar/focus.
+Каждый пункт: что вижу (скрин/координата) → почему → фикс со значениями → приоритет.
+Не «современнее», а «H1 48→72px; радиус 24→14; +48px воздуха». P0+P1 → переснять → «до/после».
+Диагнозы — `references/diagnoses.md`.
+
+## 5. Доступность
+Контраст 4.5:1 (крупный/границы 3:1); Tab/focus-visible/Escape/focus trap; alt, `aria-label`, `<label>`;
+не только цветом; reduced-motion; axe 0 critical/serious. Детали — `references/a11y.md`.
+
+## 6. Нужно → файл → ≈токенов
+| Нужно | Файл | ≈токенов |
+|---|---|---|
+| Рубрика, дескрипторы, подсчёт | `rubric-fast.md` | 2.2k |
+| Тесты за 10 минут | `quick-tests.md` | 0.9k |
+| Симптом → лечение | `diagnoses.md` | 1k |
+| Доступность | `a11y.md` | 0.7k |
+| Шаблон отчёта | `report-template.md` | 1k |
+| Полная рубрика | `../wow-design/references/critique-rubric.md` | 7.4k |
+
+## 7. Гейт
+- [ ] Скриншоты 1440/768/390, light/dark.
+- [ ] Рубрика ≥4.4, все ≥4.
+- [ ] Axe 0 critical/serious.
+- [ ] 390: overflow 0, тапы ≥44.
+- [ ] P0 закрыты; есть «до/после».
+- [ ] «Что уже хорошо» — 3–5 пунктов.
+
+## 8. Отчёт
+Вердикт SHIP/NEEDS WORK/REDESIGN · балл и минимум · впечатление за 5 сек · P0/P1/P2 с фиксами ·
+что хорошо · проверено · после правок. Формат — `references/report-template.md`.

package/skills/design-critique/references/a11y.md

@@ -0,0 +1,25 @@
+# Доступность: обязательный чек-лист
+
+> Часть навыка design-critique. ≈0.7k токенов. Читать, когда: проверяешь доступность и нужно
+> не забыть ни один пункт; axe critical/serious — блокер сдачи.
+
+- [ ] **Контраст:** текст ≥4.5:1; крупный (≥24px или ≥18.66px bold) ≥3:1; иконки и границы
+  контролов ≥3:1. `--faint` — только декор.
+- [ ] **Клавиатура:** все интерактивные элементы доступны, `focus-visible` видим, порядок логичен.
+  Модалка держит фокус (focus trap), закрывается Escape, после закрытия фокус возвращается.
+- [ ] **Семантика:** landmarks (`header/nav/main/footer`), один `h1`, порядок заголовков без
+  пропусков, `lang="ru"`, skip-link; кнопка — `<button>`, ссылка — `<a>`.
+- [ ] **Изображения и иконки:** у изображений alt (декоративное — `alt=""`), у иконок-кнопок
+  `aria-label`, декоративные иконки — `aria-hidden="true"`.
+- [ ] **Не только цветом:** статусы дублируются текстом/иконкой; проверить grayscale.
+- [ ] **Формы:** `<label for>` у каждого поля, ошибки программно связаны (`aria-invalid`,
+  `aria-describedby`), placeholder не заменяет лейбл, `autocomplete` где уместно.
+- [ ] **Motion:** `prefers-reduced-motion` уважается; контент виден без анимации.
+- [ ] **axe:** 0 critical/serious; critical/serious — блокер, minor — в P1/P2.
+
+## Частые провалы
+- `outline:none` без замены — клавиатура «слепая».
+- Серый текст 2.4–4.3:1 на фоне; акцентный мелкий текст <4.5:1.
+- `<div onclick>` вместо кнопки; действия только по hover.
+- Ошибка только цветом/тостом, без текста у поля.
+- Модалка без `role="dialog"`, `aria-modal` и возврата фокуса.

package/skills/design-critique/references/diagnoses.md

@@ -0,0 +1,33 @@
+# Частые диагнозы и лечение
+
+> Часть навыка design-critique. ≈1k токенов. Читать, когда: слышишь «выглядит дёшево/шаблонно/каша»
+> и нужен точный диагноз с конкретными правками.
+
+| Симптом | Диагноз | Лечение |
+|---|---|---|
+| «Выглядит как шаблон» | нет характера: дефолтные радиусы/цвета/шрифт | 1 signature-деталь, serif display, свой акцент, асимметрия |
+| «Дёшево» | мало воздуха, всё в рамках, мелкие заголовки | ×1.5–2 к отступам секций, H1 больше на 30–60%, контрастнее иерархия |
+| «Каша» | нет маршрута взгляда, всего поровну | 1 главный акцент на экран, приглушить второстепенное (muted), убрать лишние рамки |
+| «Серо и скучно» | только нейтрали, нет тёплого/акцента | 1 акцент + тёплый полутон (медь/терракота), тонкие линии, зерно 2% |
+| «Пёстро» | много акцентов и цветов | 60-30-10: нейтрали 60%, вторичный 30%, акцент 10% |
+| «Тяжело читать» | длинная строка, мелкий текст, низкий контраст | 60–72ch, 16–18px body, 1.6 line-height, контраст ≥4.5 |
+| «Дёргается» | анимации ради анимаций, разные easing | только hover/reveal, 160–260ms, один easing, reduced-motion |
+| «Неудобно» | нет состояний, мелкие тапы, таблица ломается | states, 44px тапы, `.table-wrap`, явные CTA |
+| «Мобильный ужас» | десктопный layout сжат | мобильная композиция: стек, порядок, скрыть декор, sticky CTA |
+
+## Быстрая проверка «AI-slop» за 5 секунд
+1. Фиолетово-синий градиент / цветные блобы? → нет.
+2. Три одинаковые карточки с иконками в первом экране? → нет.
+3. Заголовок 20–24px при body 16px? → нет иерархии.
+4. Серый текст ниже 4.5:1 / подписи `#999`? → нечитаемо.
+5. Отступы 13/17/22px? → несогласованно.
+6. Эмодзи, иконки-ракеты, стекло, радиусы 24px у всего? → шаблон.
+7. Lorem ipsum / «инновационные решения»? → нет контента.
+8. Нет focus-visible / только hover? → недоступно.
+
+Хотя бы один пункт «да» — P0-блокер: до рубрики 4.4 не допускается.
+
+## Не переусердствуй
+- **Стерильный минимализм** — тоже дёшево: без иерархии и характера белый экран не спасает.
+- **Погоня за «дорого»** — всё serif и бежевое без акцента и цифр = «йога-студия», а не клиника.
+- **Красота в ущерб функции** — контраст, кегль, состояния и доступность не приносятся в жертву.

package/skills/design-critique/references/quick-tests.md

@@ -0,0 +1,30 @@
+# Быстрые тесты за 10 минут
+
+> Часть навыка design-critique. ≈0.9k токенов. Читать, когда: проводишь 10-минутную диагностику
+> перед оценкой по рубрике и нужны пороги.
+
+| Тест | Как | Что ловит | Порог |
+|---|---|---|---|
+| **5 секунд** | Открыть, отвернуться, посмотреть | Непонятно, что это и что делать | за 5 сек читаются смысл + главное действие |
+| **Squint** | Прищуриться / blur 8px | Провалы иерархии, «серая каша» | главный акцент виден, блоки различимы |
+| **Grayscale** | DevTools → Rendering → Grayscale / `filter:grayscale(1)` | Всё держится только на цвете | структура и статусы понятны без цвета |
+| **200% zoom** | Ctrl+= до 200% | Мелкий текст, поломки сетки | текст читаем, ничего не обрезано |
+| **390px** | DevTools device mode 390×844 | Overflow, мелкие тапы, обрезка | `scrollWidth ≤ innerWidth`, тапы ≥44px |
+| **768px** | Планшет | Промежуточные поломки сетки | плитки не рвутся, меню работает |
+| **Dark** | Переключить `data-theme=dark` | Инверсия, нечитаемый акцент, белые SVG | контраст AA, слои и тени читаются |
+| **Keyboard** | Tab/Shift+Tab/Escape/Enter | Нет фокуса, ловушки, нерабочие действия | фокус виден везде, Escape закрывает модалку |
+| **axe** | `node ~/.dsh/skills/wow-design/assets/scripts/audit.mjs <file>` | Контраст, alt, aria, landmarks | critical/serious = 0 |
+| **Reduced motion** | DevTools → Emulate prefers-reduced-motion | Контент, скрытый анимацией | контент виден, анимаций нет |
+
+## Как смотреть скриншоты
+1. `read_image` каждого PNG — не «по памяти», а реально открыть.
+2. Первый взгляд 5 секунд: что это, для кого, куда нажать; что цепляет первым.
+3. Squint: видна ли иерархия или всё слилось.
+4. Grayscale: остаётся ли структура без цвета.
+5. 390: нет обрезаний, скролла вбок, мелких тапов, «сжатого десктопа».
+6. Dark: фон/поверхности/контраст/акцент — отдельная палитра, не инверсия.
+7. Сравни с референсом из брифа: тот же уровень «дорого»?
+8. Выпиши 5–10 правок с числами, а не «сделать красивее».
+
+## Мини-набор, если времени нет
+5 секунд + 390px + контраст/axe + keyboard. Эти четыре теста ловят большинство P0.

package/skills/design-critique/references/report-template.md

@@ -0,0 +1,63 @@
+# Шаблон отчёта дизайн-ревью
+
+> Часть навыка design-critique. ≈1k токенов. Читать, когда: оформляешь ревью и нужен формат
+> с оценкой, вердиктом, P0/P1/P2 и «до/после».
+
+```markdown
+# Дизайн-ревью: <страница / компонент / продукт>
+**Контекст:** <аудитория; задача экрана; что важнее — доверие / скорость / плотность / конверсия>
+**Материалы:** <пути к скриншотам: 1440 light, 390, dark; ссылка/файл>
+**Вердикт:** SHIP / NEEDS WORK / REDESIGN
+
+## Оценка
+| # | Критерий | Вес | Балл | Комментарий (1 строка) |
+|---|---|---|---|---|
+| К1 | Первое впечатление / концепция | 15% | 5 | ... |
+| К2 | Иерархия и маршрут взгляда | 12% | 4 | ... |
+| К3 | Типографика | 12% | 4 | ... |
+| К4 | Цвет и контраст | 10% | 4 | ... |
+| К5 | Сетка, выравнивание, ритм | 10% | 4 | ... |
+| К6 | Воздух и плотность | 8% | 5 | ... |
+| К7 | Компоненты и состояния | 8% | 4 | ... |
+| К8 | Консистентность | 7% | 5 | ... |
+| К9 | Детали и полировка | 6% | 4 | ... |
+| К10 | Адаптив и мобильный | 5% | 4 | ... |
+| К11 | Доступность | 4% | 4 | ... |
+| К12 | Оригинальность vs польза | 3% | 4 | ... |
+**Итог:** X.XX / 5 · минимум по критериям: Y · блокеры: нет/есть
+
+## Первое впечатление (5 секунд)
+<Что понятно сразу; что пришлось искать; какое чувство производит экран>
+
+## P0 — блокеры (без них не сдаём)
+1. **Что вижу:** <...> (скрин: <путь>)
+   **Почему:** <...>
+   **Фикс:** <селектор/значение/токен: H1 48→72px, contrast #999→--ink-2>
+2. ...
+
+## P1 — важное (до сдачи)
+1. ...
+
+## P2 — полировка (после сдачи, если есть время)
+1. ...
+
+## Что уже хорошо (обязательно 3–5 пунктов)
+- ...
+
+## Проверено
+- [ ] 1440 desktop light · [ ] 390 mobile · [ ] 768 tablet · [ ] dark
+- [ ] 5 сек / squint / grayscale / 200% zoom
+- [ ] keyboard/focus · [ ] axe critical/serious = 0 · [ ] reduced-motion
+- [ ] нет horizontal overflow на 390
+
+## После правок
+<новые скриншоты, повторный балл, что исправлено>
+```
+
+## Тон и формат
+- Пиши в терминах экрана, а не кода: «три равных акцента», а не «bad hierarchy».
+- Всегда давай значение: «H1 до 72–88px», «радиус 24→14px», «строка 110→66ch».
+- Не больше 5–7 правок за итерацию.
+- Оценивай результат, а не намерение.
+- «Что уже хорошо» — обязательно 3–5 пунктов, иначе ревью не принимается.
+- Если правит другой исполнитель — отдай P0/P1 с точными значениями и критериями приёмки.

package/skills/design-critique/references/rubric-fast.md

@@ -0,0 +1,73 @@
+# Рубрика-инструмент: 12 критериев, дескрипторы, подсчёт
+
+> Часть навыка design-critique. ≈2.2k токенов. Читать, когда: оцениваешь UI по 12 критериям, нужны
+> дескрипторы уровней 5/3/1, формула балла, блокеры и правила критика.
+
+## Правила критика
+1. **Контекст раньше красоты:** аудитория, задача экрана, приоритет (доверие/скорость/плотность).
+2. **Каждое замечание — с доказательством:** что вижу (скрин/координата) → почему → фикс в px/rem/токенах.
+3. **Сначала блокеры:** P0 до P1/P2, даже если P2 «обиднее».
+4. **Хвалить обязательно:** 3–5 пунктов, что уже работает.
+5. **5–7 правок за итерацию**, не больше: иначе исполнитель распыляется.
+6. **Оценивай результат, а не намерение.** «Задумано красиво» не считается.
+7. **Сомневаешься 4/3 — ставь 3; 4/5 — ставь 4.** 5 — только уровень Linear/Stripe/Apple.
+8. Каждая итерация заканчивается скриншотом; без «до/после» критика не принимается.
+
+Шкала: **5** — уровень Linear/Stripe/Apple; **4** — крепкий профессиональный; **3** — «нормально,
+без характера»; **2** — заметно дёшево; **1** — сломано.
+
+## Веса и что проверяет
+| # | Критерий | Вес | Что проверяет |
+|---|---|---|---|
+| К1 | Первое впечатление / концепция | 15% | понятно ли за 5 секунд, есть ли идея и характер |
+| К2 | Иерархия и маршрут взгляда | 12% | одна главная точка, 3 уровня, путь к CTA |
+| К3 | Типографика | 12% | шкала, строка 60–72ch, интерлиньяж, трекинг, кириллица |
+| К4 | Цвет и контраст | 10% | 60-30-10, один акцент, AA, семантика статусов |
+| К5 | Сетка, выравнивание, ритм | 10% | 12 колонок, единые отступы, «ничего не гуляет» |
+| К6 | Воздух и плотность | 8% | дышит ли страница, группировка, нет «каши» |
+| К7 | Компоненты и состояния | 8% | все состояния, формы, таблицы, модалки, empty |
+| К8 | Консистентность | 7% | один язык на экранах и в обеих темах |
+| К9 | Детали и полировка | 6% | оптика, иконки, цифры, фокус, скроллбар |
+| К10 | Адаптив и мобильный | 5% | 390/768/1440, overflow, тач-цели, композиция |
+| К11 | Доступность | 4% | контраст, клавиатура, семантика, alt/aria, motion |
+| К12 | Оригинальность vs польза | 3% | не шаблон, но и не арт ради арта |
+
+## Дескрипторы: 5 / 3 / 1 и типичный провал
+| # | 5 | 3 | 1 | Провал |
+|---|---|---|---|---|
+| К1 | смысл и характер сразу, signature-деталь | понятно, но нейтрально/шаблонно, фокус размыт | хаос или пустота, доверия нет | центрированный hero с общими словами и 3 равными CTA |
+| К2 | H1 → lead → CTA, один акцент | много равных элементов, маршрут ищешь | иерархии нет, «серая каша» | два primary-CTA, акцентные заголовки секций |
+| К3 | ясная шкала, 60–72ch, безупречная кириллица | нерегулярная шкала, длинная строка | 5 размеров, 4 жирности, капс в абзацах | один гротеск на всё, одинаковые размеры |
+| К4 | спокойная палитра, акцент ≤10%, AA, ч/б держит структуру | 2–3 акцента, спорный контраст | кислотная палитра, текст нечитаем | `#999` на белом, 4 акцентных цвета |
+| К5 | одна сетка, ровные края, предсказуемый ритм | края гуляют, отступы «на глаз» | всё рассыпано, нет осей | три карточки разной высоты, «плавающие» CTA |
+| К6 | воздух идеален, группы читаются | местами прилипло/пусто | контент свален в кучу | 24px между секциями, 0 внутри карточек |
+| К7 | все состояния, живые формы, empty/loading | базовые есть, focus/disabled спорные | нет подписей, div-кнопки, формы без валидации | красивые кнопки без состояний, empty «Нет данных» |
+| К8 | один визуальный язык, темы без сюрпризов | разные радиусы/тени/иконки от экрана к экрану | три набора кнопок и два шрифта | showcase и dashboard как разные продукты |
+| К9 | уровень Linear/Stripe, ничего не обрезано | недокручено: оптика, отступы, сырые детали | небрежно, сломанные иконки | иконка ниже базовой линии во всех кнопках |
+| К10 | 390 читается, тапы крупные, таблица внутри | сжатый десктоп, мелкий текст, узкие отступы | на 390 неюзабельно | overflow из-за таблицы и 12px текст |
+| К11 | AA, видимый фокус, семантика, reduced-motion | фокус частичный, подписи слабые, axe minor | axe critical, недоступно с клавиатуры | `outline:none` и серый текст 2.4:1 |
+| К12 | запоминается одной деталью, но очевиден | «видел у 20 компаний», детали нет | копия или дизайн мешает пользоваться | необычный hero, скрывающий, чем занимается клиника |
+
+## Приоритеты
+- **P0 (блокеры):** нечитаемый контраст, сломанный мобильный, нет иерархии, AI-slop, нерабочие
+  состояния, критичные axe-нарушения. Без них нельзя сдавать.
+- **P1 (важное):** типографика, воздух, ритм, тени/радиусы, неконсистентные отступы, слабый первый экран.
+- **P2 (полировка):** микродетали, motion, selection/scrollbar/focus, редакционные штрихи.
+
+## Подсчёт и пороги
+```
+Итог = Σ(оценка_i × вес_i), i = 1..12
+Сдача: Итог ≥ 4.40  И  min(оценка_i) ≥ 4  И  нет P0-блокеров
+```
+Итог округляй до 2 знаков. Пример: 5,4,5,4,4,5,4,5,4,4,4,3 → 4.39, но К12=3 → **не сдано**
+(ни один критерий <4).
+4.44 без блокеров — сдано. 4.6 с axe critical — **не сдано**.
+
+**Блокеры вне баллов:** axe critical/serious > 0; горизонтальный overflow на 390; смысловой текст
+ниже 4.5:1; сломанные состояния (кнопка без фокуса, форма без ошибок); битые шрифты/изображения,
+ошибки в консоли на ключевых страницах.
+
+## Вердикт
+- **SHIP** — гейт пройден: ≥4.4, все ≥4, блокеров нет.
+- **NEEDS WORK** — есть P0/P1 или балл ниже порога, но основа рабочая.
+- **REDESIGN** — несколько P0 в структуре/иерархии: нужна переработка, а не полировка.