architect/_archive/2025-11-cleanup/platform-v2-cifra/agents/projector/ASSISTANTS.md

Специализированные ассистенты для Projector v2.0

Документ: ASSISTANTS.md
Версия: 1.0.0
Дата: 2025-11-11
Назначение: Спецификация всех доменных ассистентов для работы с Projector


🎯 КОНЦЕПЦИЯ

Ассистенты — доменные эксперты, которые подключаются к Projector для добавления специализированной экспертизы в конкретном направлении.

Принцип работы:

User → Orchestrator → Projector (универсальный фреймворк)
                         ↓
                    Specialist (доменная экспертиза)
                         ↓
             PROJECT.md + {TYPE}_PLAN.md

Момент активации: На этапе КОНТРОЛЬ (после каждого этапа для проверки качества)


📚 СПИСОК АССИСТЕНТОВ

1. 💼 BUSINESS ASSISTANT (Бизнес-ассистент)

Специализация: Бизнес-проекты, стратегия, финансы, маркетинг

Триггеры активации:

KEYWORDS = [
    "бизнес", "компания", "магазин", "продажи", "клиенты",
    "маркетинг", "прибыль", "конкуренты", "товары", "интернет-магазин",
    "ecommerce", "b2b", "b2c", "продукт", "услуга"
]

Ключевые функции:
- Анализ бизнес-модели
- Исследование рынка и конкурентов
- Финансовое моделирование (ROI, P&L, Cash Flow)
- Ценообразование и позиционирование
- Customer journey mapping
- Unit economics расчёт
- Go-to-market стратегия

Автоанкета (25 вопросов):

КОМАНДА (5 вопросов):
├─ Есть ли IT-компетенции в команде?
├─ Сколько человек на старте?
├─ Готовы нанимать сотрудников?
├─ Бюджет на команду в месяц?
└─ Кто CEO, CTO, CMO?

БИЗНЕС (5 вопросов):
├─ Текущий месячный оборот?
├─ Количество заказов в месяц?
├─ Основные каналы продаж?
├─ География бизнеса?
└─ Есть ли сезонность?

ПРОДУКТ/УСЛУГА (5 вопросов):
├─ Сколько SKU/товаров?
├─ Средний чек?
├─ Оборачиваемость товаров?
├─ Источники поставок?
└─ Логистика и доставка?

ТЕХНИКА (5 вопросов):
├─ Есть ли сайт/приложение?
├─ Используется CRM?
├─ Какие интеграции нужны?
├─ Есть ли мобильная версия?
└─ Кто поддерживает IT?

РЫНОК (5 вопросов):
├─ Кто главные конкуренты?
├─ В чём ваше преимущество?
├─ Как позиционируетесь?
├─ Целевая аудитория?
└─ Планы по масштабированию?

Создаваемый документ: design/BUSINESS_PLAN.md

Структура документа:

# Бизнес-план: {PROJECT_NAME}

## 📊 Executive Summary
- Суть проекта (2-3 предложения)
- Ключевые цифры (выручка, рост, ROI)
- Основные риски и возможности

## 🎯 Описание бизнеса
### Продукт/Услуга
- Что продаём
- Какую проблему решаем
- Уникальное ценностное предложение (УЦП)

### Целевая аудитория
- Портреты клиентов (personas)
- Размер рынка (TAM/SAM/SOM)
- Сегментация

## 📈 Анализ рынка
### Рыночная ситуация
- Размер рынка
- Темпы роста
- Тренды

### Конкурентный анализ
- Прямые конкуренты (ТОП-5)
- Косвенные конкуренты
- Конкурентные преимущества
- SWOT-анализ

### Позиционирование
- Как позиционируемся
- Почему клиенты выберут нас
- Ключевые отличия

## 💰 Финансовая модель
### Unit Economics
- LTV (Lifetime Value)
- CAC (Customer Acquisition Cost)
- LTV/CAC соотношение
- Payback период

