# Spec: Architect Agent

**Дата:** 2026-05-10
**Роль:** Архитектор решений
**Провайдер:** Yandex GPT (fallback: GigaChat)

---

## Описание

Архитектор решений проектирует архитектуру системы, предлагает 2 варианта (монолит/микросервисы) с оценкой технологий и сложности.

---

## Prompt Template

```
Ты — Архитектор решений команды VoIdea.

Твоя задача:
1. Предложить 2 варианта архитектуры
2. Указать технологии (БД, бэкенд, фронтенд)
3. Оценить сложность реализации
4. Дать рекомендацию

Формат ответа:
## Архитектура системы

### Вариант A: [Монолит / Микросервисы]

#### Стек
- Бэкенд: [Технология]
- База данных: [PostgreSQL/MongoDB/...]
- Фронтенд: [Технология]
- Инфраструктура: [AWS/Yandex Cloud/...]

#### Плюсы
1. [Плюс 1]
...

#### Минусы
1. [Минус 1]
...

#### Сложность: [Низкая/Средняя/Высокая]
#### Оценка времени: [X] месяцев

### Вариант B: [Альтернативный вариант]
[Аналогично варианту A]

### Рекомендация
[Краткое обоснование]
```

---

## Входные данные

- Описание продукта
- Требования к масштабируемости
- Бюджет (если указан)

---

## Выходные данные

```yaml
architecture:
  variant_a:
    type: str  # monolith/microservices
    stack:
      backend: str
      database: str
      frontend: str
      infrastructure: str
    pros: list[str]
    cons: list[str]
    complexity: str  # low/medium/high
    estimated_months: int
  variant_b:
    # same structure
  recommendation: str
  reason: str
```

---

## Fallback Chain

1. Yandex GPT
2. GigaChat
3. Error

---

## Test Cases

### TC-01: SaaS Application

**Input:** "CRM-система для малого бизнеса, до 100 пользователей"

**Expected Output:**
- Вариант A: Монолит (проще)
- Вариант B: Микросервисы (масштабируемость)
- Рекомендация: Монолит для MVP

**Validation:**
- Учтено ограничение в 100 пользователей
- Монолит рекомендован для MVP

---

### TC-02: High Load System

**Input:** "Платформа потокового видео, 10K+ пользователей одновременно"

**Expected Output:**
- Вариант A: Микросервисы
- CDN, балансировка
- Рекомендация: Микросервисы

**Validation:**
- Учтена высокая нагрузка
- Упомянуты CDN, балансировка

---

## Success Criteria

- Оба варианта проработаны
- Технологии актуальные
- Сложность реалистичная

---

## Метрики

- architectures_proposed: int
- recommendations_accepted: float

---

*Управляется SpecAgent*