Концепция AI-агентов

Версия: 2.0.0
Дата: 2025-12-21
Статус: draft

ПРОБЛЕМА

Текущее состояние:
- Агенты существуют отдельно от протокола CLAUDE.md
- Дублирование контента между агентами и протоколом
- Нет чёткой иерархии и ролей
- Структура заточена только под IT-проекты
- Нет разделения по масштабу (личное/бизнес/социальное)

АРХИТЕКТУРА

Верхний уровень — 3 ассистента

                    ┌─────────────┐
                    │   ЧЕЛОВЕК   │
                    └──────┬──────┘
                           │
                    ┌──────▼──────┐
                    │  ДИСПЕТЧЕР  │  ← Простой роутер
                    │ (dispatcher)│
                    └──────┬──────┘
                           │
         ┌─────────────────┼─────────────────┐
         │                 │                 │
   ┌─────▼─────┐    ┌─────▼─────┐    ┌─────▼─────┐
   │  ЛИЧНЫЙ   │    │  БИЗНЕС   │    │СОЦИАЛЬНЫЙ │
   │ personal  │    │ business  │    │  social   │
   └─────┬─────┘    └─────┬─────┘    └─────┬─────┘
         │                │                │
         └────────────────┼────────────────┘
                          │
                    ┌─────▼─────┐
                    │ ПРОЕКТОР  │
                    └─────┬─────┘
                          │
                   Специалисты...

Три ассистента — равные

Диспетчер — минимальный

Только маршрутизация по триггерам:

ПОЛНАЯ ИЕРАРХИЯ

По 9 вопросам

ПОЧЕМУ → ЗАЧЕМ → ЧТО → КТО → КАК → ЧЕМ → ГДЕ → КОГДА → СКОЛЬКО

СПЕЦИАЛИСТЫ

Специалист отвечает на вопрос КТО в своём домене:
- Кто пользователь?
- Кто стейкхолдер?
- Кто конкурент?
- Кто партнёр?

Список специалистов

Что делает специалист

1. Квалифицирует проект (тип, уровень)
2. Задаёт вопросы по своему домену
3. Создаёт спецификацию (BUSINESS_PLAN, TECH_SPEC, etc.)
4. Делегирует исполнителям

УРОВНИ ПРОЕКТОВ

Из архива AI Projector:

Матрица вовлечённости

ИСПОЛНИТЕЛИ

Исполнитель отвечает на вопрос КАК:
- Как написать код?
- Как настроить сервер?
- Как интегрировать API?
- Как проанализировать данные?

Список исполнителей

СТЕКИ

Стек отвечает на вопрос ЧЕМ:
- Какие библиотеки?
- Какие паттерны?
- Какие конфиги?

Список стеков

WORKFLOW

Проект уровня B-C

1. ВХОД
   Человек: "Нужен API для интернет-магазина"

2. ПРОЕКТОР (L2)
   ├── Определяет: IT-проект, уровень B
   └── Передаёт: Technical specialist

3. СПЕЦИАЛИСТ Technical (L3)
   ├── Вопросы: endpoints? auth? данные?
   ├── Создаёт: TECHNICAL_SPEC.md
   └── Делегирует: Coder + стек FastAPI

4. ИСПОЛНИТЕЛЬ Coder (L4)
   ├── Загружает: стек FastAPI
   ├── Пишет: код по спецификации
   └── Результат: готовый API

5. ВЫХОД
   Отчёт человеку

Проект уровня D (микро)

1. ВХОД
   Человек: "Исправь баг в форме"

2. ПРОЕКТОР (L2)
   ├── Определяет: уровень D
   └── Передаёт напрямую: Coder

3. ИСПОЛНИТЕЛЬ Coder (L4)
   ├── Находит баг
   ├── Исправляет
   └── Результат: фикс

4. ВЫХОД
   Отчёт человеку

АВТО-ОПРОСНИК

Из архива ASSISTANTS.md — каждый специалист имеет набор вопросов:

Business (25 вопросов)

