typology-role-types.md

type: standard
aspect: typology
title: "Стандарт: Роль (Агент)"
version: 1.0.0
date: 2026-02-19
status: active

Стандарт: Роль (Агент)

Версия: 1.0.0
Тип системы: Агент
Вопросов: 6

ОПРЕДЕЛЕНИЕ

Роль — агент (активная система), определяющий ответственность и способ действия.

ПОСЛЕДОВАТЕЛЬНОСТЬ ВОПРОСОВ

ЗАЧЕМ? → ЧТО? → КАК? → ЧЕМ? → ГДЕ? → КОГДА?
   │       │      │       │       │        │
Ответств. Функции Методы Инстр. Область Активация

Дополнительно:
- ПОЧЕМУ? = предпосылки (зачем нужна роль)
- КТО? = кто исполняет роль
- СКОЛЬКО? = полномочия, ограничения

ОБЯЗАТЕЛЬНЫЕ ПОЛЯ

Вопрос	Поле	Описание
ЗАЧЕМ?	`responsibility`	За что отвечает
ЧТО?	`functions`	Какие функции выполняет
КАК?	`methods`	Как работает
ЧЕМ?	`tools`	Какие инструменты использует
ГДЕ?	`scope`	Область действия
КОГДА?	`activation`	Когда активируется

Дополнительно:
| Поле | Описание |
|------|----------|
| prerequisites | ПОЧЕМУ нужна роль |
| executor | КТО исполняет |
| limits | СКОЛЬКО полномочий |

СТРУКТУРА ДОКУМЕНТА

# Роль: {Название}

## ОТВЕТСТВЕННОСТЬ (ЗАЧЕМ?)
За что отвечает роль

## ФУНКЦИИ (ЧТО?)
- Функция 1
- Функция 2

## МЕТОДЫ (КАК?)
Как выполняет функции

## ИНСТРУМЕНТЫ (ЧЕМ?)
- Инструмент 1
- Инструмент 2

## ОБЛАСТЬ (ГДЕ?)
Где действует роль

## АКТИВАЦИЯ (КОГДА?)
Когда роль активируется

## ОГРАНИЧЕНИЯ (СКОЛЬКО?)
Что роль НЕ делает

ШАБЛОН YAML (для AI-агентов)

name: "{название}"
type: "role"
version: "1.0.0"

# Предпосылки (ПОЧЕМУ?)
prerequisites: |
  Зачем нужна эта роль

# Исполнитель (КТО?)
executor: "Claude|Human|System"

# ЗАЧЕМ? - Ответственность
responsibility: |
  За что отвечает роль

# ЧТО? - Функции
functions:
  - "Функция 1"
  - "Функция 2"
  - "Функция 3"

# КАК? - Методы
methods:
  approach: "Описание подхода"
  workflow:
    - "Шаг 1"
    - "Шаг 2"

# ЧЕМ? - Инструменты
tools:
  - "Инструмент 1"
  - "Инструмент 2"

# ГДЕ? - Область
scope:
  includes:
    - "Область 1"
    - "Область 2"
  excludes:
    - "Не входит 1"

# КОГДА? - Активация
activation:
  trigger: "По запросу|Автоматически"
  condition: "Условие активации"

# СКОЛЬКО? - Ограничения
limits:
  can:
    - "Может делать 1"
    - "Может делать 2"
  cannot:
    - "Не может делать 1"
    - "Не может делать 2"

ПРИМЕРЫ

Роль: Кодер

name: "coder"
type: "role"
executor: "Claude"

responsibility: "Писать и изменять код по задачам"

functions:
  - "Анализировать существующий код"
  - "Реализовывать новую функциональность"
  - "Исправлять ошибки"
  - "Делать commit"

methods:
  workflow:
    - "Read: понять существующий код"
    - "Plan: спланировать изменения"
    - "Code: написать код"
    - "Test: проверить"
    - "Commit: зафиксировать"

tools:
  - "Read/Write/Edit"
  - "Bash (git)"
  - "Языки программирования"

scope:
  includes:
    - "business/ проекты"
    - "Код приложений"
  excludes:
    - "theory/ (это Архитектор)"
    - "infra/ серверы (это Инфра)"

activation:
  trigger: "Задача от Терминала"

limits:
  can:
    - "Минимальные изменения"
    - "Следовать стилю проекта"
  cannot:
    - "Рефакторить без запроса"
    - "Менять архитектуру"

ИЕРАРХИЯ РОЛЕЙ

                    ОПЕРАТОР
                   (человек)
                       │
                       ▼
                   ТЕРМИНАЛ
                  (интерфейс)
                       │
       ┌───────────────┼───────────────┐
       ▼               ▼               ▼
   АРХИТЕКТОР       КОДЕР           ИНФРА
   (методология)    (код)          (серверы)
       │
       ▼
   ПРОЕКТОР
   (проекты)