### Выручка и прибыль
- Модель дохода
- Прогноз выручки (3 года)
- P&L (Profit & Loss)
- Cash Flow

### Инвестиции
- Требуемый капитал
- Использование средств
- Ожидаемый ROI
- Exit стратегия (если применимо)

## 🚀 Go-to-Market стратегия
### Каналы привлечения
- Список каналов (с приоритетами)
- CAC по каналам
- План тестирования

### Маркетинговый план
- Стратегия (первые 3-6-12 месяцев)
- Бюджет на маркетинг
- Ожидаемые результаты

## 👥 Команда и операции
### Команда
- Ключевые роли
- Текущий состав
- План найма

### Операционный план
- Процессы
- Партнёры
- Поставщики

## ⚠️ Риски и митигация
### Основные риски
- Рыночные риски
- Финансовые риски
- Операционные риски
- Регуляторные риски

### План митигации
- Для каждого риска: стратегия снижения

## 📅 Roadmap
### Milestone'ы
- Квартальные цели
- Ключевые метрики
- Критерии успеха

Метрики эффективности:

Без Business Assistant:
├─ Бизнес-план: 80-120 часов
├─ Качество: 6/10 (много пробелов)
└─ Риски: высокие (неполный анализ)

С Business Assistant:
├─ Бизнес-план: 4-6 часов (95% экономия)
├─ Качество: 9/10 (comprehensive)
└─ Риски: низкие (полный анализ)

2. 💻 TECHNICAL ASSISTANT (Технический ассистент)

Специализация: IT-проекты, разработка, архитектура, DevOps

Триггеры активации:

KEYWORDS = [
    "разработка", "приложение", "API", "система", "код",
    "база данных", "сервер", "фронтенд", "бэкенд", "мобильное",
    "веб", "интеграция", "микросервисы", "архитектура"
]

Ключевые функции:
- Проектирование архитектуры системы
- Выбор технологического стека
- Оценка технической сложности
- Планирование разработки
- DevOps и CI/CD стратегия
- Безопасность и масштабирование
- Code review и best practices

Автоанкета (20 вопросов):

ТЕХНОЛОГИИ (5 вопросов):
├─ Какой технологический стек предпочтителен?
├─ Есть ли legacy системы для интеграции?
├─ Требования к производительности?
├─ Требования к безопасности?
└─ Географическое распределение пользователей?

ТРЕБОВАНИЯ (5 вопросов):
├─ Основная функциональность (must-have)?
├─ Желательная функциональность (nice-to-have)?
├─ Ожидаемое количество пользователей?
├─ Критичность доступности (SLA)?
└─ Требования к отказоустойчивости?

РЕСУРСЫ (5 вопросов):
├─ Команда разработки (количество, навыки)?
├─ Бюджет на инфраструктуру?
├─ Timeline проекта?
├─ Опыт команды с выбранным стеком?
└─ Нужна ли внешняя экспертиза?

ИНТЕГРАЦИИ (5 вопросов):
├─ Какие внешние API нужны?
├─ Есть ли внутренние системы для интеграции?
├─ Требования к синхронизации данных?
├─ Нужна ли мобильная версия?
└─ Планы по развитию API?

Создаваемый документ: design/TECHNICAL_SPEC.md

Структура документа:

# Техническое задание: {PROJECT_NAME}

## 🎯 Общее описание
### Назначение системы
- Цель и задачи
- Основные функции
- Целевая аудитория

### Границы системы
- Что входит в scope
- Что НЕ входит в scope
- Интеграции

## 📋 Функциональные требования
### Основные функции
[Детальное описание функций]

### User Stories

Как [роль]
Я хочу [действие]
Чтобы [цель]

Критерии приёмки:
- [ ] ...
- [ ] ...

## 🏗️ Архитектура системы
### Общая архитектура
- High-level схема
- Основные компоненты
- Взаимодействие компонентов

### Детальная архитектура
- Frontend архитектура
- Backend архитектура
- База данных
- Кэширование
- Очереди (если применимо)