Базовые:
- Название бизнеса?
- Сфера деятельности?
- Целевая аудитория?

Продукт:
- Что продаёте?
- В чём уникальность?
- Средний чек?

Каналы:
- Как привлекаете клиентов?
- Какие каналы работают?
- Бюджет на маркетинг?

Technical (20 вопросов)

Система:
- Что должна делать?
- Кто пользователи?
- Нагрузка?

Интеграции:
- С чем интегрировать?
- Какие API?
- Форматы данных?

Инфра:
- Где хостить?
- Требования к uptime?
- Бюджет?

ВЫХОДНЫЕ ДОКУМЕНТЫ

Каждый специалист создаёт свой документ:

СТРУКТУРА ФАЙЛОВ

system/agents/
├── CLAUDE.md               ← Индекс агентов
├── dispatcher.ai.md        ← Диспетчер (роутер)
│
├── assistants/             ← Три ассистента верхнего уровня
│   ├── personal.ai.md      ←   Личный (я, саморазвитие)
│   ├── business.ai.md      ←   Бизнес (компания, прибыль)
│   └── social.ai.md        ←   Социальный (общество, импакт)
│
├── projector.ai.md         ← Универсальный проектор
├── librarian.ai.md         ← Управление library/
│
├── specialists/            ← Доменные специалисты
│   ├── business.ai.md      ←   Бизнес-процессы
│   ├── technical.ai.md     ←   IT-проекты
│   ├── marketing.ai.md     ←   Маркетинг
│   ├── data.ai.md          ←   Аналитика
│   ├── design.ai.md        ←   Дизайн
│   └── infrastructure.ai.md ←  Инфраструктура
│
├── workers/                ← Исполнители
│   ├── coder.ai.md
│   ├── infra.ai.md
│   ├── integrator.ai.md
│   └── analyst.ai.md
│
└── stacks/                 ← Технологические стеки
    ├── fastapi.ai.md
    ├── scrapy.ai.md
    ├── vue.ai.md
    └── drupal.ai.md

Примечание: specialists/business.ai.md ≠ assistants/business.ai.md
- assistants/business.ai.md — уровень ЗАЧЕМ (бизнес как контекст)
- specialists/business.ai.md — уровень КТО (бизнес-специфика)

СВЯЗЬ С CLAUDE.md

Что остаётся в /CLAUDE.md

• Три режима (Оператор, Проектор, Архитектор)
• Уровни решений L0-L4
• Общие правила
• Триггеры переключения

Что в агентах

• Специфика домена/роли
• Опросники
• Шаблоны документов
• Связи между агентами

МИГРАЦИЯ

Текущее состояние

✅ Создано:
- specialists/business.ai.md
- specialists/technical.ai.md
- specialists/marketing.ai.md
- specialists/data.ai.md
- specialists/design.ai.md
- workers/coder.ai.md
- workers/infra.ai.md
- workers/integrator.ai.md
- workers/analyst.ai.md

❌ Нужно:
- [ ] Создать assistants/ (3 файла)
- [ ] Создать dispatcher.ai.md
- [ ] Обновить projector.ai.md (роль проектора)
- [ ] Создать specialists/infrastructure.ai.md
- [ ] Добавить опросники во всех специалистов
- [ ] Добавить шаблоны документов
- [ ] Создать недостающие стеки
- [ ] Обновить CLAUDE.md (индекс агентов)

РЕШЁННЫЕ ВОПРОСЫ

1. Верхний уровень — три ассистента (Личный/Бизнес/Социальный)
2. Диспетчер — простой роутер, не думает
3. Личный ассистент = стратег (понимает ценности человека)

ОТКРЫТЫЕ ВОПРОСЫ

1. Инфраструктура — specialist + worker или только worker?
   - Решение: оба — specialist определяет архитектуру, worker настраивает

2. Data vs Analyst — пересечение ролей?
   - Решение: specialist Data = ЧТО анализировать, worker Analyst = КАК

3. Множественные домены — кто координирует?
   - Решение: Проектор координирует нескольких specialists

Версия: 2.0.0