claude-code-orchestrator-kit 1.4.0 → 1.4.15

package/docs/Agents Ecosystem/AGENT-ORCHESTRATION.md

@@ -551,8 +551,8 @@ Prompt: "Implement T005: Create Email service in src/services/email.ts"
 
 **database-architect, infrastructure-specialist, integration-tester**:
 - Use Supabase MCP for all database operations
-- Project ref: `diqooqbuchsliypgwksu` (MegaCampusAI)
-- Migrations: `packages/course-gen-platform/supabase/migrations/`
+- Project ref: from environment or plan file
+- Migrations: project-specific path (e.g., `supabase/migrations/`)
 
 **Fallback Strategy**:
 If MCP unavailable:

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
+
 ---
 
 ## Структура проекта
@@ -344,21 +371,6 @@ mcp__context7__get-library-docs → получить docs по теме
 
 ---
 
-## DeksdenFlow (Session Management)
-
-При длинных сессиях `/speckit.implement`:
-
-- **resume-session** — проверка существующей сессии
-- **save-session-context** — сохранение после каждой фазы
-- **load-project-context** — загрузка структуры проекта
-
-Позволяет:
-- Возобновить работу после перезапуска
-- Не терять контекст при ошибках
-- Логировать решения в session-log.md
-
----
-
 ## Типичные сценарии
 
 ### Новая фича с нуля
@@ -409,7 +421,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/docs/reports/skills/new-skills-analysis-2025-12.md