### Паттерны и принципы
- Архитектурные паттерны (MVC/MVVM/Clean/etc)
- Design patterns
- SOLID принципы

## 💻 Технологический стек
### Frontend
- Фреймворк (React/Vue/Angular/другой)
- State management
- UI библиотеки
- Build tools

### Backend
- Язык и фреймворк
- ORM/Query builder
- Authentication/Authorization
- API framework

### База данных
- Тип БД (SQL/NoSQL)
- СУБД (PostgreSQL/MySQL/MongoDB/другая)
- Схема данных
- Индексы и оптимизация

### Инфраструктура
- Облако (AWS/GCP/Azure/VPS)
- Контейнеризация (Docker)
- Оркестрация (Kubernetes/Docker Swarm)
- CDN

## 🔌 API спецификация
### Эндпоинты

GET /api/v1/users
POST /api/v1/users
PUT /api/v1/users/{id}
DELETE /api/v1/users/{id}

### Форматы данных
```json
{
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com"
}

Аутентификация

💾 База данных

Схема БД

CREATE TABLE users (
  id SERIAL PRIMARY KEY,
  email VARCHAR(255) UNIQUE NOT NULL,
  created_at TIMESTAMP DEFAULT NOW()
);

Связи между таблицами

Миграции

🔒 Безопасность

Authentication & Authorization

Защита данных

Secrets management

🚀 DevOps и CI/CD

CI/CD Pipeline

Code → Build → Test → Deploy
  ↓      ↓      ↓       ↓
GitHub Actions → Docker → K8s

Environments

Мониторинг и логи

📈 Производительность и масштабирование

Требования к производительности

Стратегия масштабирования

Кэширование

🧪 Тестирование

Виды тестов

Test strategy

📦 Развёртывание

Deployment strategy

Infrastructure as Code

📊 Метрики и KPI

Технические метрики

Бизнес-метрики

⚠️ Риски и ограничения

Технические риски

Митигация

**Метрики эффективности:**

Без Technical Assistant:
├─ Техзадание: 60-100 часов
├─ Пропущенные требования: 30%
└─ Переделка в процессе: ~40%

С Technical Assistant:
├─ Техзадание: 3-5 часов (95% экономия)
├─ Пропущенные требования: <5%
└─ Переделка в процессе: ~5%

---

### 3. 📢 MARKETING ASSISTANT (Маркетинг-ассистент)

**Специализация:** Маркетинговые кампании, SMM, SEO, контент

**Триггеры активации:**
```python
KEYWORDS = [
    "реклама", "SMM", "SEO", "контент", "кампания",
    "аудитория", "трафик", "конверсия", "бренд", "продвижение",
    "таргет", "лиды", "воронка", "крео"
]

Ключевые функции:
- Анализ целевой аудитории
- Стратегия продвижения
- Планирование каналов (performance)
- SEO оптимизация
- SMM стратегия
- Контент-план
- Медиаплан и бюджетирование
- Метрики и аналитика

Автоанкета (16 вопросов):

ЦЕЛИ (4 вопроса):
├─ Главная цель (awareness/leads/sales)?
├─ Целевая аудитория?
├─ Бюджет на маркетинг?
└─ Сроки достижения целей?

КАНАЛЫ (4 вопроса):
├─ Какие каналы используются сейчас?
├─ Эффективность текущих каналов?
├─ Есть ли аналитика?
└─ Что не пробовали, но хотели?

КОНКУРЕНТЫ (4 вопроса):
├─ Кто главные конкуренты?
├─ Где они продвигаются?
├─ В чём ваше УТП?
└─ Какой tone of voice?

РЕСУРСЫ (4 вопроса):
├─ Есть ли маркетолог в команде?
├─ Кто делает креативы?
├─ Кто пишет тексты?
└─ Готовы работать с агентством?

Создаваемый документ: design/MARKETING_STRATEGY.md

Структура документа:

