# Обзор системных агентов

---

## Что такое системный агент

Системный агент — это программа, которая автоматизирует поддержку и развитие проекта.
В отличие от AI-агента (который анализирует пользовательские данные), системный агент работает **над проектом**: пишет документацию, проверяет правила, версионирует код.

---

## Когда внедрять агентов

**С первого коммита.** 4 ядерных агента создаются сразу.
Остальные — по мере возникновения потребности.

---

## Отличие системного агента от AI-агента

| Характеристика | Системный агент | AI-агент |
|---------------|-----------------|-----------|
| Что делает | Поддерживает проект | Анализирует данные пользователя |
| Кто запускает | Триггеры (pre-commit, cron) | Пользователь (через UI) |
| Результат | Чистый код, docs, версии | Анализ идеи, рекомендации |
| Пример | DocAgent пишет docstrings | Координатор анализирует идею |
| Версионируется | Да (A.B.C независимо) | Нет |

---

## Ядро (4 агента, обязательны)

| # | Агент | Роль | Триггеры |
|---|-------|------|----------|
| 1 | **DocAgent** | Пишет документацию | pre-commit, manual |
| 2 | **AuditAgent** | Проверяет правила | pre-commit, push, cron |
| 3 | **EvolutionAgent** | Версионирует агентов | cron, event, manual |
| 4 | **SupervisorAgent** | Следит за всеми агентами | cron, event, manual |

---

## Расширение (по необходимости)

| # | Агент | Когда добавлять |
|---|-------|----------------|
| 5 | **QATesterAgent** | Появились тесты |
| 6 | **FixAgent** | Пойман первый баг |
| 7 | **BacklogAgent** | Появился техдолг |
| 8 | **SecurityAgent** | Перед production |
| 9 | **SpecAgent** | Перед релизом |
| 10 | **RolloutAgent** | Перед деплоем |
| 11 | **ObserverAgent** | После запуска |
| 12 | **UITestAgent** | Есть UI |

---

## [ASK] Вопросы по агентам

- Сколько агентов нужно сейчас? (рекомендация: 4 ядерных, потом по необходимости)
- Есть ли ресурс на разработку агентов? (DocAgent ≈ 2 часа, AuditAgent ≈ 4 часа)
- Кто будет поддерживать агентов? (те же разработчики)