architect/decisions/001-agents.md

ADR: Архитектура агентов платформы

Дата: 2025-12-06
Статус: APPROVED
Участники: Оператор, Claude


Контекст

Обсуждение архитектуры агентов платформы: какие агенты нужны, как они взаимодействуют, как работает сбор первичной информации от клиентов.


Решения

1. Структура агентов

ТЕРМИНАЛ (точка входа, CLAUDE.md)
    │
    ├── АРХИТЕКТОР — методология платформы
    │   └── Режимы: Теория, Стандарты, Паттерны, Шаблоны
    │
    ├── ПРОЕКТОР — ведение проекта (15 фаз)
    │   └── Фазы: 0-14 (см. PROJECTOR.md)
    │
    └── СУПЕРАГЕНТ 256 — сбор первички от клиента
        └── Каналы: WhatsApp, Telegram, (свой чат)

2. Жизненный цикл проекта (обновлённый)

ИНИЦИАЦИЯ
├── 0.  Триггер         — что-то произошло
├── 0.5 INTAKE (NEW)    — сбор первички → MASTER.md
└── 1.  Понимание       → BRIEF.md

ИССЛЕДОВАНИЕ
├── 2.  Исследование    → RESEARCH.md
├── 3.  Анализ          → ANALYSIS.md
└── 4.  Требования      → REQUIREMENTS.md

ПРОЕКТИРОВАНИЕ
├── 5.  Проектирование  → DESIGN.md
└── 6.  Валидация       → VALIDATION.md

ИСПОЛНЕНИЕ
├── 7.  Планирование    → TODO.md
├── 8.  Подготовка
└── 9.  Реализация

ПРОВЕРКА
├── 10. Тестирование
├── 11. Внедрение
└── 12. Приёмка         → ACCEPTANCE.md

ЭКСПЛУАТАЦИЯ
├── 13. Эксплуатация    → METRICS.md
└── 14. Улучшение       → цикл

3. MASTER.md — центральный документ проекта

Назначение: Компактный индекс + ключевые факты + ссылки на всё

Характеристики:
- Компактный (1-2 экрана)
- Индексный (ссылки, не дублирует)
- Актуальный (обновляется на каждой фазе)
- Точка входа (читаешь → понимаешь где что)

Содержит:
- Суть проекта (3-5 предложений)
- Ключевые факты (таблица параметров)
- Стейкхолдеры
- Ссылки на документы проекта
- Внешние ссылки (сайты, API, конкуренты)
- Ссылки на файлы
- Открытые вопросы
- Следующий шаг

4. Флоу работы с клиентом

1. СОЗДАНИЕ ПРОЕКТА
   ├── Создаётся папка на S3: $DATASPACE/projects/{project-id}/
   ├── Генерируется публичный ключ доступа
   ├── Кладётся MASTER_BRIEF.md (шаблон для заполнения)
   └── Клиенту отправляется ссылка + инструкция

2. КЛИЕНТ ЗАПОЛНЯЕТ
   ├── Заполняет MASTER_BRIEF.md
   ├── Загружает файлы в папку inbox/
   └── Пишет в WhatsApp

3. СУПЕРАГЕНТ 256
   ├── Платформа: WhatsApp (первый канал)
   ├── Видит папку клиента на S3
   ├── Читает что клиент загрузил
   ├── Общается, уточняет, помогает
   └── Формирует финальный MASTER.md

4. ПЕРЕДАЧА В ПРОЕКТОР
   ├── MASTER.md готов и согласован
   └── Проектор начинает работу с Фазы 1

5. Структура папки проекта на S3

$DATASPACE/projects/{project-id}/
├── _access.key           ← Ключ доступа (публичный)
├── MASTER_BRIEF.md       ← Шаблон для клиента
├── MASTER.md             ← Финальный (создаёт агент)
├── inbox/                ← Клиент кладёт сюда всё
│   ├── tz.docx
│   ├── logo.png
│   └── ...
└── chat/                 ← Лог переписки (опц.)
    └── history.json

6. Отбивки агентов

Терминал (обычный):

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
2025-12-06 12:55 | Workspace / Режим / Фокус
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Архитектор (жирный):

▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲
▲  ARCHITECT MODE | 2025-12-06 12:55                        ▲
▲  Методология / Теория / Стандарты                         ▲
▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲▲

Проектор:

◆═══════════════════════════════════════════════════════════◆
  PROJECT: {name} | 2025-12-06 12:55                       
  Фаза {N}: {название}                                     
◆═══════════════════════════════════════════════════════════◆

Компоненты для реализации

# Компонент Тип Статус
1 MASTER_BRIEF.md Шаблон TODO
2 @architect.agent/CLAUDE.md Агент TODO
3 @projector.agent/CLAUDE.md Агент TODO
4 СУПЕРАГЕНТ 256 Бот WhatsApp TODO
5 Скрипт создания проекта на S3 Скрипт TODO
6 Обновить PROJECTOR.md (фаза INTAKE) Документ TODO
7 SessionStart hook (startup.sh) Hook DONE

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

Вопрос Решение
Хранилище проектов Beget S3 ($DATASPACE/)
Первый канал связи WhatsApp
Защита Архитектора Пока без фильтра, явный переход

Связи


Версия: 1.0.0