# Маркетинговая стратегия: {PROJECT_NAME}

## 🎯 Цели и KPI
### Бизнес-цели
- Главная цель (awareness/consideration/conversion)
- Численные показатели (метрики)
- Timeline

### KPI
- Traffic (посещения, уникальные)
- Leads (количество, CPL)
- Sales (конверсия, CPA, ROAS)
- Brand metrics (узнаваемость, NPS)

## 👥 Целевая аудитория
### Сегменты
**Сегмент 1: [Название]**
- Демография (возраст, пол, доход, город)
- Психография (интересы, ценности, lifestyle)
- Боли и потребности
- Где ищут решение
- Что влияет на решение о покупке

**Сегмент 2: [Название]**
[Аналогично]

### Personas
**Persona 1: [Имя]**

Возраст: 28 лет
Работа: Middle-менеджер
Доход: 80k/месяц
Цели: Рост по карьере, экономия времени
Боли: Нехватка времени, высокие цены
Каналы: Instagram, YouTube, Google

## 🎨 Позиционирование и УТП
### Позиционирование
- Как позиционируемся
- Для кого
- Что предлагаем
- Почему выбирают нас

### Уникальное торговое предложение (УТП)
- Ключевое преимущество
- Proof points (доказательства)
- Сравнение с конкурентами

### Brand voice и tone
- Как общаемся с аудиторией
- Примеры формулировок
- Do's and Don'ts

## 📢 Каналы продвижения
### Приоритеты каналов
**1. Контекстная реклама (Google Ads, Яндекс.Директ)**
- Почему: высокая conversion intent
- Бюджет: 30% от общего
- Expected CPA: 1500₽
- Expected ROAS: 400%

**2. Таргетированная реклама (VK, Instagram, FB)**
- Почему: большая охватная аудитория
- Бюджет: 25% от общего
- Expected CPL: 300₽
- Expected CR: 3%

**3. SEO**
- Почему: долгосрочный органический трафик
- Бюджет: 15% от общего
- Expected traffic: +200% за 6 месяцев

**4. Content marketing**
- Почему: экспертность и retention
- Бюджет: 10% от общего
- Expected engagement: +50%

[...другие каналы...]

### План тестирования
- Какие гипотезы тестируем
- Минимальный бюджет на тест
- Критерии успеха

## 📝 Контент-стратегия
### Типы контента
- Блог (статьи, кейсы)
- Social media (посты, сторис)
- Email (рассылки)
- Video (YouTube, TikTok)
- Другие форматы

### Контент-план
| Неделя | Канал | Тема | Формат | Ответственный |
|--------|-------|------|--------|---------------|
| 1 | Blog | 10 способов... | Статья 2000 слов | Копирайтер |
| 1 | Instagram | Кейс клиента | Карусель 10 слайдов | SMM |
| 2 | YouTube | Обзор продукта | Видео 5 мин | Видеограф |

### SEO-контент
- Ключевые запросы (семантическое ядро)
- План статей (топ-30)
- Internal linking strategy

## 💰 Медиаплан и бюджет
### Общий бюджет

Месячный бюджет: 500,000₽

Распределение:
├─ Контекстная реклама: 150,000₽ (30%)
├─ Таргет: 125,000₽ (25%)
├─ SEO: 75,000₽ (15%)
├─ Content: 50,000₽ (10%)
├─ Email: 25,000₽ (5%)
├─ Креативы: 50,000₽ (10%)
└─ Резерв на тесты: 25,000₽ (5%)

### Прогноз эффективности

Ожидаемые результаты (месяц):
├─ Traffic: 50,000 визитов
├─ Leads: 1,500 лидов (CPL 333₽)
├─ Sales: 150 продаж (CR 10%, CPA 3,333₽)
├─ Revenue: 1,500,000₽
└─ ROAS: 300%

### Масштабирование
- План роста бюджета
- Когда масштабировать
- Как распределять рост

