code-ai-installer 1.5.5 → 1.5.6

package/CONTEXT.md

@@ -0,0 +1,62 @@
+# 🎯 Обзор проекта
+
+| Поле | Значение |
+|------|----------|
+| **Название** | `<имя проекта>` |
+| **Описание** | `<краткое описание>` |
+| **Текущая фаза** | `<Discovery / MVP / v1 / Production>` |
+| **Дата создания** | `<YYYY-MM-DD>` |
+| **Последнее обновление** | `<YYYY-MM-DD>` |
+
+---
+
+## 🔄 Результаты пайплайна
+
+| Gate | Статус | Ключевой результат | Дата |
+|------|--------|---------------------|------|
+| Conductor | ☐ | — | — |
+| PM (PRD) | ☐ | — | — |
+| UX/UI | ☐ | — | — |
+| Architect | ☐ | — | — |
+| DevOps | ☐ | — | — |
+| Dev (TDD) | ☐ | — | — |
+| Reviewer | ☐ | — | — |
+| Tester | ☐ | — | — |
+| Release Gate | ☐ | — | — |
+
+---
+
+## 📋 Ключевые решения (ADR)
+
+| ID | Решение | Обоснование | Статус |
+|----|---------|-------------|--------|
+| ADR-001 | `<описание решения>` | `<почему выбрано>` | `Accepted / Superseded / Deprecated` |
+
+---
+
+## 📊 Текущее состояние
+
+### ✅ Сделано
+- `<что завершено>`
+
+### ⏳ В процессе
+- `<что сейчас в работе>`
+
+### 🚫 Заблокировано
+- `<что заблокировано и чем>`
+
+---
+
+## ❓ Открытые вопросы
+
+| ID | Вопрос | Владелец | Дедлайн | Статус |
+|----|--------|----------|---------|--------|
+| Q-001 | `<вопрос>` | `<кто отвечает>` | `<YYYY-MM-DD>` | `Open / Resolved` |
+
+---
+
+## 📝 История сессий
+
+| Сессия | Дата | Краткий итог | Артефакты |
+|--------|------|--------------|-----------|
+| Session 1 | `<YYYY-MM-DD>` | `<что сделано>` | `<ссылки на файлы>` |

package/dist/catalog.js

