type: standard
layer: arch
object: agent
aspect: registry
form: table
title: "Реестр агентов платформы"
status: active
version: 1.0.0
date: 2026-04-11
knowledge_level: У1
parent: arch-component-structure.md
deps:
- arch-component-structure.md
- arch-platform-policy.md
- arch-monitor-protocol.md
- arch-class-system.md

Реестр агентов платформы

Единый реестр всех AI-агентов платформы: роли, зоны ответственности, уровни операций L0–L4, интерфейсы вызова.

1. НАЗНАЧЕНИЕ

Реестр решает три задачи:
- Однозначно определяет кто такой каждый агент
- Указывает уровень операций (L0–L4) каждого агента
- Описывает как агент вызывается и что возвращает

2. РЕЕСТР

Системные агенты (system/)

Агент	Роль	L-уровни	Статус
`@keeper.agent`	Хранитель заблокированных файлов	L4 только	✅ active
`@sentinel.agent`	Контроль П1 КОНФИДЕНЦИАЛЬНОСТЬ	L0 (мониторинг)	✅ active
`@analyzer.agent`	Анализ разрывов, отчёты	L0 (чтение)	✅ active

Процессные агенты (platform roles)

Агент	Роль	L-уровни	Статус
`@architect`	Стандарты и методология	L0–L2	✅ active
`@projector`	Проектирование, фазы 0–6	L0–L2	✅ active
`@manager`	Управление проектом, фазы 7–15	L0–L2	✅ active
`@executor`	Деплой и инфраструктура	L0–L3	✅ active
`@coder`	Написание кода	L0–L2	✅ active
`@tester`	Тестирование	L0–L1	✅ active
`@support`	Поддержка после релиза	L0–L2	✅ active

Специализированные кодеры (coder/)

Агент	Роль	Стек	Статус
`@drupal.coder`	Разработка Drupal-проектов	Drupal 10/11	✅ active
`@python.coder`	Python/FastAPI разработка	Python 3.11+	⏸ в разработке
`@nextjs.coder`	Frontend Next.js	Next.js 14+	⏸ в разработке

3. ДЕТАЛЬНЫЕ КАРТОЧКИ

@keeper.agent

Класс:      AgentComponent
Слой:       system/
Путь:       system/@keeper.agent/
Уровни:     L4 (разблокировка — ТОЛЬКО с явного "да" оператора)

Зона ответственности: theory/*.fx.md, METAMODEL.md, архивные эталоны

Интерфейс вызова:

Триггеры: "разблокируй [файл]", "нужно изменить [LOCKED-файл]"
Протокол: 9 шагов (см. system/@keeper.agent/AI.md)
Возвращает: подтверждение разблокировки / отказ

Когда НЕ вызывать: любые операции с незаблокированными файлами

@sentinel.agent

Класс:      AgentComponent
Слой:       system/
Путь:       system/@sentinel.agent/
Уровни:     L0 (пассивный мониторинг, встроен во все агенты)

Зона ответственности: П1 КОНФИДЕНЦИАЛЬНОСТЬ — 6 категорий

Интерфейс: встроен в финал каждого агента автоматически

[SENTINEL CHECK]
  1. credentials: нет ✅ / ОБНАРУЖЕНО ⛔
  2. platform code: нет ✅ / ОБНАРУЖЕНО ⛔
  3. agent rules: нет ✅ / ОБНАРУЖЕНО ⛔
  4. workspace structure: нет ✅ / ОБНАРУЖЕНО ⛔
  5. client data: нет ✅ / ОБНАРУЖЕНО ⛔
  6. infrastructure: нет ✅ / ОБНАРУЖЕНО ⛔
→ ответ разрешён / заблокирован

При нарушении → ответ блокируется → алерт в system/monitor/alerts/CRITICAL/

@analyzer.agent

Класс:      AgentComponent
Слой:       system/
Путь:       system/@analyzer.agent/
Уровни:     L0 (чтение и анализ)

Зона ответственности: выявление GAP-разрывов в платформе

Режимы:

Режим	Триггер	Результат
TACTICAL	реальное время	немедленный отчёт агенту
STRATEGIC	ежедневно / по запросу	`system/monitor/reports/DAILY_YYYYMMDD.md`

Интерфейс вызова:

Триггеры: "найди разрывы", "анализ архитектуры", "что не соответствует стандарту"
Возвращает: GAP_REPORT с классифицированными разрывами и рекомендациями

@architect

Класс:      ProcessRole (не AgentComponent)
Уровни:     L0–L2

Зона: arch/ — методология, стандарты, теория

Триггеры: "стандарт", "методология", "архитектура", "теория", "принцип"

Что делает: обсуждает → предлагает варианты → фиксирует в arch-*.md

Что НЕ делает: код до согласования архитектуры

@coder / @drupal.coder

Класс:      CoderComponent (для @drupal.coder)
Уровни:     L0–L2

Зона: coder/ — написание и рефакторинг кода

Специализация @drupal.coder:
- Модули Drupal: hook системы, services, event subscribers
- Commerce: продукты, вариации, заказы
- Кастомные импортёры (Batch API)

4. УРОВНИ ОПЕРАЦИЙ АГЕНТОВ

Уровень	Что	Агенты
L0	Чтение, анализ, поиск	все
L1	Документы (.md, .yaml)	@architect, @projector, @manager, @support
L2	Код (.py, .js, .php, .ts)	@coder, @drupal.coder, @executor, @tester
L3	Сервер (nginx, docker, /etc/)	@executor
L4	Опасные операции, LOCKED-файлы	@keeper

Правило: агент НЕ выполняет операции выше своего уровня.

5. РЕГИСТРАЦИЯ НОВОГО АГЕНТА

При добавлении нового агента в платформу:

1. Создать system/@{имя}.agent/ (или coder/@{стек}.coder/)
2. Заполнить AI.md: роль, уровни L0-L4, sentinel: enabled
3. Создать index.yaml: class: AgentComponent, extends: projector/templates/@agent/
4. Зарегистрировать здесь в §2
5. Обновить arch-monitor-protocol.md если новый тип отчётности

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

Родитель:
- arch-component-structure.md — структура компонентов

Связанные:
- arch-monitor-protocol.md — протокол отчётности агентов
- arch-platform-policy.md — П6 АГЕНТЫ
- arch-class-system.md — AgentComponent
- arch-workspace-structure.md — system/, coder/