# Скиллы цикла: brief, feature, accept, release

Какие скиллы ведут цикл от брифа до релиза и когда агент вызывает каждый.

Скиллы цикла превращают обсуждение фичи в бриф, реализацию, приёмку и выпуск. Скилл — это текст, который учит агента порядку работы: что делать по шагам, где остановиться и спросить вас, а где идти дальше без вопросов. Журнал и [политика проекта](/docs/agents/policy) остаются главными: если политика требует больше, чем скилл, агент делает то, что требует политика.

## Четыре этапа цикла

Путь от идеи до пользователей состоит из четырёх этапов. У каждого свой результат, а человек вмешивается в немногих местах: подтверждает намерение, отвечает на открытые вопросы архитектора и сам выкатывает.

| Этап | Что происходит | Результат | Где вы решаете |
|---|---|---|---|
| Бриф | Из обсуждения собирается короткое описание фичи: цель, что входит и не входит, критерии готовности | Фича с карточкой в облаке, критерии на доске | Вы говорите «ок» или правите |
| Реализация | Фича делится на 1–3 задачи, исполнитель их делает и сдаёт отчёты | Задачи в статусе «отчёт сдан — не проверено» | Без остановок |
| Приёмка | Отдельный проверяющий читает отчёт, смотрит изменения и сам гоняет проверки | Задачи «проверено и принято» | Без остановок, вердикт записан в журнал |
| Выпуск | Вы выкатываете принятое, агент записывает выпуск в журнал | Карточки «Выпущено», сообщение в Telegram, запись в ленте | Выкатываете вы, агент записывает |

Скилл `feature` ведёт этапы целиком, по шагам ниже. В пакет `actari-mcp` входят два скилла: `actari` (протокол журнала) и `feature`. Бриф, приёмка и выпуск в нём — этапы одного скилла, а не отдельные команды. Если вашей команде удобнее разнести их по отдельным чатам и командам, это можно сделать собственными скиллами поверх тех же инструментов: порядок и результаты те же.

## Скилл actari: протокол журнала

Включается, когда работа записывается в журнал. Он рассказывает агенту:

1. Сначала зарегистрировать проект (`resolve_project`, затем `register_project`): без этого журнал отказывает.
2. Задачу от человека вести через `draft_task`, `delegate`, `submit_report`, `accept`.
3. Фичу из обсуждения публиковать через `publish_intent`, а работу из облака брать через `inbox` и `take`.
4. Читать `get_policy` перед первой задачей и помнить, что `REPORTED` — это заявка исполнителя, а не готовность.

## Скилл feature: одна фича от начала до выкатки

Запускается фразой «Сделай через actari: добавить выгрузку отчёта в CSV» (на русском или английском, агент отвечает на вашем языке) или «Возьми из actari», если вы завели фичу в облаке. Слова «выкатил» или «shipped» запускают последний шаг. В Claude Code скилл называется `actari:feature`.

**1. Проект.** Агент находит или регистрирует проект по папке репозитория.

**2. Намерение — единственная остановка до приёмки.** Агент показывает несколько строк: что делаем, чего не делаем и 3–5 критериев готовности, каждый из которых проверяется командой или видимым результатом, а не словами «работает хорошо». Вы отвечаете «ок» или правите. После этого агент записывает намерение заметкой `intent: <slug>` и публикует его в облако вызовом `publish_intent`. Если облако недоступно, агент не останавливается, а работает локально и скажет об этом в итоге.

**3. Из облака.** Если вы завели фичу в облаке, агент берёт намерение вызовом `inbox` и `take`, а шаг 2 пропускает: вы уже всё написали.

**4. Архитектура.** Если пространство ведёт карту системы, агент вызывает `architecture_review` и учитывает действующие решения. Открытые вопросы архитектора — вторая и последняя остановка: агент не нарезает задачи, пока вы на них не ответили.

**5. Задачи.** Фича режется на 1–3 задачи, которые можно проверить по отдельности. Для каждой: поиск похожих (`search_precedents`), `draft_task`, `delegate` исполнителю (по умолчанию субагенту), работа, `submit_report` с доказательствами, запись расхода токенов (`log_usage`). Решение, которое дорого отменить (модель данных, библиотека, протокол), записывается отдельным ADR вызовом `record_artifact` с видом `adr`.

**6. Приёмка.** Работу автора проверяет другой: субагент без контекста автора, а если субагентов нет, вы. Подробности — на странице [Приёмка](/docs/concepts/acceptance). Принятое подтверждается вызовом `accept` с доказательством, а второй возврат или провал на одной задаче агент выносит к вам.

**7. Документация.** Фича, которая меняет видимое поведение, правит свои страницы документации и карточку «Возможностей», если она названа в брифе. Невидимое изменение этого шага не требует.

**8. Итог.** Агент коротко пишет: что готово, кто и какими командами это проверил, сколько токенов ушло, что осталось (каждая находка становится черновиком задачи, чтобы не потеряться) и где смотреть фичу. На этом он останавливается: пушить и выкатывать — решение человека.

**9. Выпуск.** Когда вы говорите «выкатил», агент записывает выпуск вызовом `record_release` с названием и фразой «что нового» для каждого пункта, затем вызывает `sync`, и облако рассылает уведомление. См. [Выпуски](/docs/concepts/releases).

## Чем скилл не является

Скилл не заменяет политику: «что считать отчётом» и «когда можно принимать» задаёт проект. И он не гарантирует выполнение: это инструкция агенту, а гарантией служит сервер, который проверяет переходы статусов и требования политики.

## Что дальше

- Какие правила можно задать: [Политика проекта](/docs/agents/policy).
- Как установить скиллы: [Установка](/docs/agents/install).
- Как работает карточка фичи в облаке: [Фича и намерение](/docs/concepts/feature-and-intent).