claude-code-orchestrator-kit 1.4.1 → 1.4.16

package/.claude/commands/worktree-cleanup.md

@@ -1,382 +0,0 @@
----
-description: Clean up stale worktree administrative files and optionally remove empty directories
----
-
-# Cleanup Git Worktrees
-
-Очищает устаревшие административные файлы git worktrees и опционально удаляет пустые директории.
-
-**Что делает команда:**
-- Находит и удаляет административные файлы для несуществующих worktrees
-- Опционально удаляет пустые директории в `megacampus2-worktrees/`
-- Проверяет целостность worktrees
-- Восстанавливает поврежденные worktrees (если возможно)
-
-**Аргументы:**
-- `[--dry-run]` - показать что будет удалено без удаления (опционально)
-- `[--remove-dirs]` - удалить пустые директории (опционально)
-
-**Примеры:**
-```bash
-/worktree-cleanup
-/worktree-cleanup --dry-run
-/worktree-cleanup --remove-dirs
-/worktree-cleanup --dry-run --remove-dirs
-```
-
----
-
-## Your Task
-
-### Step 1: Получение аргументов
-
-Извлеки флаги из запроса пользователя:
-- `--dry-run` - только показать, не удалять (опциональный)
-- `--remove-dirs` - удалить пустые директории (опциональный)
-
----
-
-### Step 2: Анализ текущего состояния
-
-1. **Получить список worktrees**
-   ```bash
-   git worktree list --porcelain
-   ```
-
-2. **Проверить директорию worktrees**
-   ```bash
-   ls -la ../megacampus2-worktrees/ 2>/dev/null
-   ```
-
-3. **Найти orphaned worktrees**
-   - Директории в `megacampus2-worktrees/`, которых нет в `git worktree list`
-   - Worktrees в `git worktree list`, директории которых не существуют
-
----
-
-### Step 3: Поиск проблем
-
-**Типы проблем:**
-
-1. **Prunable worktrees** - административные файлы для удаленных worktrees
-2. **Orphaned directories** - директории без git worktree записей
-3. **Missing directories** - worktree записи без директорий
-4. **Empty directories** - пустые папки в megacampus2-worktrees/
-
-Для каждой проблемы собери информацию.
-
----
-
-### Step 4: Git Worktree Prune
-
-1. **Проверить что будет удалено** (если --dry-run)
-   ```bash
-   git worktree prune --dry-run --verbose
-   ```
-
-2. **Выполнить cleanup** (если не --dry-run)
-   ```bash
-   git worktree prune --verbose
-   ```
-
----
-
-### Step 5: Удаление orphaned директорий
-
-Для каждой orphaned директории:
-
-1. **Проверить содержимое**
-   ```bash
-   ls -la ../megacampus2-worktrees/DIRNAME/
-   ```
-
-2. **Проверить git статус**
-   ```bash
-   cd ../megacampus2-worktrees/DIRNAME && git status 2>&1
-   ```
-
-3. **Если директория валидна, но не зарегистрирована:**
-   - Попытаться восстановить через `git worktree repair`
-   ```bash
-   git worktree repair ../megacampus2-worktrees/DIRNAME
-   ```
-
-4. **Если директория невалидна или пустая:**
-   - Если --dry-run: показать что будет удалено
-   - Если --remove-dirs: удалить директорию
-   ```bash
-   rm -rf ../megacampus2-worktrees/DIRNAME
-   ```
-
----
-
-### Step 6: Проверка целостности
-
-1. **Проверить все зарегистрированные worktrees**
-   ```bash
-   git worktree list --porcelain
-   ```
-
-2. **Для worktrees с missing directories:**
-   - Показать предупреждение
-   - Предложить удалить через `git worktree remove`
-
----
-
-### Step 7: Вывод отчета
-
-**Dry-run режим:**
-```markdown
-# Worktree Cleanup Report (DRY RUN)
-
-## Что будет выполнено:
-
-### Git Worktree Prune
-- 🗑️ Будет удалено административных записей: N
-  - worktree-1: /путь/к/worktree-1 (директория не существует)
-  - worktree-2: /путь/к/worktree-2 (директория удалена)
-
-### Orphaned Directories [если --remove-dirs]
-- 🗑️ Будет удалено директорий: N
-  - ../megacampus2-worktrees/old-feature (не зарегистрирован в git)
-  - ../megacampus2-worktrees/test (пустая директория)
-
-### Восстановимые Worktrees
-- 🔧 Будет восстановлено: N
-  - ../megacampus2-worktrees/recoverable-feature (можно восстановить через repair)
-
----
-
-💡 **Для выполнения cleanup:**
-```bash
-/worktree-cleanup  # выполнить prune
-/worktree-cleanup --remove-dirs  # выполнить prune + удалить директории
-```
-```
-
-**Обычный режим:**
-```markdown
-# Worktree Cleanup Report
-
-## ✅ Выполнено
-
-### Git Worktree Prune
-- ✅ Удалено административных записей: N
-  - worktree-1: /путь/к/worktree-1
-  - worktree-2: /путь/к/worktree-2
-
-### Orphaned Directories [если --remove-dirs]
-- ✅ Удалено директорий: N
-  - ../megacampus2-worktrees/old-feature (N MB освобождено)
-  - ../megacampus2-worktrees/test
-
-### Восстановленные Worktrees
-- ✅ Восстановлено: N
-  - ../megacampus2-worktrees/recoverable-feature
-
----
-
-## 📊 Текущее состояние
-
-**Активные worktrees:** N
-```
-[вывод git worktree list]
-```
-
-**Директории в megacampus2-worktrees/:** N
-```
-[список директорий]
-```
-
-**Все соответствует зарегистрированным worktrees:** ✅
-
----
-
-## 💾 Освобождено места
-
-- Административные файлы: ~X KB
-- Директории: ~X MB [если --remove-dirs]
-- Всего: ~X MB
-
----
-
-## 💡 Рекомендации
-
-[Если нашлись проблемы, которые не были исправлены автоматически]
-
-**Missing directories:**
-- worktree-name: /путь/к/worktree
-
-  Удалить:
-  ```bash
-  git worktree remove worktree-name
-  ```
-
-**Подозрительные директории:** [если не был --remove-dirs]
-- ../megacampus2-worktrees/suspicious-dir
-
-  Проверить и удалить вручную:
-  ```bash
-  cd ../megacampus2-worktrees/suspicious-dir
-  git status  # проверить содержимое
-  cd ../../megacampus2
-  /worktree-remove suspicious-dir  # если не нужен
-  ```
-```
-
-**Если ничего не найдено:**
-```markdown
-# Worktree Cleanup Report
-
-✨ **Все чисто!**
-
-Не найдено проблем с worktrees:
-- ✅ Нет устаревших административных файлов
-- ✅ Нет orphaned директорий
-- ✅ Все worktrees валидны
-- ✅ Все директории соответствуют зарегистрированным worktrees
-
----
-
-## 📊 Текущее состояние
-
-**Активные worktrees:** N
-```
-[вывод git worktree list]
-```
-
-**Директории в megacampus2-worktrees/:** N (все валидны)
-
----
-
-💡 **Полезные команды:**
-- `/worktree-list` - список всех worktrees
-- `/worktree-create <name>` - создать новый worktree
-- `/worktree-remove <name>` - удалить worktree
-```
-
----
-
-## Обработка ошибок
-
-**Если директория megacampus2-worktrees не существует:**
-```markdown
-ℹ️ Директория worktrees не существует
-
-Путь: `/home/me/code/megacampus2-worktrees/`
-
-Это нормально, если вы еще не создавали worktrees.
-
-**Создать первый worktree:**
-```bash
-/worktree-create <feature-name>
-```
-```
-
-**Если нет прав доступа:**
-```markdown
-❌ Нет прав доступа к директории
-
-Путь: `/home/me/code/megacampus2-worktrees/`
-
-Проверьте права:
-```bash
-ls -la ../megacampus2-worktrees/
-chmod -R u+rwx ../megacampus2-worktrees/
-```
-```
-
-**Если git worktree repair не сработал:**
-```markdown
-⚠️ Не удалось восстановить worktree автоматически
-
-Worktree: `../megacampus2-worktrees/DIRNAME`
-
-**Варианты:**
-
-1. **Удалить и пересоздать:**
-   ```bash
-   rm -rf ../megacampus2-worktrees/DIRNAME
-   /worktree-create DIRNAME
-   ```
-
-2. **Вручную удалить запись:**
-   ```bash
-   git worktree remove --force DIRNAME
-   ```
-
-3. **Проверить содержимое:**
-   ```bash
-   cd ../megacampus2-worktrees/DIRNAME
-   git status
-   # Сохранить важные изменения, затем удалить
-   ```
-```
-
----
-
-## Детальная информация
-
-### Что делает git worktree prune?
-
-Git worktree prune удаляет административные файлы в `.git/worktrees/` для worktrees, директории которых больше не существуют.
-
-**Когда это происходит:**
-- Директория worktree была удалена вручную (rm -rf)
-- Директория была перемещена
-- Файловая система была очищена
-
-**Безопасность:**
-- ✅ Безопасно - удаляет только метаданные
-- ✅ Не трогает существующие worktrees
-- ✅ Не удаляет коммиты или ветки
-
-### Что такое orphaned directories?
-
-Orphaned directories - это директории в `megacampus2-worktrees/`, которые:
-- Не зарегистрированы в `git worktree list`
-- Могут содержать старый код
-- Занимают место на диске
-
-**Причины появления:**
-- Ручное удаление worktree без `git worktree remove`
-- Прерванное создание worktree
-- Копирование директорий вручную
-
-**Как cleanup обрабатывает:**
-1. Проверяет валидность (есть ли .git)
-2. Пытается восстановить через `git worktree repair`
-3. Если не удалось и указан `--remove-dirs` → удаляет
-
----
-
-## Автоматизация
-
-Рекомендуется запускать cleanup периодически:
-
-```bash
-# Проверить состояние
-/worktree-cleanup --dry-run
-
-# Выполнить cleanup
-/worktree-cleanup
-
-# Полная очистка (включая директории)
-/worktree-cleanup --remove-dirs
-```
-
-**Когда запускать:**
-- После удаления worktrees вручную
-- При проблемах с git worktree commands
-- Периодически (раз в неделю/месяц)
-- Перед созданием новых worktrees
-
----
-
-## Примечания
-
-- Команда безопасна и не удаляет коммиты или важные данные
-- --dry-run позволяет проверить что будет удалено
-- --remove-dirs удаляет только невалидные/пустые директории
-- Всегда делает backup проверку перед удалением
-- Автоматически пытается восстановить worktrees когда возможно

