claude-code-orchestrator-kit 1.4.0 → 1.4.1

package/.claude/commands/speckit.taskstoissues.md

@@ -1,6 +1,5 @@
 ---
 description: Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts.
-tools: ['github/github-mcp-server/issue_write']
 scripts:
   sh: .specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks
   ps: .specify/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks
@@ -18,18 +17,109 @@ You **MUST** consider the user input before proceeding (if not empty).
 
 1. Run `.specify/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
 
-2. From the executed script, extract the path to **tasks**.
+2. From the executed script, extract the path to **tasks.md**.
 
-3. Get the Git remote by running:
+3. **Verify GitHub remote**:
 
 ```bash
 git config --get remote.origin.url
 ```
 
 > [!CAUTION]
-> ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL
+> ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL (contains `github.com`)
 
-4. For each task in the list, use the GitHub MCP server to create a new issue in the repository that is representative of the Git remote.
+4. **Check `gh` CLI availability**:
+
+```bash
+gh --version
+```
+
+If `gh` is not installed, inform the user:
+```
+GitHub CLI (gh) is not installed. Install it:
+- macOS: brew install gh
+- Ubuntu: sudo apt install gh
+- Windows: winget install GitHub.cli
+
+Then authenticate: gh auth login
+```
+
+5. **Verify authentication**:
+
+```bash
+gh auth status
+```
+
+If not authenticated, prompt user to run `gh auth login`.
+
+6. **Parse tasks.md** and extract all incomplete tasks:
+   - Tasks matching `- [ ] T### ...` pattern
+   - Extract: Task ID, description, phase, parallel marker [P], user story [US#]
+
+7. **For each task, create a GitHub issue** using `gh` CLI:
+
+```bash
+gh issue create \
+  --title "T001: Create project structure" \
+  --body "## Task Details
+
+**ID**: T001
+**Phase**: Setup
+**Parallel**: No
+**User Story**: N/A
+
+### Description
+Create project structure per implementation plan
+
+### Acceptance Criteria
+- [ ] Task completed as specified in tasks.md
+
+---
+*Generated from tasks.md by /speckit.taskstoissues*" \
+  --label "speckit"
+```
+
+**Formatting rules**:
+- Title: `T###: <short description>`
+- Body: Task details, phase, parallel info, acceptance criteria
+- Label: `speckit` (create if doesn't exist)
+- Optional labels based on phase: `setup`, `foundational`, `user-story`, `polish`
+
+8. **Create labels if needed** (first run only):
+
+```bash
+gh label create speckit --description "Generated from spec-kit tasks" --color "0052CC" 2>/dev/null || true
+gh label create setup --description "Setup phase task" --color "C5DEF5" 2>/dev/null || true
+gh label create user-story --description "User story implementation" --color "D4C5F9" 2>/dev/null || true
+```
+
+9. **Report results**:
+   - Number of issues created
+   - Links to created issues
+   - Any errors encountered
 
 > [!CAUTION]
 > UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL
+
+## Options
+
+User can specify in `$ARGUMENTS`:
+- `--dry-run` — показать какие issues будут созданы, но не создавать
+- `--phase N` — создать issues только для Phase N
+- `--limit N` — создать только первые N issues
+
+## Examples
+
+```bash
+# Создать issues для всех задач
+/speckit.taskstoissues
+
+# Только показать что будет создано
+/speckit.taskstoissues --dry-run
+
+# Только Phase 1 (Setup)
+/speckit.taskstoissues --phase 1
+
+# Первые 5 задач
+/speckit.taskstoissues --limit 5
+```

package/docs/{SPECKIT-GUIDE.md → COMMANDS-GUIDE.md}

@@ -1,8 +1,26 @@
-# Spec-Kit: Руководство по использованию
+# Claude Code Orchestrator Kit: Руководство по командам
 
-> Версия: v0.0.90 + DeksdenFlow расширения
+> Версия: v1.4.0
 
-Spec-Kit — это набор команд для **спецификационно-ориентированной разработки** (Spec-Driven Development). Позволяет структурированно описывать требования, планировать реализацию и выполнять задачи через агентов.
+Полный набор slash-команд для разработки с Claude Code: от спецификации до релиза.
+
+---
+
+## Обзор команд
+
+| Группа | Команды | Назначение |
+|--------|---------|------------|
+| **Spec-Kit** | `/speckit.*` (9 команд) | Спецификационно-ориентированная разработка |
+| **Health** | `/health-*` (6 команд) | Анализ и исправление качества кода |
+| **Worktree** | `/worktree-*` (4 команды) | Параллельная разработка в git worktrees |
+| **Release** | `/push` | Автоматизация релизов |
+| **Utility** | `/translate-doc` | Перевод документации |
+
+---
+
+# Spec-Kit
+
+Spec-Kit — набор команд для **спецификационно-ориентированной разработки** (Spec-Driven Development). Позволяет структурированно описывать требования, планировать реализацию и выполнять задачи через агентов.
 
 ---
 
@@ -251,13 +269,22 @@ Constitution определяет:
 
 **Использование**:
 ```bash
-/speckit.taskstoissues
+/speckit.taskstoissues                # все задачи
+/speckit.taskstoissues --dry-run      # только показать
+/speckit.taskstoissues --phase 1      # только Phase 1
+/speckit.taskstoissues --limit 5      # первые 5 задач
 ```
 
 **Требования**:
-- GitHub MCP server должен быть настроен
+- `gh` CLI установлен (`brew install gh` / `apt install gh`)
+- Авторизация: `gh auth login`
 - Remote должен быть GitHub URL
 
+**Что создаёт**:
+- Issue для каждой задачи из tasks.md
+- Labels: `speckit`, `setup`, `user-story`
+- Форматированное описание с metadata
+
 ---
 
 ## Структура проекта
@@ -409,7 +436,227 @@ mcp__context7__get-library-docs → получить docs по теме
 
 ---
 
+# Health Commands
+
+Команды для автоматического анализа и исправления качества кода.
+
+## `/health-bugs` — Поиск и исправление багов
+
+**Что делает**: Полный цикл обнаружения и исправления багов.
+
+```bash
+/health-bugs
+```
+
+**Workflow**:
+1. Сканирование кода на баги (все приоритеты)
+2. Исправление по стадиям: critical → high → medium → low
+3. Quality gates после каждой стадии
+4. Верификация
+5. До 3 итераций если проблемы остаются
+
+---
+
+## `/health-security` — Анализ безопасности
+
+**Что делает**: Обнаружение и исправление уязвимостей.
+
+```bash
+/health-security
+```
+
+**Что проверяет**:
+- SQL injection, XSS
+- Проблемы аутентификации
+- Hardcoded secrets
+- RLS policies (Supabase)
+- OWASP Top 10
+
+---
+
+## `/health-deps` — Управление зависимостями
+
+**Что делает**: Аудит и обновление зависимостей.
+
+```bash
+/health-deps
+```
+
+**Что делает**:
+- Поиск устаревших пакетов
+- Обнаружение уязвимостей (npm audit)
+- Обновление по одному пакету с валидацией
+- Откат при ошибках
+
+---
+
+## `/health-cleanup` — Очистка dead code
+
+**Что делает**: Поиск и удаление неиспользуемого кода.
+
+```bash
+/health-cleanup
+```
+
+**Что ищет**:
+- Неиспользуемые функции и переменные
+- Закомментированный код
+- Debug артефакты (console.log)
+- Недостижимый код
+
+---
+
+## `/health-reuse` — Дедупликация кода
+
+**Что делает**: Поиск и консолидация дублирующегося кода.
+
+```bash
+/health-reuse
+```
+
+**Что ищет**:
+- Дублирующиеся типы и интерфейсы
+- Повторяющиеся Zod схемы
+- Копипаст констант
+- Похожие утилиты
+
+---
+
+## `/health-metrics` — Метрики качества
+
+**Что делает**: Сбор метрик качества кода.
+
+```bash
+/health-metrics
+```
+
+**Метрики**:
+- Покрытие тестами
+- Сложность кода
+- Количество TODO/FIXME
+- Размер бандла
+
+---
+
+# Worktree Commands
+
+Команды для параллельной разработки через git worktrees.
+
+## `/worktree-create` — Создать worktree
+
+**Что делает**: Создаёт изолированную директорию для параллельной работы.
+
+```bash
+/worktree-create feature-name
+/worktree-create payment-system main
+```
+
+**Результат**:
+- Создаёт `../project-worktrees/feature-name/`
+- Создаёт ветку `feature-name`
+- Копирует конфиги из `.worktree-sync.json`
+
+---
+
+## `/worktree-list` — Список worktrees
+
+**Что делает**: Показывает все активные worktrees.
+
+```bash
+/worktree-list
+```
+
+---
+
+## `/worktree-remove` — Удалить worktree
+
+**Что делает**: Удаляет worktree и опционально ветку.
+
+```bash
+/worktree-remove feature-name
+```
+
+---
+
+## `/worktree-cleanup` — Очистка worktrees
+
+**Что делает**: Удаляет устаревшие worktrees.
+
+```bash
+/worktree-cleanup
+```
+
+---
+
+# Release & Utility
+
+## `/push` — Автоматизация релизов
+
+**Что делает**: Бампит версию, обновляет CHANGELOG, создаёт тег и пушит.
+
+```bash
+/push patch    # 1.0.0 → 1.0.1 (багфиксы)
+/push minor    # 1.0.0 → 1.1.0 (новые фичи)
+/push major    # 1.0.0 → 2.0.0 (breaking changes)
+/push          # автоопределение по коммитам
+```
+
+**Особенности**:
+- Синхронизирует версию с последним тегом
+- Анализирует conventional commits
+- Генерирует CHANGELOG
+- Откат при ошибках
+
+---
+
+## `/translate-doc` — Перевод документации
+
+**Что делает**: Переводит документацию с английского на русский.
+
+```bash
+/translate-doc docs/README.md
+```
+
+**Сохраняет**:
+- Markdown форматирование
+- Код без изменений
+- Технические термины
+
+---
+
+# Полная структура проекта
+
+```
+project/
+├── .claude/
+│   ├── commands/              # Slash команды
+│   │   ├── speckit.*.md       # Spec-Kit (9 файлов)
+│   │   ├── health-*.md        # Health (6 файлов)
+│   │   ├── worktree-*.md      # Worktree (4 файла)
+│   │   ├── push.md            # Release
+│   │   └── translate-doc.md   # Utility
+│   ├── agents/                # Субагенты
+│   │   ├── workers/
+│   │   └── orchestrators/
+│   ├── skills/                # Навыки (reusable)
+│   └── scripts/               # Bash скрипты
+│       └── release.sh
+├── .specify/
+│   ├── memory/
+│   │   └── constitution.md
+│   ├── templates/
+│   └── scripts/bash/
+├── specs/                     # Спецификации фич
+│   └── 1-feature-name/
+├── docs/
+│   └── SPECKIT-GUIDE.md       # Это руководство
+└── .worktree-sync.json        # Конфиг для worktrees
+```
+
+---
+
 ## Ссылки
 
 - [GitHub Spec-Kit](https://github.com/github/spec-kit)
 - [Spec-Driven Development Guide](https://github.blog/ai-and-ml/generative-ai/spec-driven-development-with-ai-get-started-with-a-new-open-source-toolkit/)
+- [Claude Code Orchestrator Kit](https://github.com/maslennikov-ig/claude-code-orchestrator-kit)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-orchestrator-kit",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Complete automation and orchestration system for Claude Code with 33+ AI agents, quality gates, health monitoring, and workflow automation",
   "main": "index.js",
   "type": "module",