Template: Agent
Скопируй в 03-Roles/Agent-Name.md и заполни.
Frontmatter
---
title: Agent [Name]
type: agent
level: 1|2|3|cross-cutting # 1=CEO, 2=Director, 3=Executor, X=Cross-cutting
status: planned|active|deprecated
version: "1.0"
model: claude-opus-4-6|claude-sonnet-4-6|claude-haiku-4-5
department: [department name]
manager: Agent-[ManagerName] # для L2/L3, кто выше
tags: [agent, ...]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---Секции
Назначение
[1 абзац: что делает агент, зачем существует, роль-аналог из реального мира]
Ответственности
- [Ответственность 1]
- [Ответственность 2]
- …
Что НЕ делает
- [Ограничение 1 — что вне роли]
- [Ограничение 2]
- …
Модель
[Какая модель и ПОЧЕМУ. Opus — только для критического reasoning. Sonnet — аналитика. Haiku — рутина.]
Входы (payload schema)
{
"field1": "description",
"field2": "description"
}Выходы (result JSON schema)
{
"field1": "description",
"field2": "description"
}Инструменты
| Tool | Описание |
|---|---|
tool_name | Что делает |
Нет доступа к: [перечислить запрещённые]
Бюджет per task
| Ресурс | Лимит |
|---|---|
| Tokens | [число] |
| Time | [минуты] |
| Cost | $[число] |
Системный промпт (draft)
[Draft системного промпта. Итеративно улучшается после тестирования.]
Критерии качества (для Agent-Judge)
- [Критерий 1]
- [Критерий 2]
- …
Ограничения
- Rules-Security — [что конкретно]
- Rules-Budget — [лимиты]
- Codex — [красные линии]
Участвует в процессах
- Process-Name — [роль в процессе]
Failure Modes
| Ситуация | Реакция |
|---|---|
| [Проблема 1] | [Что делает агент] |
| [Проблема 2] | [Что делает агент] |
Open Questions
- [Вопрос 1]
- [Вопрос 2]
Правила заполнения
- Одна роль = один файл. Не комбинировать роли.
- Модель осознанно. Opus только для CEO-level reasoning. Sonnet для аналитики. Haiku для рутины.
- Tool allowlist минимален. Лучше добавить позже, чем дать лишнее.
- Бюджет реалистичен. Начинать с меньшего, увеличивать по данным.
- Failure modes обязательны. Минимум 3 сценария.
Связанные документы
- _Roles-Index — реестр всех агентов
- Codex — правила поведения
- Rules-Budget — бюджетные ограничения