package/.claude/commands/worktree-create.md

@@ -1,287 +0,0 @@
----
-description: Create a new git worktree for parallel feature development
----
-
-# Create Git Worktree
-
-Создает новый git worktree для параллельной разработки фичи в изолированной директории.
-
-**Что делает команда:**
-- Создает папку `megacampus2-worktrees` рядом с основным проектом (если не существует)
-- Создает новую ветку от текущей (main/develop)
-- Создает worktree в отдельной директории
-- Копирует файлы из `.gitignore` согласно `.worktree-sync.json` (env, config, vscode и др.)
-- Выводит инструкции по работе с worktree
-
-**Аргументы:**
-- `<feature-name>` - название фичи (обязательно)
-- `[base-branch]` - ветка-основа (опционально, по умолчанию текущая)
-
-**Примеры:**
-```bash
-/worktree-create admin-panel
-/worktree-create payment-system main
-/worktree-create user-profile develop
-```
-
----
-
-## Your Task
-
-### Step 1: Получение аргументов
-
-Извлеки аргументы из запроса пользователя:
-- `FEATURE_NAME` - название фичи (обязательный)
-- `BASE_BRANCH` - ветка-основа (опциональный, по умолчанию текущая)
-
-**Валидация:**
-- FEATURE_NAME не должно быть пустым
-- FEATURE_NAME должно содержать только буквы, цифры, дефисы
-- Запроси подтверждение у пользователя перед созданием
-
----
-
-### Step 2: Проверка окружения
-
-Выполни проверки:
-
-1. **Проверить текущую директорию**
-   ```bash
-   pwd
-   # Должно быть: /home/me/code/megacampus2
-   ```
-
-2. **Проверить git статус**
-   ```bash
-   git status
-   # Убедись, что нет uncommitted changes или предупреди пользователя
-   ```
-
-3. **Получить текущую ветку** (если BASE_BRANCH не указан)
-   ```bash
-   git branch --show-current
-   ```
-
-4. **Проверить, существует ли worktrees директория**
-   ```bash
-   ls -la ../megacampus2-worktrees 2>/dev/null || echo "NOT_EXISTS"
-   ```
-
----
-
-### Step 3: Создание структуры
-
-1. **Создать worktrees директорию** (если не существует)
-   ```bash
-   mkdir -p ../megacampus2-worktrees
-   ```
-
-2. **Проверить, не существует ли уже worktree с таким именем**
-   ```bash
-   git worktree list
-   # Проверь, нет ли уже ../megacampus2-worktrees/FEATURE_NAME
-   ```
-
-3. **Создать новый worktree**
-   ```bash
-   git worktree add ../megacampus2-worktrees/FEATURE_NAME -b feature/FEATURE_NAME BASE_BRANCH
-   ```
-
-   Где:
-   - `../megacampus2-worktrees/FEATURE_NAME` - путь к новой директории
-   - `-b feature/FEATURE_NAME` - создать новую ветку с префиксом `feature/`
-   - `BASE_BRANCH` - ветка-основа (main, develop или текущая)
-
----
-
-### Step 4: Синхронизация файлов из .gitignore
-
-1. **Прочитать конфигурацию синхронизации**
-   ```bash
-   # Проверить существование .worktree-sync.json
-   if [ -f .worktree-sync.json ]; then
-     echo "✅ Найден .worktree-sync.json"
-   else
-     echo "⚠️ .worktree-sync.json не найден, пропускаем синхронизацию"
-   fi
-   ```
-
-2. **Извлечь списки для синхронизации**
-
-   Используй jq или прямое чтение JSON для получения:
-   - `sync.files` - отдельные файлы
-   - `sync.directories` - директории целиком
-   - `sync.patterns` - glob паттерны
-
-3. **Скопировать файлы из sync.files**
-   ```bash
-   # Для каждого файла в sync.files
-   for file in .env .env.local .env.development .env.test .env.production .mcp.json .mcp.local.json; do
-     if [ -f "$file" ]; then
-       cp "$file" "../megacampus2-worktrees/FEATURE_NAME/$file"
-       echo "✅ Скопирован: $file"
-     fi
-   done
-   ```
-
-4. **Скопировать директории из sync.directories**
-   ```bash
-   # Для каждой директории в sync.directories
-   for dir in .vscode; do
-     if [ -d "$dir" ]; then
-       cp -r "$dir" "../megacampus2-worktrees/FEATURE_NAME/$dir"
-       echo "✅ Скопирована директория: $dir"
-     fi
-   done
-   ```
-
-5. **Скопировать файлы по паттернам из sync.patterns**
-   ```bash
-   # packages/*/.env
-   find packages -maxdepth 2 -name ".env" -o -name ".env.local" | while read file; do
-     if [ -f "$file" ]; then
-       # Создать директорию если нужно
-       mkdir -p "../megacampus2-worktrees/FEATURE_NAME/$(dirname "$file")"
-       cp "$file" "../megacampus2-worktrees/FEATURE_NAME/$file"
-       echo "✅ Скопирован: $file"
-     fi
-   done
-
-   # courseai-next/.env.local
-   if [ -f courseai-next/.env.local ]; then
-     mkdir -p "../megacampus2-worktrees/FEATURE_NAME/courseai-next"
-     cp courseai-next/.env.local "../megacampus2-worktrees/FEATURE_NAME/courseai-next/.env.local"
-     echo "✅ Скопирован: courseai-next/.env.local"
-   fi
-
-   # services/*/.env
-   find services -maxdepth 2 -name ".env" | while read file; do
-     if [ -f "$file" ]; then
-       mkdir -p "../megacampus2-worktrees/FEATURE_NAME/$(dirname "$file")"
-       cp "$file" "../megacampus2-worktrees/FEATURE_NAME/$file"
-       echo "✅ Скопирован: $file"
-     fi
-   done
-   ```
-
-6. **Вывести отчет о синхронизации**
-   ```bash
-   echo ""
-   echo "📦 Синхронизировано файлов: N"
-   echo "📁 Синхронизировано директорий: N"
-   ```
-
-2. **Проверить созданный worktree**
-   ```bash
-   git worktree list
-   ```
-
----
-
-### Step 5: Вывод информации
-
-После успешного создания выведи пользователю:
-
-```markdown
-✅ Worktree успешно создан!
-
-📁 **Расположение:**
-- Основной проект: `/home/me/code/megacampus2`
-- Новый worktree: `/home/me/code/megacampus2-worktrees/FEATURE_NAME`
-
-🌿 **Ветка:**
-- Название: `feature/FEATURE_NAME`
-- Основа: `BASE_BRANCH`
-
-📦 **Синхронизировано:**
-- Файлов: N (.env, .mcp.json и др.)
-- Директорий: N (.vscode и др.)
-- Конфигурация: `.worktree-sync.json`
-
-📋 **Следующие шаги:**
-
-1. Открой новый worktree в отдельном окне IDE:
-   ```bash
-   cd ../megacampus2-worktrees/FEATURE_NAME
-   code .  # или другой редактор
-   ```
-
-2. Начни работу над фичей в новой ветке
-
-3. Когда закончишь:
-   ```bash
-   git add .
-   git commit -m "feat: описание изменений"
-   git push -u origin feature/FEATURE_NAME
-   ```
-
-4. Создай Pull Request на GitHub
-
-5. После мерджа удали worktree:
-   ```bash
-   /worktree-remove FEATURE_NAME
-   ```
-
-💡 **Полезные команды:**
-- `/worktree-list` - список всех worktrees
-- `/worktree-remove FEATURE_NAME` - удалить worktree
-- `/worktree-cleanup` - очистить устаревшие worktrees
-
-⚠️ **Важно:**
-- Каждый worktree должен быть на своей ветке
-- Нельзя checkout одну ветку в разных worktrees
-- Основной проект остается на своей ветке
-```
-
----
-
-## Обработка ошибок
-
-**Если worktree уже существует:**
-```
-❌ Worktree с именем "FEATURE_NAME" уже существует!
-
-Существующие worktrees:
-[вывод git worktree list]
-
-Варианты:
-1. Используй другое имя: /worktree-create FEATURE_NAME-v2
-2. Удали существующий: /worktree-remove FEATURE_NAME
-3. Используй существующий worktree
-```
-
-**Если ветка уже существует:**
-```
-❌ Ветка "feature/FEATURE_NAME" уже существует!
-
-Варианты:
-1. Checkout существующей ветки:
-   git worktree add ../megacampus2-worktrees/FEATURE_NAME feature/FEATURE_NAME
-
-2. Используй другое имя ветки
-3. Удали старую ветку: git branch -d feature/FEATURE_NAME
-```
-
-**Если есть uncommitted changes:**
-```
-⚠️ У тебя есть незакоммиченные изменения!
-
-git status:
-[вывод]
-
-Рекомендация:
-1. Commit изменения: git commit -am "WIP"
-2. Или stash: git stash
-3. Или продолжить создание worktree (безопасно, изменения останутся в основном worktree)
-
-Продолжить? (yes/no)
-```
-
----
-
-## Примечания
-
-- Worktrees используют один `.git` репозиторий → экономия места
-- Можно работать над несколькими фичами параллельно
-- Идеально подходит для AI-разработки с Claude Code
-- После создания worktree можно открыть новое окно Claude Code в новой директории