Files
voidea/template/docs/agents/00-agents-overview.md

62 lines
3.0 KiB
Markdown

# Обзор системных агентов
---
## Что такое системный агент
Системный агент — это программа, которая автоматизирует поддержку и развитие проекта.
В отличие от 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 часа)
- Кто будет поддерживать агентов? (те же разработчики)