## 📊 Метрики и аналитика
### Уровни метрик
**1. Traffic metrics**
- Sessions, Users
- Bounce rate, Time on site
- Traffic sources

**2. Engagement metrics**
- CTR, CR
- Scroll depth
- Video completion rate

**3. Conversion metrics**
- Leads, MQL, SQL
- Conversion rate
- Cost per lead/acquisition

**4. Business metrics**
- Revenue, ROAS
- LTV, CAC
- Payback period

### Инструменты аналитики
- Google Analytics / Яндекс.Метрика
- CRM аналитика
- BI dashboard (Tableau/PowerBI/Superset)
- Call tracking
- Email analytics

### Reporting
- Дневные дашборды (key metrics)
- Недельные отчёты (performance)
- Месячные отчёты (comprehensive)

## 🔄 Воронка и Customer Journey
### Воронка продаж

Awareness (10,000) → CTR 5%

Interest (500) → Landing CR 20%

Consideration (100) → Lead CR 40%

Purchase (40) → Sale CR 25%

Loyalty (10) → Repeat 25%

### Customer Journey Map
**Этап 1: Awareness**
- Touchpoints: Google, Instagram, YouTube
- Content: Образовательный контент, кейсы
- Goal: Привлечь внимание

**Этап 2: Consideration**
- Touchpoints: Landing, Blog, Email
- Content: Сравнения, FAQ, демо
- Goal: Показать ценность

**Этап 3: Purchase**
- Touchpoints: Product page, Cart, Checkout
- Content: Гарантии, отзывы, support
- Goal: Снять возражения

**Этап 4: Retention**
- Touchpoints: Email, Push, Retargeting
- Content: Updates, tips, offers
- Goal: Повторные покупки

## ⚠️ Риски и митигация
### Маркетинговые риски
- Рост стоимости рекламы
- Конкуренты копируют стратегию
- Изменения в алгоритмах платформ
- Негативные отзывы

### План митигации
[Для каждого риска: как снижаем]

## 🚀 План запуска (первые 90 дней)
### Неделя 1-2: Подготовка
- [ ] Настройка аналитики
- [ ] Подготовка креативов
- [ ] Настройка рекламных кампаний

### Неделя 3-4: Запуск
- [ ] Старт рекламы (минимальный бюджет)
- [ ] A/B тесты креативов
- [ ] Оптимизация

### Неделя 5-8: Масштабирование
- [ ] Увеличение бюджета на эффективные каналы
- [ ] Запуск новых кампаний
- [ ] Расширение семантики

### Неделя 9-12: Оптимизация
- [ ] Анализ результатов
- [ ] Корректировка стратегии
- [ ] План на следующий квартал

Метрики эффективности:

Без Marketing Assistant:
├─ Стратегия: 40-60 часов
├─ ROI первых кампаний: 50-100%
└─ Слив бюджета на тесты: ~30%

С Marketing Assistant:
├─ Стратегия: 2-3 часа (95% экономия)
├─ ROI первых кампаний: 200-400%
└─ Слив бюджета на тесты: ~5%

4. 🎨 DESIGN ASSISTANT (Дизайн-ассистент)

Специализация: UX/UI дизайн, прототипирование, визуал

Триггеры активации:

KEYWORDS = [
    "дизайн", "UX", "UI", "прототип", "макет",
    "интерфейс", "визуал", "брендинг", "фирменный стиль",
    "wireframe", "mockup", "пользовательский опыт"
]

Ключевые функции:
- UX исследования
- Создание user flow
- Wireframing и prototyping
- UI дизайн (визуал)
- Design system
- Usability testing
- Accessibility (WCAG)

Создаваемый документ: design/DESIGN_SPEC.md

Структура документа:

# Дизайн-спецификация: {PROJECT_NAME}

## 🎯 UX стратегия
### Целевая аудитория
### Пользовательские сценарии (use cases)
### User flow диаграммы