@@ -0,0 +1,331 @@
+# Анализ новых скиллов (Декабрь 2025)
+
+> Дата анализа: 2025-12-26
+> Всего новых скиллов: 14
+
+## Краткая сводка
+
+| Категория | Кол-во | Полезность для проекта |
+|-----------|--------|------------------------|
+| Разработка и качество кода | 4 | Высокая |
+| DevOps и инфраструктура | 2 | Высокая |
+| UI/UX и дизайн | 4 | Средняя |
+| Контент и исследования | 3 | Низкая |
+| Нишевые (Move, Leads) | 2 | Не применимо |
+
+---
+
+## Детальный анализ
+
+### 1. systematic-debugging
+
+**Назначение:** Методология систематического дебага вместо "угадывания" фиксов.
+
+**Ключевые особенности:**
+- 4 фазы: Root Cause → Pattern Analysis → Hypothesis → Implementation
+- Правило "3 фикса = пересмотр архитектуры"
+- Трассировка данных в многокомпонентных системах
+
+**Полезность: КРИТИЧЕСКИ ВЫСОКАЯ**
+
+**Интеграция в проект:**
+- **Заменяет/дополняет:** `problem-investigator` агент
+- **Рекомендация:** Интегрировать как обязательный скилл для `bug-fixer` воркера
+- **Как использовать:** Добавить ссылку в промпт bug-fixer: "Before fixing, apply systematic-debugging skill"
+
+---
+
+### 2. code-reviewer
+
+**Назначение:** Автоматизированный code review с чек-листами и best practices.
+
+**Ключевые особенности:**
+- PR Analyzer, Code Quality Checker, Review Report Generator
+- Референсы: checklist, coding standards, antipatterns
+
+**Полезность: ВЫСОКАЯ**
+
+**Интеграция в проект:**
+- **Дублирует:** Существующий `code-reviewer` агент
+- **Рекомендация:** ОБЪЕДИНИТЬ с агентом code-reviewer
+- **Как:** Скилл содержит knowledge base, агент содержит execution logic. Агент должен ссылаться на скилл.
+
+---
+
+### 3. senior-devops
+
+**Назначение:** CI/CD pipelines, Terraform, Kubernetes, deployment strategies.
+
+**Ключевые особенности:**
+- Pipeline Generator, Terraform Scaffolder, Deployment Manager
+- Референсы по IaC, deployment strategies
+
+**Полезность: ВЫСОКАЯ**
+
+**Интеграция в проект:**
+- **Дополняет:** `deployment-engineer` агент
+- **Рекомендация:** Использовать как knowledge base для deployment-engineer
+- **Как:** Добавить ссылку в агент: "Refer to senior-devops skill for CI/CD patterns"
+
+---
+
+### 4. senior-prompt-engineer
+
+**Назначение:** LLM optimization, prompt patterns, RAG, agent design.
+
+**Ключевые особенности:**
+- Prompt optimization, RAG evaluation, agent orchestration
+- Референсы: prompt patterns, LLM evaluation, agentic system design
+
+**Полезность: ВЫСОКАЯ**
+
+**Интеграция в проект:**
+- **Дополняет:** `meta-agent-v3` (создание агентов)
+- **Рекомендация:** Использовать при создании новых агентов и улучшении промптов
+- **Как:** Ссылаться при написании/оптимизации agent prompts
+
+---
+
+### 5. webapp-testing
+
+**Назначение:** Тестирование веб-приложений через Playwright.
+
+**Ключевые особенности:**
+- `with_server.py` - управление серверами
+- Reconnaissance-then-action pattern
+- Decision tree для выбора подхода
+
+**Полезность: ВЫСОКАЯ**
+
+**Интеграция в проект:**
+- **Дополняет:** `integration-tester`, `mobile-responsiveness-tester`
+- **Рекомендация:** Использовать для E2E тестирования
+- **Как:** Добавить в workflow тестирования после `test-writer`
+
+---
+
+### 6. ui-design-system
+
+**Назначение:** Генерация дизайн-токенов, responsive calculations.
+
+**Ключевые особенности:**
+- Design token generator (colors, typography, spacing)
+- Component documentation
+- Developer handoff
+
+**Полезность: СРЕДНЯЯ**
+
+**Интеграция в проект:**
+- **Дополняет:** `nextjs-ui-designer`, `frontend-aesthetics`
+- **Рекомендация:** Использовать для создания design system в новых проектах
+- **Когда:** При старте нового frontend проекта
+
+---
+
+### 7. ux-researcher-designer
+
+**Назначение:** UX research - personas, journey mapping, usability testing.
+
+**Ключевые особенности:**
+- Data-driven persona generation
+- Customer journey mapping
+- Research synthesis
+
+**Полезность: НИЗКАЯ для текущего проекта**
+
+**Интеграция в проект:**
+- Не релевантен для CLI toolkit
+- **Рекомендация:** Оставить для user-facing продуктов
+- **Когда использовать:** При разработке пользовательских интерфейсов
+
+---
+
+### 8. content-research-writer
+
+**Назначение:** Помощь в написании статей с research и citations.
+
+**Ключевые особенности:**
+- Collaborative outlining
+- Research с citations
+- Hook improvement
+- Section-by-section feedback
+
+**Полезность: НИЗКАЯ для текущего проекта**
+
+**Интеграция в проект:**
+- Не связан с разработкой
+- **Рекомендация:** Использовать для документации и блог-постов
+- **Дублирует:** Частично `article-writer-multi-platform`
+
+---
+
+### 9. lead-research-assistant
+
+**Назначение:** Поиск лидов для продаж и business development.
+
+**Полезность: НЕ ПРИМЕНИМО**
+
+**Рекомендация:** УДАЛИТЬ из проекта
+- Не связан с разработкой
+- Не связан с agent orchestration
+- Засоряет список скиллов
+
+---
+
+### 10. move-code-quality
+
+**Назначение:** Code review для Move language (Sui blockchain).
+
+**Полезность: НЕ ПРИМЕНИМО**
+
+**Рекомендация:** УДАЛИТЬ из проекта
+- Move - нишевый язык для blockchain
+- Не связан с текущим tech stack (TypeScript, Next.js, Supabase)
+- Очень специфичный use case
+
+---
+
+### 11. algorithmic-art
+
+**Назначение:** Создание generative art через p5.js.
+
+**Ключевые особенности:**
+- Algorithmic philosophy creation
+- p5.js implementation
+- Seeded randomness (Art Blocks pattern)
+- Interactive HTML artifacts
+
+**Полезность: НИЗКАЯ**
+
+**Интеграция в проект:**
+- Не связан с разработкой tooling
+- **Рекомендация:** Оставить для creative проектов
+- **Пересечение:** С `visual-effects-creator` агентом (но разные цели)
+
+---
+
+### 12. theme-factory
+
+**Назначение:** Применение готовых тем к артефактам (slides, docs, landing pages).
+
+**Ключевые особенности:**
+- 10 pre-set themes
+- Color/font pairings
+- Custom theme generation
+
+**Полезность: НИЗКАЯ**
+
+**Рекомендация:** Оставить для presentation/marketing задач
+
+---
+
+### 13. artifacts-builder
+
+**Назначение:** Создание сложных HTML артефактов для claude.ai.
+
+**Ключевые особенности:**
+- React + TypeScript + Vite + Tailwind + shadcn/ui
+- `init-artifact.sh` и `bundle-artifact.sh` скрипты
+- Bundling в single HTML
+
+**Полезность: СРЕДНЯЯ**
+
+**Интеграция в проект:**
+- Полезен для создания интерактивных демо
+- **Рекомендация:** Использовать для документации и showcases
+- **Когда:** При создании demo artifacts для README
+
+---
+
+### 14. canvas-design
+
+**Назначение:** Создание визуального арта (.png, .pdf) через design philosophy.
+
+**Ключевые особенности:**
+- Design philosophy creation
+- Canvas creation с typography
+- Multi-page support
+
+**Полезность: НИЗКАЯ**
+
+**Рекомендация:** Оставить для creative/marketing задач
+
+---
+
+## Рекомендации по действиям
+
+### Высокий приоритет: ИНТЕГРИРОВАТЬ
+
+| Скилл | Действие | Целевой агент/место |
+|-------|----------|---------------------|
+| `systematic-debugging` | Добавить как обязательный reference | `bug-fixer`, `problem-investigator` |
+| `senior-devops` | Объединить knowledge base | `deployment-engineer` |
+| `senior-prompt-engineer` | Использовать при создании агентов | `meta-agent-v3` |
+| `webapp-testing` | Добавить в test workflow | После `test-writer` |
+| `code-reviewer` (skill) | Объединить с агентом | `code-reviewer` (agent) |
+
+### Средний приоритет: ОСТАВИТЬ
+
+| Скилл | Причина |
+|-------|---------|
+| `ui-design-system` | Полезен для frontend проектов |
+| `artifacts-builder` | Полезен для демо и документации |
+| `algorithmic-art` | Creative проекты |
+| `theme-factory` | Presentations |
+| `canvas-design` | Creative проекты |
+
+### Низкий приоритет: РАССМОТРЕТЬ УДАЛЕНИЕ
+
+| Скилл | Причина удаления |
+|-------|------------------|
+| `move-code-quality` | Нишевый blockchain язык, не наш stack |
+| `lead-research-assistant` | Sales/BD, не связан с разработкой |
+| `ux-researcher-designer` | UX research, не CLI toolkit |
+| `content-research-writer` | Дублирует article-writer-multi-platform |
+
+---
+
+## План интеграции
+
+### Фаза 1: Связать скиллы с агентами
+
+```
+bug-fixer agent
+  └── references: systematic-debugging skill
+
+deployment-engineer agent
+  └── references: senior-devops skill
+
+code-reviewer agent
+  └── references: code-reviewer skill (merge knowledge)
+
+meta-agent-v3 agent
+  └── references: senior-prompt-engineer skill
+```
+
+### Фаза 2: Добавить в workflows
+
+```
+/health-bugs workflow:
+  bug-hunter → bug-fixer (+ systematic-debugging) → verify
+
+Test workflow:
+  test-writer → webapp-testing → verify
+```
+
+### Фаза 3: Cleanup
+
+Рассмотреть удаление:
+- `move-code-quality` (нишевый)
+- `lead-research-assistant` (не dev)
+
+---
+
+## Выводы
+
+1. **5 скиллов** критически полезны и должны быть интегрированы с существующими агентами
+2. **5 скиллов** полезны для специфических задач (creative, presentations)
+3. **2 скилла** не релевантны проекту и могут быть удалены
+4. **2 скилла** имеют частичное дублирование с существующими агентами
+
+Главная ценность новых скиллов - **knowledge base** (best practices, checklists, patterns), который дополняет **execution logic** существующих агентов.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-code-orchestrator-kit",
-  "version": "1.4.0",
-  "description": "Complete automation and orchestration system for Claude Code with 33+ AI agents, quality gates, health monitoring, and workflow automation",
+  "version": "1.4.15",
+  "description": "Professional automation and orchestration system for Claude Code with 39 AI agents, 37 skills, 18 slash commands, 7 MCP configurations, quality gates, and inline orchestration workflows",
   "main": "index.js",
   "type": "module",
   "scripts": {
@@ -13,23 +13,31 @@
     "claude",
     "claude-code",
     "ai",
+    "ai-agents",
     "agents",
     "orchestration",
     "automation",
     "workflow",
     "mcp",
     "model-context-protocol",
+    "skills",
+    "inline-orchestration",
     "supabase",
     "code-quality",
+    "code-review",
     "health-monitoring",
     "devtools",
     "productivity",
     "ci-cd",
+    "devops",
     "quality-gates",
     "bug-detection",
     "security-scanning",
     "dependency-management",
-    "speckit"
+    "dead-code",
+    "speckit",
+    "prompt-engineering",
+    "llm"
   ],
   "author": {
     "name": "Igor Maslennikov",