architect/standards/AGENT_ROLES.md

AGENT_ROLES — Стандарт: Роль vs Агент

Версия: 1.0.0
Дата: 2026-03-27


ГЛАВНОЕ ПРАВИЛО

Ты пишешь сам → РОЛЬ (режим диалога)
Работает пока ты спишь → АГЕНТ (автономный процесс)

РОЛЬ

Что это: режим поведения Claude в диалоге с человеком.

Текущие роли:

Маркер Название Зона
Оператор инфра, сервер, БД
Проектор проекты, код, фичи
🔷 ПМ планирование, декомпозиция
Архитектор методология, стандарты
💻 Кодер автономная реализация (подрежим Проектора)

Как работает:

Человек пишет "архитектор сделай X"
  → Claude читает слово "архитектор"
  → Claude меняет поведение (варианты, без кода до согласования)
  → Claude делает X

АГЕНТ

Что это: автономный процесс, работающий без участия человека.

Именование: {функция}-agent

Аналог роли Агент Назначение
Кодер coder-agent пишет код по тикету
Оператор infra-agent обслуживает инфру
sync-agent синхронизация данных
monitor-agent мониторинг системы

Важно: Роль Архитектор и агент architect-agent — не одно и то же. Роль рассуждает с человеком. Агент пишет файлы по алгоритму без диалога.


КАК РАЗЛИЧАТЬ

В разговоре

✅ "переключись в режим Архитектор"   → роль
✅ "запусти агент coder-agent"         → агент

❌ "запусти архитектора"              → неясно

В логах

# Роль (диалог с человеком):
[2026-03-27 10:00] роль=Архитектор сессия=abc123: обновил PLATFORM.md

# Агент (автономно):
[2026-03-27 10:00] агент=architect-agent задача=task-042: обновил PLATFORM.md

В конфигах (schedule.yaml)

# Агент — можно ставить в cron:
schedule:
  - cron: "0 3 * * *"
    agent: infra-agent      ← правильно
    task: rotate-logs

# Роль — нельзя ставить в cron (нет человека):
schedule:
  - agent: Архитектор       ← НЕПРАВИЛЬНО, роль не процесс

ФИЗИЧЕСКАЯ ИЗОЛЯЦИЯ

Роль Агент
Изоляция нужна? ❌ Поведенческая достаточно ✅ Физическая обязательна
Права доступа Как у человека (сессия) Ограниченные (только нужное)
Параллельность Нет (один диалог) Да (несколько агентов)

СВЯЗАННЫЕ ДОКУМЕНТЫ