architect/concept/ROLES.md

type: concept
title: Роли и модули платформы
status: active
version: 2.0.0
date: 2026-04-09
knowledge_level: У0

Роли и модули платформы

Вытекает из: PLATFORM.md
Связан с: AGENTS.md

Концепция

Платформа разделена на шесть слоёв-компонентов. В каждом слое живут модули.
Модуль реализует один процесс и содержит агентов — исполнителей ролей.

Этот документ описывает семь ключевых модулей и их взаимосвязи.
Детали внутреннего устройства — в У1-стандартах.

Базовые определения

Понятие Что это
Компонент Папка верхнего уровня (arch/, project/, domains/, infra/, system/, services/)
Модуль @name.type/ — автономная функциональная единица внутри компонента
Роль Функция внутри модуля (intake, planner, deployer …)
Агент Файл {name}.ai.md — определение роли для Claude Code

Детали — AGENTS.md.

Шесть слоёв платформы

arch/       — знания         (стандарты, методология)
project/    — управление     (проектирование, управление, тестирование)
domains/    — исполнение     (IT, производство, бизнес, данные)
infra/      — инфраструктура (деплой, поддержка)
system/     — общее          (библиотеки, коннекторы, MCP)
services/   — сервисы        (планировщик, мониторинг)

Семь модулей

Модуль Слой Процесс Роли внутри
@architect arch/ Стандарты и методология analyst, writer, reviewer
@projector.module project/ Проектирование (фазы 0–6) intake, researcher, analyst, designer
@manager.module project/ Управление (фазы 7–15) planner, coordinator, controller
@tester.module project/ Тестирование planner, executor, reporter
@it.domain domains/ Диспетчер IT-домена dispatcher
@executor.module infra/ Деплой provisioner, deployer, monitor
@support.module infra/ Поддержка после релиза incident, patcher, updater

Назначение модулей

@architect — знания

Хранит стандарты, методологию, паттерны. Не ведёт проекты.
Отвечает на вопрос как правильно. Обслуживает всех остальных.

@projector.module — проектирование

Входная точка для нового проекта. Проводит фазы 0–6:
приём заявки, исследование, анализ, проектирование.
На выходе — согласованный дизайн и передача в @manager.module.

@manager.module — управление

Ведёт проект от дизайна до релиза (фазы 7–15).
Координирует исполнителей: @it.domain, @tester.module, @executor.module.
Контролирует сроки, статусы, передачи.

@tester.module — тестирование

Планирует и выполняет проверку результатов.
Работает по запросу от @manager.module, независим от исполнителей.

@it.domain — диспетчер IT

Один из доменов исполнения. Принимает задачу от @manager.module,
определяет технологический стек и передаёт в соответствующий
@стек.coder/ (база знаний стека). Сам код не пишет.

@executor.module — деплой

Готовит инфраструктуру и выкатывает релизы.
Работает по заданию от @manager.module после тестирования.

@support.module — поддержка

Сопровождает ПО после релиза: инциденты, патчи, обновления.
Работает независимо от @manager.module.

Иерархия подчинения

Оператор
│
├── arch/ @architect ─────────── стандарты (обслуживает всех)
│
├── project/
│   ├── @projector.module ─────► @manager.module
│   │                                 │
│   │                                 ├── domains/ @it.domain ──► @стек.coder/
│   │                                 ├── project/ @tester.module
│   │                                 └── infra/   @executor.module
│   │
│   └── (после релиза)
│
└── infra/ @support.module ───── сопровождение ПО

system/   — библиотеки, коннекторы, MCP     │ обслуживают
services/ — планировщик, мониторинг         │ все модули

Потоки работы

Новый проект

Оператор
  → @projector.module   (фазы 0–6: дизайн)
  → @manager.module     (фазы 7–15: управление)
      → @it.domain      → @стек.coder/  (реализация)
      → @tester.module                   (проверка)
      → @executor.module                 (деплой)
  → @support.module     (сопровождение)

Изменение стандарта

Оператор → @architect → обновление в arch/ → используют все модули

Инцидент в production

Мониторинг (services/) → @support.module → патч → @executor.module

Эволюция исполнения кода

Роль «кодера» развивается в три шага:

Версия Состояние Кто пишет код
v1 было Claude Code пишет напрямую
v2 строим @it.domain → диспетчер → @стек.coder/ (база знаний стека)
v3 будущее Только конфиги, кода нет («Проект Цифра»)

На текущем этапе платформа работает в v2.

Что НЕ является модулем

Ссылки