## 🖼️ Визуальный дизайн
### Стиль и tone
### Цветовая палитра
### Типографика
### Иконки и иллюстрации

## 📐 Wireframes и прототипы
### Lo-fi wireframes
### Hi-fi mockups
### Interactive prototype (Figma link)

## 🎨 Design System
### UI компоненты
### Spacing и grid
### Breakpoints (responsive)

## ♿ Accessibility
### WCAG соответствие
### Keyboard navigation
### Screen reader support

5. 📊 DATA ASSISTANT (Дата-ассистент)

Специализация: Аналитика, отчёты, Data Science, BI

Триггеры активации:

KEYWORDS = [
    "данные", "аналитика", "отчёты", "метрики",
    "дашборд", "BI", "data science", "ML", "прогнозирование",
    "визуализация", "KPI", "метрики"
]

Ключевые функции:
- Проектирование аналитики
- Определение метрик и KPI
- Дашборды и визуализация
- Прогнозные модели (ML)
- A/B тестирование
- ETL процессы

Создаваемый документ: design/DATA_STRATEGY.md


6. 🏗️ INFRASTRUCTURE ASSISTANT (Инфраструктурный ассистент)

Специализация: DevOps, облака, CI/CD, мониторинг

Триггеры активации:

KEYWORDS = [
    "инфраструктура", "DevOps", "облако", "AWS", "GCP", "Azure",
    "Docker", "Kubernetes", "CI/CD", "мониторинг", "серверы"
]

Ключевые функции:
- Проектирование инфраструктуры
- Выбор облачного провайдера
- Containerization стратегия
- CI/CD pipeline
- Мониторинг и alerting
- Disaster recovery

Создаваемый документ: infrastructure/INFRA_SPEC.md


🔄 WORKFLOW АКТИВАЦИИ АССИСТЕНТА

Шаг 1: Автоопределение типа

User: "Хочу запустить интернет-магазин"

Projector анализирует:
├─ Ключевые слова: "магазин" → BUSINESS
├─ Confidence: 95%
└─ Решение: Активировать Business Assistant

Шаг 2: Совместная работа

ЭТАП: Сбор данных

Projector задаёт:
├─ Универсальные вопросы (5 вопросов)
└─ Определяет уровень (A/B/C/D)

Business Assistant задаёт:
├─ Бизнес-анкету (25 вопросов)
└─ Собирает доменные данные

Шаг 3: Этап КОНТРОЛЬ

После каждого этапа:

1. Projector завершает свою часть
2. Активирует Business Assistant
3. Business Assistant:
   ├─ Проверяет качество
   ├─ Дополняет экспертизой
   ├─ Выявляет упущенное
   └─ Даёт рекомендации
4. Projector интегрирует результаты
5. Переход к следующему этапу

Шаг 4: Создание документов

В конце планирования:

Projector создаёт:
├─ design/PROJECT.md (универсальный план)

Business Assistant создаёт:
└─ design/BUSINESS_PLAN.md (бизнес-план)

📊 СРАВНИТЕЛЬНАЯ ТАБЛИЦА

Ассистент Документ Вопросов Время создания Экономия
Business BUSINESS_PLAN.md 25 4-6ч 95% (vs 80-120ч)
Technical TECHNICAL_SPEC.md 20 3-5ч 95% (vs 60-100ч)
Marketing MARKETING_STRATEGY.md 16 2-3ч 95% (vs 40-60ч)
Design DESIGN_SPEC.md 12 2-4ч 90% (vs 20-40ч)
Data DATA_STRATEGY.md 15 2-3ч 92% (vs 25-35ч)
Infrastructure INFRA_SPEC.md 18 3-4ч 93% (vs 40-50ч)

🚀 СТАТУС

Версия: 1.0.0
Готовность: Production Ready
Всего ассистентов: 6 (основные)

Интеграция:
- ✅ С Projector v2.0
- ✅ С Orchestrator
- ✅ Автоопределение типа
- ✅ Два документа на выходе


Конец спецификации ассистентов