Patch Projects

---
name: patch-projects
description: Перевод ВСЕХ живых проектов на актуальный движок Vibe Dev одной командой (мягкое включение — подсказки вместо блокировок). Наклеивает этикетки истории (провенанс) + ставит новый движок в мягком режиме на безопасных проектах; проекты с жёстким UI-долгом (задачи в «готово» без скриншота) пропускает с флагом. Триггеры — "/patch-projects", "переведи все проекты", "обнови проекты на новую версию", "патч проектов". - Когда вышло обновление плагина (новый мажор) и надо привести существующие проекты в соответствие, не останавливая работу.
---

# /patch-projects — перевод всех живых проектов на актуальный движок

## Зачем

Когда плагин обновился до нового мажора, существующие проекты остаются на старом движке. Прямой перевод в СТРОГИЙ режим ломает работу: новый движок проверяет всё состояние проекта при каждой записи, и сотни старых «готово» без формальных доказательств заблокируют первую же правку. Этот скилл включает новый движок в **мягком режиме** (v8-проверки работают как подсказки, не блокировки) — безопасно и массово, одной командой.

## Что делает (по шагам)

1. **Предпросмотр (ничего не меняет).** Запусти:
   ```
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/patch-projects.sh"
   ```
   Скрипт сканирует папку проектов (по умолчанию `~/Coding`), для каждого прогоняет **реальный сторож** и печатает: какой проект безопасен для мягкого включения, а какой имеет жёсткий UI-долг (задачи в «готово» без скриншота — мягкий режим их НЕ понижает). Сам плагин, бэкапы, шаблоны, тесты и git-worktree исключаются автоматически.

2. **Покажи пользователю сводку** человеческим языком: сколько проектов включатся чисто, какие требуют решения UI-долга ПЕРЕД переводом, что пропущено. Не жаргоном — «мягкий режим = система подсказывает, но не блокирует; строгий — блокирует до исправления».

3. **Дождись подтверждения.** Мягкое включение меняет файлы состояния проектов (наклеивает этикетки истории, ставит движок). Перед каждым проектом с git создаётся бэкап-точка (тег), грязное дерево — стоп. Спроси пользователя «включаю мягкий режим на N безопасных проектах?».

4. **Применение** (по подтверждению):
   ```
   bash "${CLAUDE_PLUGIN_ROOT}/scripts/patch-projects.sh" --apply
   ```
   Безопасные проекты переходят в мягкий режим v8; проекты с UI-долгом остаются как есть.

5. **Проекты с UI-долгом — отдельный разговор.** У них задачи в «готово» помечены браузерным прогоном, но под старой меткой (не той, что ждёт жёсткий UI-контроль). Варианты пользователю: (а) одноразово перенести метку (честно — прогон был), (б) переснять скриншоты, (в) оставить проект на прежней версии. Это его решение.

## Один проект вместо всех

Для точечного перевода — `/upgrade-project`:
- `bash "${CLAUDE_PLUGIN_ROOT}/scripts/upgrade-project.sh" --dry-run <путь>` — предпросмотр одного проекта;
- `... --soft <путь>` — мягкое включение (подсказки);
- `... <путь>` (без флага) — строгий режим (полные блокировки), когда проект приведён в порядок.

## Граница честности

- Мягкий режим понижает до подсказок структурные v8-гейты (провенанс, logic-evidence, negative-gate, детализация). **UI-скриншоты и массовый внешний API остаются жёсткими** — это критичные инварианты, они не понижаются.
- Миграция истории честно помечает восстановленные этикетки как реконструированные (`origin=inference`, `source_ref.ref=retro-migration`) — не выдаёт их за живой источник.
- Идемпотентно: повторный запуск безопасен, уже-строгие проекты не разжалуются.