Дата создания: 2025-11-11
Статус: DRAFT - Новая концепция
Назначение: Полная архитектура платформы с ролями и типами ассистентов
Платформа = набор связанных приложений на ИИ с документами и кодом
Каждое приложение:
- Использует ИИ агента (Claude Code)
- Имеет документы (инструкции, методики, данные)
- Имеет код (генераторы, утилиты, интеграции)
- Производит результат
Claude Code - универсальный исполнитель
Читает инструкции → выполняет задачи → производит результат
Набор приложений, каждое из которых:
Приложение = ИИ + Документы + Код
Типы приложений:
1. Orchestrator - координатор всех приложений
2. Projector - управление проектами
3. Designer - проектирование систем
4. Developer - разработка кода
5. Tester - тестирование
6. Deployer - развёртывание
7. Monitor - мониторинг
8. Workspace - организация
9. Documenter - документирование
Готовые проекты, созданные платформой:
projects/
├── marketplace/ ← интернет-магазин
├── @infra-*/ ← инфраструктура
└── cifra/ ← НОВАЯ ПЛАТФОРМА (bootstrap)
Роль: Создание новых агентов и приложений
Задачи:
- Проектирует архитектуру агента
- Пишет инструкции
- Создаёт структуру
- Запускает в работу
Компонент: ia-01-396 AI Architect
Роль: Управление всей системой
Задачи:
- Управляет доступами
- Настраивает конфигурацию
- Ведёт логи и журналы
- Контролирует ресурсы
Компонент: admin/
Роль: Координация работы всех агентов
Задачи:
- Принимает запросы пользователя
- Определяет нужные агенты
- Координирует выполнение
- Собирает результаты
Компонент: orchestrator/
Каждый агент специализируется на своей области:
Projector - управление проектами
Designer - проектирование
Developer - разработка
Tester - тестирование
Deployer - развёртывание
Monitor - мониторинг
Задачи:
- Читают инструкции
- Используют документы/код
- Производят результат
- Отчитываются
Компоненты: projector/, designer/, developer/, etc.
Роль: Развитие агентов
Задачи:
- Добавляет новые функции
- Исправляет баги
- Обновляет инструкции
- Улучшает код/документы
Роль: Проверка работы агентов
Задачи:
- Тестирует результаты
- Ищет ошибки
- Валидирует качество
- Отправляет отчёты
Роль: Оптимизация работы
Задачи:
- Анализирует метрики
- Находит узкие места
- Предлагает улучшения
- Корректирует нагрузку
Роль: Защита системы
Задачи:
- Ищет уязвимости
- Проверяет безопасность
- Блокирует атаки
- Обновляет защиту
Роль: Восстановление агентов
Задачи:
- Диагностирует проблемы
- Восстанавливает работу
- Откатывает изменения
- Возвращает к работе
Компонент: recovery/
Роль: Наблюдение за системой
Задачи:
- Собирает метрики
- Следит за здоровьем
- Обнаруживает проблемы
- Отправляет уведомления
Роль: Запись всех событий
Задачи:
- Логирует действия
- Ведёт журналы
- Создаёт отчёты
- Обеспечивает аудит
Компонент: ii-02-396 System Journal
Структура:
assistant/
└── docs/
├── instructions.md
├── rules.md
└── examples.md
Характеристики:
- Только текст
- Нет кода
- Инструктирует агента
Примеры:
- Правила общения
- Методологии
- Справочники
Структура:
assistant/
├── code/
│ ├── generators/
│ ├── validators/
│ └── utilities/
└── docs/
└── API.md
Характеристики:
- В основном код
- Минимум документов
- Готовые функции
Примеры:
- Генераторы кода
- Валидаторы
- Утилиты
Структура:
assistant/
└── docs/
├── reference/
├── best-practices/
└── examples/
Характеристики:
- База знаний
- Нет кода
- Справочная информация
Примеры:
- Методологии
- Best practices
- Паттерны
Структура:
assistant/
├── code/
│ ├── adapters/
│ ├── connectors/
│ └── clients/
└── docs/
├── protocols.md
└── api-specs.md
Характеристики:
- Коннекторы к внешним системам
- Код + документация
- Адаптеры и клиенты
Интеграции:
- MCP серверы (Claude MCP protocol)
- REST API (внешние сервисы)
- WebSocket (real-time)
- GraphQL (гибкие запросы)
- Сторонние AI (OpenAI, Anthropic)
Структура:
assistant/
├── code/
│ ├── drivers/
│ ├── protocols/
│ └── handlers/
└── docs/
└── specifications.md
Характеристики:
- Низкоуровневый доступ
- Протоколы и драйверы
- Системный уровень
Примеры:
- Физические устройства (IoT, sensors)
- Системные процессы (cron, systemd)
- Базы данных (PostgreSQL, Redis)
- Файловые системы
Структура:
assistant/
├── ai/
│ ├── instructions/
│ └── prompts/
├── docs/
│ ├── methodologies/
│ ├── templates/
│ └── reference/
└── code/
├── generators/
└── integrations/
Характеристики:
- Всё вместе
- Инструкции + код + документы
- Полнофункциональное приложение
Примеры:
- Projector
- Designer
- Developer
platform/{app-name}/
│
├── APP.md ← Описание приложения
│ ├─ Название
│ ├─ Назначение
│ ├─ Входы/Выходы
│ ├─ Тип (doc/code/ref/integration/driver/hybrid)
│ └─ Связи с другими приложениями
│
├── ai/ ← ИИ компонент (если есть)
│ ├─ instructions.md ← Инструкции для ИИ
│ ├─ prompts/ ← Промпты для задач
│ └─ modes/ ← Режимы работы
│
├── docs/ ← Документы
│ ├─ methodologies/ ← Методики
│ ├─ templates/ ← Шаблоны
│ ├─ guides/ ← Руководства
│ └─ reference/ ← Справочники
│
├── code/ ← Код (если есть)
│ ├─ generators/ ← Генераторы
│ ├─ validators/ ← Валидаторы
│ ├─ utilities/ ← Утилиты
│ ├─ integrations/ ← Интеграции
│ └─ drivers/ ← Драйверы
│
└── tests/ ← Тесты
├─ unit/
├─ integration/
└─ e2e/
┌─────────────────────────────────────────┐
│ ORCHESTRATOR │
│ ├─ Маршрутизация запросов │
│ ├─ Координация выполнения │
│ └─ Сбор результатов │
└─────────────────────────────────────────┘
│ │ │
┌────┴───┐ ┌──┴────┐ ┌──┴────┐
│Projector│ │Designer│ │ Dev │
└────┬───┘ └──┬────┘ └──┬────┘
│ │ │
└─────────┴─────────┘
│
┌─────▼─────┐
│ projects/ │
└───────────┘
# Запрос от пользователя
request = {
"task": "Создать CRM систему",
"context": {...}
}
# Orchestrator обрабатывает
orchestrator.process(request)
↓
# Определяет план
plan = [
("Projector", "создать структуру"),
("Designer", "спроектировать архитектуру"),
("Developer", "написать код"),
]
↓
# Выполняет последовательно
for (app, task) in plan:
result = app.execute(task, context)
context.add(result)
↓
# Возвращает результат
return projects/crm/
Первый вопрос: Понять намерение пользователя
Пользователь: "Создать интернет-магазин"
↓
Анализ:
├─ Тип задачи: создание проекта
├─ Нужное приложение: Projector
├─ Контекст: новый проект
└─ Уровень: projects/
Определить роль для текущей задачи:
Если создание проекта → ORCHESTRATOR + PROJECTOR
Если разработка кода → DEVELOPER
Если исправление бага → DOCTOR + EDITOR
Если тестирование → TESTER
Сообщить пользователю:
✅ Активирован: ORCHESTRATOR + PROJECTOR
📋 Задача: Создание интернет-магазина
🎯 План:
1. Собрать требования (Projector)
2. Спроектировать (Designer)
3. Создать структуру (Projector)
4. Начать разработку (Developer)
Принципы:
- Краткость и чёткость
- Факты > эмоции
- Никакой лести
- Формат "Плюсы / Минусы / Рекомендация"
Запрещено:
❌ "Отличная идея!"
❌ "Великолепно!"
❌ "Это будет потрясающе!"
Правильно:
✅ "Плюсы: быстрый старт, простая реализация
Минусы: ограничения масштабирования
Рекомендация: подходит для MVP"
Сообщать что делается:
🔄 Projector: создаю структуру проекта...
✅ Создано: projects/marketplace/
├─ design/
├─ solution/
└─ infrastructure/
📝 Designer: проектирую архитектуру БД...
✅ Создан: design/DATABASE.md
При проблемах:
🚨 ОШИБКА: не удалось создать проект
🔍 Диагностика:
├─ Директория уже существует
└─ Конфликт с существующим проектом
💡 Варианты:
1. Использовать другое имя
2. Удалить существующий проект
3. Объединить с существующим
Что выбираете?
Перед критическими действиями:
⚠️ ВНИМАНИЕ: Следующие действия необратимы:
• Удаление projects/old-project/
• Создание новой структуры
• Инициализация git репозитория
Продолжить? (да/нет)
Использовать журналы:
📖 Восстановление контекста...
Последняя сессия:
├─ Проект: marketplace
├─ Этап: проектирование БД
├─ Статус: 60% выполнено
└─ Следующий шаг: создать API спецификацию
Продолжаем?
1. Начать диалог:
Просто опишите что хотите сделать
2. Система определит:
- Нужную роль
- Нужное приложение
- План действий
3. Согласовать и выполнить:
- Проверить план
- Подтвердить
- Получить результат
1. Создать новое приложение:
platform/{app-name}/
├── APP.md (описание)
├── ai/ (если нужен ИИ)
├── docs/ (документы)
└── code/ (если нужен код)
2. Зарегистрировать в Orchestrator:
orchestrator/apps.yaml:
- name: my-app
type: hybrid
triggers: ["keywords"]
roles: [worker, tester]
3. Протестировать:
Запустить тесты
Проверить интеграцию
Обновить документацию
Версия: 2.0.0
Дата: 2025-11-11
Статус: DRAFT - требует обсуждения