claude-code-orchestrator-kit 1.0.0

package/.claude/commands/translate-doc.md

@@ -0,0 +1,95 @@
+---
+description: Translate documentation file from English to Russian
+allowed-tools: Read, Write
+---
+
+# /translate-doc command
+
+## Syntax
+
+/translate-doc {file_path}
+
+## Your task
+
+You are translating technical documentation from English to Russian for developers.
+
+### Step 1: Read Source File
+
+Read the English documentation file specified by the user:
+- Use Read tool with the provided file_path
+- Verify file exists and is readable
+- If file not found, report error and stop
+
+### Step 2: Translate to Russian
+
+Translate the content while preserving structure and accuracy:
+
+**Preserve**:
+- Markdown formatting (headers, lists, tables, code blocks)
+- Code blocks UNCHANGED (do not translate code)
+- Technical terms accuracy (orchestrator, worker, quality gate)
+- Links and URLs UNCHANGED
+- File paths and commands UNCHANGED
+- YAML frontmatter (if present)
+- JSON examples UNCHANGED
+
+**Translate**:
+- All text content (paragraphs, descriptions)
+- Headers and titles
+- List items (except code)
+- Table content (except code columns)
+
+**Translation Guidelines**:
+- Use professional technical Russian
+- Maintain consistency with existing Russian docs
+- Keep Claude Code terminology: agent, orchestrator, worker, quality gate
+- Preserve tone and style (formal technical documentation)
+
+### Step 3: Add Translation Header
+
+At the top of the translated document (after YAML frontmatter if present), add:
+
+> Warning: Automatic translation
+> Translated from English: {source_file_path}
+> Translation date: {YYYY-MM-DD}
+> The original may contain more up-to-date information. In case of discrepancies, use the English version.
+
+### Step 4: Save Translated File
+
+Save the translated content:
+- Generate filename: {original_filename}.ru.md
+- Save in the same directory as the source file
+- Use Write tool with full path
+
+Example:
+- Source: docs/Agents Ecosystem/ARCHITECTURE.md
+- Output: docs/Agents Ecosystem/ARCHITECTURE.ru.md
+
+### Step 5: Report Completion
+
+Inform the user:
+
+Translation complete
+
+Source: {source_file_path}
+Output: {output_file_path}
+
+Translation includes:
+- N sections translated
+- M code blocks preserved
+- Translation header added
+
+Note: Review the translation for technical accuracy, especially domain-specific terms.
+
+## Examples
+
+### Example 1: Basic usage
+
+User: /translate-doc docs/Agents Ecosystem/ARCHITECTURE.md
+Assistant: Translating document...
+Output: docs/Agents Ecosystem/ARCHITECTURE.ru.md created
+
+### Example 2: Error handling
+
+User: /translate-doc docs/nonexistent.md
+Assistant: Error: File not found at docs/nonexistent.md

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

@@ -0,0 +1,382 @@
+---
+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 когда возможно