# roles

Слэш-команда roles открывает ростер, из которого /team набирает исполнителей: миссии, границы, права решений и промпты для агентов.

- команда · `type=command` · Claude Code, Codex, GitHub Copilot, Gemini CLI · ★ 328 у репозитория
- Автор: coco-research
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/coco-research/coco/tree/HEAD/commands/team/roles.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/commands/roles

## Что делает

Команда открывает ростер, из которого `/team` набирает исполнителей под конкретную задачу. У роли есть миссия, слой (research, execution, review или synthesis) и системный промпт — его оркестратор копирует в параметр `prompt` инструмента Agent. Сами агенты файл не читают.

Ещё в записи описаны границы: что роль не делает, какие входы получает, по каким критериям принимают её выход, что решает единолично и когда эскалирует наверх. Пример — Principal Architect: разруливает конфликты ревьюеров по границам системы и фиксирует проигравшую позицию в разделе Architectural Decisions.

\`roles.md` — сгенерированный файл, источник правды в `systems/team/roles.yaml`, сборка идёт через `python3 systems/team/build_roster.py`. Поэтому правки в самом `roles.md` ничего не дадут: CI падает, если рендер расходится с YAML. Новую роль добавляют в YAML и гоняют `python3 systems/team/validate_roles.py`, пока та не завершится с кодом 0, затем пересобирают ростер. Роль без собственной миссии в реестр не попадает: её сливают с существующей или убирают. Нужен Python 3.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/commands/roles.md` — Вызов — /roles. Для всех проектов — ~/.claude/commands/

### Codex

**Вручную: положить файлы**
- Файл: `~/.codex/prompts/roles.md` — Вызов — /prompts:roles. В Codex этот формат помечен устаревшим, замена — скиллы

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/prompts/roles.prompt.md`

### Gemini CLI

**Вручную: положить файлы**
- Файл: `.gemini/commands/roles.toml` — Gemini хранит команды в TOML: текст запроса — в поле prompt

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/coco-research/coco/tree/HEAD/commands/team/roles.md

## Когда брать
- выбрать роли для `/team` под конкретную задачу
- проверить, какие ID принимает `--roles`
- добавить новую роль в реестр и прогнать валидацию
- посмотреть системный промпт, который получит агент
- различить principal-architect и principal-pm по правам решений

## Примеры запросов агенту
- \`/roles` покажи миссию и границы роли principal-architect
- \`/roles` какие ID подойдут для `--roles`, если задача про архитектуру и безопасность?
- \`/roles` что нужно сделать, чтобы добавить роль в `systems/team/roles.yaml`?

## Похожие
- [architecture-review](https://affpapa.org/nevibecode/commands/architecture-review.md) — команда · 3419 установок
- [session-learning-capture](https://affpapa.org/nevibecode/commands/session-learning-capture.md) — команда · 425 установок
- [speckit.companion.auto](https://affpapa.org/nevibecode/commands/speckitcompanionauto.md) — команда · ★ 110 у репозитория
- [netsuite-sdf-roles-and-permissions](https://affpapa.org/nevibecode/skills/netsuite-sdf-roles-and-permissions.md) — скилл · 981 установка
- [ansible-roles](https://affpapa.org/nevibecode/skills/ansible-roles.md) — скилл · 234 установки
- [company-brain](https://affpapa.org/nevibecode/skills/company-brain.md) — скилл · 407 установок

Из того же набора: [coco-research/coco](https://affpapa.org/nevibecode/by/coco-research/coco.md) — 82 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
