claude-code-orchestrator-kit 1.0.0

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

@@ -0,0 +1,339 @@
+---
+description: Remove a git worktree and optionally delete its branch
+---
+
+# Remove Git Worktree
+
+Безопасно удаляет git worktree и опционально удаляет связанную ветку.
+
+**Что делает команда:**
+- Проверяет статус worktree (есть ли uncommitted changes)
+- Удаляет worktree директорию
+- Опционально удаляет git ветку
+- Выполняет cleanup административных файлов
+
+**Аргументы:**
+- `<feature-name>` - название фичи/worktree (обязательно)
+- `[--force]` - принудительное удаление (опционально)
+- `[--delete-branch]` - удалить ветку после удаления worktree (опционально)
+
+**Примеры:**
+```bash
+/worktree-remove admin-panel
+/worktree-remove admin-panel --delete-branch
+/worktree-remove admin-panel --force
+/worktree-remove admin-panel --force --delete-branch
+```
+
+---
+
+## Your Task
+
+### Step 1: Получение аргументов
+
+Извлеки аргументы из запроса пользователя:
+- `FEATURE_NAME` - название фичи (обязательный)
+- `--force` - флаг принудительного удаления (опциональный)
+- `--delete-branch` - флаг удаления ветки (опциональный)
+
+**Валидация:**
+- FEATURE_NAME не должно быть пустым
+- Запроси подтверждение перед удалением
+
+---
+
+### Step 2: Проверка worktree
+
+1. **Получить список всех worktrees**
+   ```bash
+   git worktree list --porcelain
+   ```
+
+2. **Найти worktree по имени**
+   - Ищи путь содержащий `megacampus2-worktrees/FEATURE_NAME`
+   - Извлеки полный путь и название ветки
+
+3. **Проверить существование**
+   - Если worktree не найден → выведи ошибку и список доступных worktrees
+
+---
+
+### Step 3: Проверка состояния
+
+1. **Проверить статус worktree** (если не --force)
+   ```bash
+   cd /путь/к/worktree && git status --short
+   ```
+
+2. **Если есть изменения:**
+   - Покажи список изменений
+   - Спроси подтверждение у пользователя:
+     ```
+     ⚠️ В worktree есть незакоммиченные изменения!
+
+     Изменения:
+     [список файлов]
+
+     Варианты:
+     1. Commit и push изменения
+     2. Удалить с потерей изменений (--force)
+     3. Отменить удаление
+
+     Что делаем? (commit/force/cancel)
+     ```
+
+3. **Проверить, не является ли это основным worktree**
+   - Основной worktree удалять нельзя
+   - Если это main worktree → выведи ошибку
+
+---
+
+### Step 4: Удаление worktree
+
+1. **Удалить worktree**
+
+   Без --force:
+   ```bash
+   git worktree remove /путь/к/worktree
+   ```
+
+   С --force:
+   ```bash
+   git worktree remove --force /путь/к/worktree
+   ```
+
+2. **Проверить успешность удаления**
+   ```bash
+   git worktree list
+   ```
+
+---
+
+### Step 5: Удаление ветки (опционально)
+
+Если указан флаг `--delete-branch`:
+
+1. **Проверить, смержена ли ветка**
+   ```bash
+   git branch --merged main | grep "feature/FEATURE_NAME"
+   ```
+
+2. **Если ветка не смержена:**
+   - Спроси подтверждение:
+     ```
+     ⚠️ Ветка "feature/FEATURE_NAME" не смержена в main!
+
+     Это может привести к потере работы.
+
+     Варианты:
+     1. Удалить принудительно (-D)
+     2. Отменить удаление ветки
+     3. Сначала создать PR и смержить
+
+     Что делаем? (delete/cancel/merge)
+     ```
+
+3. **Удалить локальную ветку**
+
+   Если смержена:
+   ```bash
+   git branch -d feature/FEATURE_NAME
+   ```
+
+   Если не смержена (с подтверждением):
+   ```bash
+   git branch -D feature/FEATURE_NAME
+   ```
+
+4. **Удалить remote ветку** (если существует)
+   ```bash
+   git push origin --delete feature/FEATURE_NAME
+   ```
+
+---
+
+### Step 6: Cleanup
+
+1. **Выполнить prune**
+   ```bash
+   git worktree prune
+   ```
+
+2. **Проверить, удалена ли директория**
+   ```bash
+   ls -la ../megacampus2-worktrees/FEATURE_NAME 2>&1
+   ```
+
+   Если директория осталась:
+   ```bash
+   rm -rf ../megacampus2-worktrees/FEATURE_NAME
+   ```
+
+---
+
+### Step 7: Вывод информации
+
+После успешного удаления:
+
+```markdown
+✅ Worktree успешно удален!
+
+📁 **Удалено:**
+- Worktree: `/home/me/code/megacampus2-worktrees/FEATURE_NAME`
+- Ветка: `feature/FEATURE_NAME` [если был флаг --delete-branch]
+
+🔄 **Выполнено:**
+- ✅ Worktree directory удалена
+- ✅ Git административные файлы очищены
+- [✅ Локальная ветка удалена] [если --delete-branch]
+- [✅ Remote ветка удалена] [если --delete-branch и была remote]
+
+📋 **Оставшиеся worktrees:**
+[список из git worktree list]
+
+💡 **Полезные команды:**
+- `/worktree-list` - список всех worktrees
+- `/worktree-create <name>` - создать новый worktree
+- `/worktree-cleanup` - очистить устаревшие worktrees
+```
+
+---
+
+## Обработка ошибок
+
+**Если worktree не найден:**
+```markdown
+❌ Worktree "FEATURE_NAME" не найден!
+
+**Доступные worktrees:**
+[вывод git worktree list]
+
+Возможно вы имели в виду:
+- similar-name-1
+- similar-name-2
+
+Используйте:
+```bash
+/worktree-list  # для просмотра всех worktrees
+/worktree-remove <правильное-имя>
+```
+
+**Если это основной worktree:**
+```markdown
+❌ Нельзя удалить основной worktree!
+
+Основной worktree: `/home/me/code/megacampus2`
+
+Можно удалять только linked worktrees в:
+`/home/me/code/megacampus2-worktrees/`
+
+Доступные для удаления:
+[список linked worktrees]
+```
+
+**Если worktree заблокирован:**
+```markdown
+❌ Worktree заблокирован!
+
+Причина: [причина блокировки]
+
+Варианты:
+1. Разблокировать и удалить:
+   ```bash
+   git worktree unlock /путь/к/worktree
+   /worktree-remove FEATURE_NAME
+   ```
+
+2. Принудительное удаление:
+   ```bash
+   /worktree-remove FEATURE_NAME --force
+   ```
+```
+
+**Если есть незакоммиченные изменения (без --force):**
+```markdown
+❌ Worktree содержит незакоммиченные изменения!
+
+**Измененные файлы:**
+```
+M  src/file1.ts
+M  src/file2.ts
+?? src/file3.ts
+```
+
+**Варианты:**
+
+1. **Сохранить изменения:**
+   ```bash
+   cd ../megacampus2-worktrees/FEATURE_NAME
+   git add .
+   git commit -m "feat: описание изменений"
+   git push -u origin feature/FEATURE_NAME
+   cd /home/me/code/megacampus2
+   /worktree-remove FEATURE_NAME
+   ```
+
+2. **Удалить с потерей изменений:**
+   ```bash
+   /worktree-remove FEATURE_NAME --force
+   ```
+
+3. **Отменить операцию**
+
+Что выбираем? (save/force/cancel)
+```
+
+**Если ветка не смержена (при --delete-branch):**
+```markdown
+⚠️ Ветка не смержена в main!
+
+**Ветка:** `feature/FEATURE_NAME`
+**Коммитов впереди main:** N
+
+**Опасность:** Удаление не смерженной ветки приведет к потере работы!
+
+**Рекомендации:**
+
+1. **Создать и смержить PR:**
+   ```bash
+   # В worktree (пока не удален)
+   cd ../megacampus2-worktrees/FEATURE_NAME
+   git push -u origin feature/FEATURE_NAME
+   gh pr create --title "feat: описание" --body "Описание PR"
+   ```
+
+   Затем смержить на GitHub и удалить worktree.
+
+2. **Удалить без сохранения (опасно!):**
+   ```bash
+   /worktree-remove FEATURE_NAME --force --delete-branch
+   ```
+
+3. **Удалить worktree, но сохранить ветку:**
+   ```bash
+   /worktree-remove FEATURE_NAME
+   # Ветка останется, можно вернуться позже
+   ```
+
+Что делаем? (pr/force/keep-branch)
+```
+
+---
+
+## Интерактивные сценарии
+
+### Сценарий 1: Чистое удаление
+```markdown
+Пользователь: /worktree-remove admin-panel
+
+Worktree чистый (нет изменений) → удаляем сразу:
+
+✅ Worktree "admin-panel" удален
+ℹ️ Ветка "feature/admin-panel" сохранена (используйте --delete-branch для удаления)
+```
+
+### Сценарий 2: С изменениями
+```markdown
+Пользователь: /worktree-remove admin-panel
+
+⚠️ Есть изменения → запрос подтверждения:

