dotfiles/agents/.agents/skills/codex-subagent-playbook/references/prompt-templates.md

# Мандаты и файловый обмен

Читай этот файл, когда готовишь поручение агенту или передаешь большой материал
между участниками. Смысл ревью и триажа задает
[единый договор](review-and-triage.md); здесь находятся короткие заготовки.

## Выбор канала

Ясное поручение, уточнение или вердикт передавай коротким сообщением. Файл
нужен, когда материал велик, используется повторно или должен попасть от одного
агента к другому, не проходя целиком через контекст координатора.

Для файлового обмена выбери общий временный каталог задачи. Дай каждому
результату уникальный абсолютный путь с версией артефакта и линией обзора в
имени. Получатель читает исходный файл напрямую; координатор передает путь и
короткую цель, не копирует полный материал в новый промпт.

Постоянные английские блоки находятся в [prompts/](prompts/):

- [result-contract.md](prompts/result-contract.md) - ограниченный результат
  исполнителя, исследователя или проверяющего;
- [review-boilerplate.md](prompts/review-boilerplate.md) - мандат и формат
  независимого обзора;
- [triage-header.md](prompts/triage-header.md) - разбор находок реализации;
- [recheck-header.md](prompts/recheck-header.md) - узкая перепроверка;
- [runtime-language.md](prompts/runtime-language.md) - язык временного обмена.

## Короткое поручение

Если задача ясна из текущего контекста, достаточно такого сообщения:

```text
Goal: <one verifiable outcome>.
Scope: <allowed files, state, or question>.
Read: <only required paths>.
Check: <relevant command or evidence>.
Return: <concise result, or unique report path when the payload is large>.
Escalate design or scope changes with options, costs, and your recommendation.
```

Убирай ненужные строки. Не создавай обменный файл ради нескольких предложений.

## Большое поручение

В параметрическом файле оставь только факты конкретной задачи:

```text
GOAL: one verifiable outcome
WORKING DIRECTORY: absolute path
BOUNDARIES: allowed work and protected state
READ FIRST: exact paths
CHECKS: commands or hypotheses
REPORT: unique absolute path
```

Если агенту нужен полный отчет, передай ему пути к
[договору результата](prompts/result-contract.md) и
[правилу языка](prompts/runtime-language.md) либо механически собери эти файлы
с параметрами. Координатор не перепечатывает постоянные блоки. Передай агенту
короткое сообщение с путем к поручению. Сборка файлов служит оптимизацией для
длинного материала.

## Исполнитель Sol или Terra

Ограничь поручение так, чтобы контекста исполнителя хватало на реализацию,
проверки и исправления. К короткому или большому поручению Sol или Terra
добавь блок:

```text
You may delegate bounded mechanical support to Luna, reusing a suitable
existing helper when its context is useful. You remain responsible for the
result and for preventing conflicting writes within your assigned scope.
Escalate any need for another implementer at the Sol or Terra level to the
coordinator, who decides how to split and assign the work. If the task outgrows
your available context, raise that while there is still room to explain the
remaining work.
```

Если для задачи уместен TDD, укажи в поручении скилл `/tdd` по имени,
ожидаемое поведение и уже согласованные границы проверки.

## Независимое ревью

Параметры обзора должны назвать:

```text
TITLE: short review title
WORKING DIRECTORY: absolute path
STATEMENT: task and governing contract paths
REVIEWED VERSION: commit, prepared diff, exact paths, or other stable boundary
FOCUS: one explicit lens
OUT OF SCOPE: unrelated work
CHECKS: useful commands and expected observations
FINDING PREFIX: unique stable prefix
REPORT: unique absolute path
```

Для внешнего канала после уже полученного разрешения добавь точную границу:

```text
TRANSFER: <exact materials and channel already authorized by the user>
```

Передай пути к этим параметрам, [мандату ревьюера](prompts/review-boilerplate.md)
и [правилу языка](prompts/runtime-language.md) либо механически собери из них
полное поручение.
Каждая линия получает свой фокус, префикс и путь. Отчеты параллельных линий не
передаются друг другу до завершения исходных обзоров.

Для проверки формы можно добавить такой фокус:

```text
Before reading the changes, sketch one plausible solution shape from the
statement: responsibilities, boundaries, data movement, and necessary
artifacts. This is a hypothesis, not a prescribed design. Compare the actual
shape with it, identify decisions left open by the statement, and judge each
decision against repository values, risk, and task proportion.
```

Если линия оценивает структуру и сопровождаемость кода, добавь этот фокус.
Названия запахов взяты из `/code-review` Мэтта Покока (Фаулер, _Refactoring_,
гл. 3):

```text
Use Fowler's code smells as prompts for judgment: Mysterious Name,
Duplicated Code, Feature Envy, Data Clumps, Primitive Obsession,
Repeated Switches, Shotgun Surgery, Divergent Change, Speculative Generality,
Message Chains, Middle Man, Refused Bequest.
Treat them as heuristics; documented repository conventions take precedence.
For a finding, explain the maintenance consequences in this project and
judge the proposed remedy against those costs and the task's scope.
```

## Разбор и перепроверка

Исполнитель разбирает реализацию по
[triage-header.md](prompts/triage-header.md). Передай ему пути к подробным
отчетам без изменений, решения координатора и уникальный путь резолюций.
Короткая сводка ревьюера не заменяет исходные доказательства.

Исходному ревьюеру для узкой перепроверки передай
[recheck-header.md](prompts/recheck-header.md), путь к его исходному отчету,
путь к резолюциям, границу новой версии, нужные проверки и новый уникальный
путь отчета. Продолжи тот же тред или сессию: здесь его прежний контекст
полезен.

В каждом файловом варианте агент возвращает короткий индекс и путь. Полный
отчет остается доступен следующему владельцу работы без пересказа координатором.