architect/standards/3-process/process-role-management.md

type: standard
aspect: process
title: "Стандарт: Управление ролями"
version: 1.0.0
date: 2026-02-19
status: active

Стандарт: Управление ролями

Версия: 1.0.0
Дата: 2025-11-28
Уровень: У1 (Правила)

Вытекает из: ../../concept/PLATFORM.md → Агенты

НАЗНАЧЕНИЕ

Правила подгрузки и выгрузки ролей для экономии токенов.

ПРИНЦИП

Роль = файл *.ai.md = контекст = токены

ЗАГРУЖЕНО МНОГО РОЛЕЙ → МНОГО ТОКЕНОВ → ДОРОГО
ЗАГРУЖЕНА ОДНА РОЛЬ   → МАЛО ТОКЕНОВ  → ДЁШЕВО

ПРАВИЛО: Загружать МИНИМУМ необходимых ролей

АРХИТЕКТУРА РОЛЕЙ

Уровни ролей

ПОСТОЯННЫЕ (всегда загружены):
├── CLAUDE.md           ~500 токенов — терминал (корневой)

ПО ТРЕБОВАНИЮ (загружаются при необходимости):
├── architect.ai.md     ~500 токенов — методология
├── projector.ai.md     ~400 токенов — проекты
├── coder-v1.ai.md      ~400 токенов — код
├── coder-v2.ai.md      ~500 токенов — TEA-генерация
├── infra.ai.md         ~500 токенов — серверы
├── integrator.ai.md    ~600 токенов — API
└── restructor.ai.md    ~400 токенов — миграции

Реестр ролей

Роль Файл Токены Триггер загрузки
Терминал CLAUDE.md ~500 Всегда (автозагрузка)
Архитектор architect.ai.md ~500 "методология", "стандарт", "паттерн"
Проектор projector.ai.md ~400 "проект", "задача", "статус"
Кодер v1 coder-v1.ai.md ~400 "код", "функция", "баг"
Кодер v2 coder-v2.ai.md ~500 "TEA", "генерация", "трансформация"
Инфра infra.ai.md ~500 "сервер", "деплой", "бэкап"
Интегратор integrator.ai.md ~600 "API", "Ozon", "интеграция"
Реструктуризатор restructor.ai.md ~400 "миграция", "рефакторинг"

АЛГОРИТМ ПЕРЕКЛЮЧЕНИЯ

Терминал определяет роль

ВХОД: Запрос оператора

1. АНАЛИЗ ЗАПРОСА
   Ключевые слова → определить тип задачи

2. ВЫБОР РОЛИ
   ├── Методология? → Архитектор
   ├── Проект/задача? → Проектор
   ├── Код? → Кодер
   ├── Сервер/деплой? → Инфра
   ├── Внешний API? → Интегратор
   └── Миграция? → Реструктуризатор

3. ЗАГРУЗКА
   Read system/{role}.ai.md

4. РАБОТА
   Выполнить задачу в контексте роли

5. ВЫГРУЗКА
   При смене задачи → сбросить контекст роли

Комбинации ролей

Иногда нужно несколько ролей одновременно:

НОВАЯ ФИЧА:
Проектор (задача) + Кодер (код) + Инфра (деплой)

РЕФАКТОРИНГ:
Архитектор (валидация) + Реструктуризатор (миграция)

ИНЦИДЕНТ:
Инфра (диагностика) + Кодер (фикс)

ПРАВИЛО: Загружать последовательно, не параллельно

ЭКОНОМИЯ ТОКЕНОВ

Стратегии

Стратегия Когда Экономия
Минимум ролей Всегда До 80%
Последовательная загрузка Сложные задачи 30-50%
Кеширование контекста Повторные запросы 20-30%
Сжатие .ai.md При разработке 10-20%

Лимиты

ОПТИМУМ:     1 роль    = ~400-600 токенов
ДОПУСТИМО:   2 роли    = ~1000 токенов
МАКСИМУМ:    3 роли    = ~1500 токенов
ЗАПРЕЩЕНО:   >3 ролей  = перерасход!

ЖИЗНЕННЫЙ ЦИКЛ СЕССИИ

СТАРТ СЕССИИ:
└── Загружен: CLAUDE.md (~500 токенов) — терминал

ЗАПРОС "код":
├── Загружен: coder-v1.ai.md (+400 токенов)
└── Итого: ~800 токенов

ЗАПРОС "деплой":
├── Выгружен: coder-v1.ai.md (-400 токенов)
├── Загружен: infra.ai.md (+500 токенов)
└── Итого: ~900 токенов

ЗАПРОС "статус проекта":
├── Выгружен: infra.ai.md (-500 токенов)
├── Загружен: projector.ai.md (+400 токенов)
└── Итого: ~800 токенов

КОМАНДЫ УПРАВЛЕНИЯ

# Показать загруженные роли
роли

# Загрузить роль
роль архитектор

# Выгрузить роль
выгрузить архитектор

# Переключить роль
переключить кодер

# Показать потребление токенов
токены

ПРАВИЛА

МОЖНО

НЕЛЬЗЯ

ОБЯЗАТЕЛЬНО

ОПТИМИЗАЦИЯ .ai.md

Структура (минимум токенов)

# Роль

**Версия:** X.Y.Z
**Вытекает из:** [путь]

---

## РОЛЬ
Одно предложение.

## ЗОНА ОТВЕТСТВЕННОСТИ
Таблица: делаю / не делаю

## АЛГОРИТМ
Пронумерованные шаги

## ПРАВИЛА
МОЖНО / НЕЛЬЗЯ / ОБЯЗАТЕЛЬНО

---

Антипаттерны (много токенов)

❌ Длинные объяснения
❌ Примеры кода в .ai.md
❌ История изменений
❌ Дублирование из других файлов

Версия: 1.0.0