package/.claude/schemas/base-plan.schema.json

@@ -0,0 +1,82 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://megacampus2.local/schemas/base-plan.schema.json",
+  "title": "Base Plan Schema",
+  "description": "Base schema for all orchestrator plan files",
+  "type": "object",
+  "required": ["workflow", "phase", "config", "validation"],
+  "properties": {
+    "workflow": {
+      "type": "string",
+      "description": "Name of the workflow (e.g., 'bug-management', 'security-audit')",
+      "minLength": 1
+    },
+    "phase": {
+      "type": "string",
+      "description": "Current phase identifier",
+      "minLength": 1
+    },
+    "phaseNumber": {
+      "type": "integer",
+      "description": "Numeric phase identifier for sequencing",
+      "minimum": 1
+    },
+    "config": {
+      "type": "object",
+      "description": "Phase-specific configuration",
+      "additionalProperties": true
+    },
+    "validation": {
+      "type": "object",
+      "description": "Validation criteria for this phase",
+      "required": ["required"],
+      "properties": {
+        "required": {
+          "type": "array",
+          "description": "Blocking validation criteria that must pass",
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1
+        },
+        "optional": {
+          "type": "array",
+          "description": "Non-blocking validation criteria (warnings only)",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "nextAgent": {
+      "type": "string",
+      "description": "Name of the next agent to invoke (worker name)",
+      "minLength": 1
+    },
+    "timestamp": {
+      "type": "string",
+      "description": "ISO-8601 timestamp when plan was created",
+      "format": "date-time"
+    },
+    "metadata": {
+      "type": "object",
+      "description": "Additional metadata",
+      "properties": {
+        "createdBy": {
+          "type": "string",
+          "description": "Agent that created this plan"
+        },
+        "iteration": {
+          "type": "integer",
+          "description": "Iteration number for iterative workflows",
+          "minimum": 1
+        },
+        "maxIterations": {
+          "type": "integer",
+          "description": "Maximum iterations allowed",
+          "minimum": 1
+        }
+      }
+    }
+  }
+}

package/.claude/schemas/bug-plan.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://megacampus2.local/schemas/bug-plan.schema.json",
+  "title": "Bug Management Plan Schema",
+  "description": "Schema for bug detection and fixing workflow plan files",
+  "allOf": [
+    {
+      "$ref": "./base-plan.schema.json"
+    }
+  ],
+  "properties": {
+    "workflow": {
+      "const": "bug-management"
+    },
+    "phase": {
+      "enum": ["detection", "fixing", "verification"]
+    },
+    "config": {
+      "type": "object",
+      "required": ["priority"],
+      "properties": {
+        "priority": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low", "all"],
+          "description": "Bug priority level to process in this phase"
+        },
+        "categories": {
+          "type": "array",
+          "description": "Specific bug categories to focus on",
+          "items": {
+            "type": "string",
+            "enum": ["security", "performance", "type-errors", "runtime-errors", "dead-code", "debug-code"]
+          }
+        },
+        "maxBugsPerRun": {
+          "type": "integer",
+          "description": "Maximum bugs to fix in single run",
+          "minimum": 1,
+          "default": 50
+        },
+        "verifyOnly": {
+          "type": "boolean",
+          "description": "Run verification scan only (no fixes)",
+          "default": false
+        }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["report-exists", "type-check", "build", "validation-passed"]
+          }
+        },
+        "optional": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["tests", "lint", "no-new-bugs"]
+          }
+        }
+      }
+    },
+    "nextAgent": {
+      "enum": ["bug-hunter", "bug-fixer"]
+    }
+  }
+}

