# Мандаты и файловый обмен Читай этот файл, когда готовишь поручение агенту или передаешь большой материал между участниками. Смысл ревью и триажа задает [единый договор](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: . Scope: . Read: . Check: . Return: . 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: ``` Передай пути к этим параметрам, [мандату ревьюера](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), путь к исходному отчету, путь к резолюциям, границу новой версии, нужные проверки и новый уникальный путь отчета. Перепроверка продолжается в том же треде или сессии: здесь прежний контекст ревьюера полезен. В каждом файловом варианте агент возвращает короткий индекс и путь. Полный отчет остается доступен следующему владельцу работы без пересказа координатором.