Документ: ASSISTANTS.md
Версия: 1.0.0
Дата: 2025-11-11
Назначение: Спецификация всех доменных ассистентов для работы с Projector
Ассистенты — доменные эксперты, которые подключаются к Projector для добавления специализированной экспертизы в конкретном направлении.
Принцип работы:
User → Orchestrator → Projector (универсальный фреймворк)
↓
Specialist (доменная экспертиза)
↓
PROJECT.md + {TYPE}_PLAN.md
Момент активации: На этапе КОНТРОЛЬ (после каждого этапа для проверки качества)
Специализация: Бизнес-проекты, стратегия, финансы, маркетинг
Триггеры активации:
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)
└─ Риски: низкие (полный анализ)
Специализация: 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()
);
Code → Build → Test → Deploy
↓ ↓ ↓ ↓
GitHub Actions → Docker → K8s
**Метрики эффективности:**
Без 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%
Специализация: 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
Специализация: Аналитика, отчёты, Data Science, BI
Триггеры активации:
KEYWORDS = [
"данные", "аналитика", "отчёты", "метрики",
"дашборд", "BI", "data science", "ML", "прогнозирование",
"визуализация", "KPI", "метрики"
]
Ключевые функции:
- Проектирование аналитики
- Определение метрик и KPI
- Дашборды и визуализация
- Прогнозные модели (ML)
- A/B тестирование
- ETL процессы
Создаваемый документ: design/DATA_STRATEGY.md
Специализация: DevOps, облака, CI/CD, мониторинг
Триггеры активации:
KEYWORDS = [
"инфраструктура", "DevOps", "облако", "AWS", "GCP", "Azure",
"Docker", "Kubernetes", "CI/CD", "мониторинг", "серверы"
]
Ключевые функции:
- Проектирование инфраструктуры
- Выбор облачного провайдера
- Containerization стратегия
- CI/CD pipeline
- Мониторинг и alerting
- Disaster recovery
Создаваемый документ: infrastructure/INFRA_SPEC.md
User: "Хочу запустить интернет-магазин"
Projector анализирует:
├─ Ключевые слова: "магазин" → BUSINESS
├─ Confidence: 95%
└─ Решение: Активировать Business Assistant
ЭТАП: Сбор данных
Projector задаёт:
├─ Универсальные вопросы (5 вопросов)
└─ Определяет уровень (A/B/C/D)
Business Assistant задаёт:
├─ Бизнес-анкету (25 вопросов)
└─ Собирает доменные данные
После каждого этапа:
1. Projector завершает свою часть
2. Активирует Business Assistant
3. Business Assistant:
├─ Проверяет качество
├─ Дополняет экспертизой
├─ Выявляет упущенное
└─ Даёт рекомендации
4. Projector интегрирует результаты
5. Переход к следующему этапу
В конце планирования:
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
- ✅ Автоопределение типа
- ✅ Два документа на выходе
Конец спецификации ассистентов