package/.claude/schemas/dead-code-plan.schema.json

@@ -0,0 +1,71 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://megacampus2.local/schemas/dead-code-plan.schema.json",
+  "title": "Dead Code Cleanup Plan Schema",
+  "description": "Schema for dead code detection and removal workflow plan files",
+  "allOf": [
+    {
+      "$ref": "./base-plan.schema.json"
+    }
+  ],
+  "properties": {
+    "workflow": {
+      "const": "dead-code-cleanup"
+    },
+    "phase": {
+      "enum": ["detection", "removal", "verification"]
+    },
+    "config": {
+      "type": "object",
+      "required": ["type"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low", "all"],
+          "description": "Dead code type/priority to process"
+        },
+        "categories": {
+          "type": "array",
+          "description": "Specific dead code categories",
+          "items": {
+            "type": "string",
+            "enum": ["unused-exports", "unused-imports", "unreachable-code", "commented-code", "debug-code"]
+          }
+        },
+        "maxItemsPerRun": {
+          "type": "integer",
+          "description": "Maximum items to remove in single run",
+          "minimum": 1,
+          "default": 100
+        },
+        "safeMode": {
+          "type": "boolean",
+          "description": "Only remove high-confidence dead code",
+          "default": true
+        }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["report-exists", "type-check", "build", "validation-passed"]
+          }
+        },
+        "optional": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["tests", "lint", "bundle-size-reduced"]
+          }
+        }
+      }
+    },
+    "nextAgent": {
+      "enum": ["dead-code-hunter", "dead-code-remover"]
+    }
+  }
+}