@@ -159,7 +159,7 @@ async function mapWorkflowFiles(workflowsDir) {
 /**
  * Known root-level extra files to include in install.
  */
-const EXTRA_FILE_NAMES = ["prompt-examples.md"];
+const EXTRA_FILE_NAMES = ["prompt-examples.md", "CONTEXT.md"];
 /**
  * Maps optional root-level extra files for installation.
  * @param projectDir Absolute project root path.

package/locales/en/CONTEXT.md

@@ -0,0 +1,62 @@
+# 🎯 Project Overview
+
+| Field | Value |
+|-------|-------|
+| **Name** | `<project name>` |
+| **Description** | `<brief description>` |
+| **Current Phase** | `<Discovery / MVP / v1 / Production>` |
+| **Created** | `<YYYY-MM-DD>` |
+| **Last Updated** | `<YYYY-MM-DD>` |
+
+---
+
+## 🔄 Pipeline Results
+
+| Gate | Status | Key Output | Date |
+|------|--------|------------|------|
+| Conductor | ☐ | — | — |
+| PM (PRD) | ☐ | — | — |
+| UX/UI | ☐ | — | — |
+| Architect | ☐ | — | — |
+| DevOps | ☐ | — | — |
+| Dev (TDD) | ☐ | — | — |
+| Reviewer | ☐ | — | — |
+| Tester | ☐ | — | — |
+| Release Gate | ☐ | — | — |
+
+---
+
+## 📋 Key Decisions (ADR)
+
+| ID | Decision | Rationale | Status |
+|----|----------|-----------|--------|
+| ADR-001 | `<decision description>` | `<why chosen>` | `Accepted / Superseded / Deprecated` |
+
+---
+
+## 📊 Current State
+
+### ✅ Done
+- `<what is completed>`
+
+### ⏳ In Progress
+- `<what is being worked on>`
+
+### 🚫 Blocked
+- `<what is blocked and by what>`
+
+---
+
+## ❓ Open Questions
+
+| ID | Question | Owner | Deadline | Status |
+|----|----------|-------|----------|--------|
+| Q-001 | `<question>` | `<who is responsible>` | `<YYYY-MM-DD>` | `Open / Resolved` |
+
+---
+
+## 📝 Session History
+
+| Session | Date | Summary | Artifacts |
+|---------|------|---------|-----------|
+| Session 1 | `<YYYY-MM-DD>` | `<what was done>` | `<file references>` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "code-ai-installer",
-  "version": "1.5.5",
+  "version": "1.5.6",
   "description": "Production-ready CLI to install code-ai agents and skills for multiple AI coding assistants.",
   "license": "MIT",
   "author": "Denis Harchenko",
@@ -21,7 +21,9 @@
     "AGENTS.yaml",
     "agents",
     ".agents",
-    "locales"
+    "locales",
+    "prompt-examples.md",
+    "CONTEXT.md"
   ],
   "bin": {
     "code-ai": "dist/index.js"

package/prompt-examples.md

@@ -0,0 +1,152 @@
+# Примеры промтов для запуска пайплайна
+
+> Копируй нужный промт, подставляй свои данные, вставляй в чат.
+
+---
+
+## 🔵 Полный пайплайн (`/start-task`) — новая фича / рефакторинг
+
+### Новая фича
+```
+@AGENTS.md Задание:
+Реализовать [описание фичи].
+Полный пайплайн!
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md из протокола skills → deliverable → notify_user → ждать "Approved"
+2. Пропуск гейта или skill = БЛОКЕР
+3. Без Approved — не продолжать
+```
+
+### Рефакторинг
+```
+@AGENTS.md Задание:
+Провести рефакторинг [описание: что именно рефакторим и зачем].
+Полный пайплайн!
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md из протокола skills → deliverable → notify_user → ждать "Approved"
+2. Пропуск гейта или skill = БЛОКЕР
+3. Без Approved — не продолжать
+```
+
+---
+
+## 🟢 Bugfix (`/bugfix`) — исправление бага (4 гейта)
+
+### Стандартный баг
+```
+@AGENTS.md Задание:
+Исправить баг: [описание бага, шаги воспроизведения, ожидаемое vs фактическое поведение].
+Bugfix пайплайн!
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md из протокола skills → deliverable → notify_user → ждать "Approved"
+2. Пропуск гейта или skill = БЛОКЕР
+3. Без Approved — не продолжать
+```
+
+### Баг с указанием файлов
+```
+@AGENTS.md Задание:
+@[путь/к/файлу1] @[путь/к/файлу2]
+Баг: [описание]. Предполагаемая причина в указанных файлах.
+Bugfix пайплайн!
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md → deliverable → notify_user → ждать "Approved"
+2. Пропуск гейта = БЛОКЕР
+```
+
+---
+
+## 🟡 Hotfix (`/hotfix`) — мелкая правка (2 гейта)
+
+### Опечатка / CSS / одна строка
+```
+@AGENTS.md Задание:
+Hotfix: [описание правки, например: "исправить опечатку в заголовке" или "изменить цвет кнопки с #333 на #555"].
+Hotfix пайплайн!
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md → deliverable → notify_user → ждать "Approved"
+2. Пропуск гейта = БЛОКЕР
+```
+
+---
+
+## 🎨 Только дизайн (Google Stitch)
+
+### Генерация UI-экранов
+```
+@AGENTS.md Задание:
+Создать UI-экраны для [описание: какие экраны, какое приложение].
+Использовать Google Stitch через $google_stitch_skill.
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. view_file agents/ux_ui_designer.md → view_file $google_stitch_skill → deliverable → notify_user → ждать "Approved"
+```
+
+---
+
+## 📄 Только документация
+
+### Адаптация / создание документов
+```
+@AGENTS.md Задание:
+[Описание задачи с документацией, например: "адаптировать файлы X, Y, Z для глобального использования"].
+Bugfix пайплайн! (или Полный пайплайн — по сложности)
+
+ПРАВИЛА ЭТОЙ СЕССИИ:
+1. Каждый гейт: view_file agents/<role>.md → view_file на КАЖДЫЙ SKILL.md → deliverable → notify_user → ждать "Approved"
+2. Пропуск гейта = БЛОКЕР
+```
+
+---
+
+## ⚡ Переход между гейтами (ответы пользователя)
+
+### Одобрение и переход к следующему гейту
+```
+Approved. Следующий гейт: agents/<role>.md. Skills: view_file обязателен. Полный формат.
+```
+
+### Одобрение с указанием триггера (Wix / Shopify)
+```
+Approved. TEST gate. Wix.
+```
+
+### Отказ / возврат на доработку
+```
+NO-GO. Исправь: [список замечаний]. Вернись на гейт [гейт].
+```
+
+---
+
+## 🔧 Утилитарные промты
+
+### Проверка статуса
+```
+Покажи текущий Master Checklist и статус всех гейтов.
+```
+
+### Запуск конкретного агента
+```
+Запусти agents/<role>.md. Контекст: [краткое описание]. Skills: view_file обязателен.
+```
+
+### Обновление версии
+```
+Обнови версию в package.json до X.Y.Z
+```
+
+---
+
+## 📝 Советы по составлению промтов
+
+1. **Всегда начинай с `@AGENTS.md`** — это загружает систему агентов
+2. **Указывай файлы через `@[путь]`** — агент сразу видит контекст
+3. **Называй режим пайплайна** — «Полный пайплайн!», «Bugfix пайплайн!», «Hotfix пайплайн!»
+4. **Добавляй ПРАВИЛА СЕССИИ** — это гарантирует соблюдение протокола
+5. **Пиши «Approved»** явно — без этого слова агент не перейдёт к следующему гейту
+6. **Будь конкретен** — чем точнее описание, тем лучше результат