package/.claude/schemas/dependency-plan.schema.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://megacampus2.local/schemas/dependency-plan.schema.json",
+  "title": "Dependency Management Plan Schema",
+  "description": "Schema for dependency audit and update workflow plan files",
+  "allOf": [
+    {
+      "$ref": "./base-plan.schema.json"
+    }
+  ],
+  "properties": {
+    "workflow": {
+      "const": "dependency-management"
+    },
+    "phase": {
+      "enum": ["audit", "update", "verification"]
+    },
+    "config": {
+      "type": "object",
+      "required": ["category"],
+      "properties": {
+        "category": {
+          "type": "string",
+          "enum": ["security", "unused", "outdated", "all"],
+          "description": "Dependency category to process"
+        },
+        "severity": {
+          "type": "string",
+          "enum": ["critical", "high", "medium", "low", "all"],
+          "description": "For security category: vulnerability severity"
+        },
+        "maxUpdatesPerRun": {
+          "type": "integer",
+          "description": "Maximum dependencies to update in single run",
+          "minimum": 1,
+          "default": 10
+        },
+        "updateStrategy": {
+          "type": "string",
+          "enum": ["one-at-a-time", "batch-compatible", "all"],
+          "description": "How to batch updates",
+          "default": "one-at-a-time"
+        },
+        "skipTests": {
+          "type": "boolean",
+          "description": "Skip test execution after updates (not recommended)",
+          "default": false
+        }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["report-exists", "type-check", "build", "validation-passed", "lockfile-valid"]
+          }
+        },
+        "optional": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["tests", "lint", "no-security-vulns"]
+          }
+        }
+      }
+    },
+    "nextAgent": {
+      "enum": ["dependency-auditor", "dependency-updater"]
+    }
+  }
+}