Фича и намерение

Фича отвечает на вопрос «зачем», задачи журнала — на вопрос «как», а намерение связывает облако с агентом. Фича живёт в облаке: у неё есть описание, критерии готовности и доска. Намерение — карточка этой фичи, которую агент может взять в работу. Задачи журнала, которые агент заводит под намерение, становятся попытками на этой карточке.

Откуда берётся намерениеКопировать ссылку на раздел

Есть два пути, и результат у них один: фича с карточкой на доске.

Из облака. Вы создаёте фичу, описываете критерии готовности, делите её на задачи и нажимаете «В работу» у задачи. Карточка попадает в колонку «Предложено» и ждёт в очереди агентов. Подробнее о доске — на странице Фичи и доска.

Из обсуждения с агентом. Вы обсуждаете фичу в чате, агент записывает её описание и критерии и публикует вызовом publish_intent. В облаке сразу появляется фича с карточкой «Предложено». Повторный вызов с тем же slug обновляет текст и критерии, дубликатов не будет. Если карточку уже закрыл человек, заново она не создаётся.

publish_intent { project: "shop", slug: "csv-export",
                 title: "Выгрузка отчёта в CSV",
                 text: "Зачем фича, что входит, что не входит…",
                 acceptance_criteria: "1. Кнопка «Скачать CSV» на странице отчёта\n2. Файл открывается в Excel" }

Для публикации проект должен быть привязан к пространству облака и журнал должен быть подключён (connect). Если это не так, журнал отвечает понятным отказом, а работа продолжается локально.

Как агент берёт работуКопировать ссылку на раздел

Агент смотрит очередь вызовом inbox: он показывает ваши намерения и свободные, сначала ваши, по приоритету. Затем take с номером намерения забирает карточку и возвращает заготовку для draft_task: контекст фичи, текст намерения, критерии приёмки с версией, приоритет и проект журнала.

inbox {}
take { task_id: "<id намерения из inbox>" }
draft_task { project: "shop", slug: "csv-export-1", title: "…",
             task_text: "…", intent_task_id: "<id намерения>" }

С intent_task_id задача журнала привязывается к карточке. Дальше карточку двигают события журнала, вручную её перетаскивать не нужно.

Путь карточки по доскеКопировать ссылку на раздел

Если в пространстве включён учёт выпусков, вместо «Сделано» появляются колонки «Принято» и «Выпущено», о них — на странице Выпуски.

Попыток на одной карточке может быть несколько. Отменённые черновики (DROPPED) на доске не показываются.

Человек главнее агентаКопировать ссылку на раздел

Человек в любой момент может отменить намерение, закрыть его вручную, забрать себе или поменять критерии приёмки. В этом случае сервер отказывает агенту при следующем действии и называет причину. Два инструмента помогают разобраться:

• intent_status { task_id } показывает состояние намерения, его критерии, ручное решение человека (кто и что решил) и отличие критериев от тех, что агент уже видел. Принять задачу по изменённым критериям можно только после того, как агент их увидел.
• release_intent { task_id, note } возвращает взятое намерение в очередь. Нельзя вернуть, пока по нему есть задачи в работе: сначала их закрывают вызовом mark_failed.

Вопросы и архитектураКопировать ссылку на раздел

После публикации фичи AI-продакт может задать по ней вопросы. Агент читает их вызовом feature_questions { project, slug }, а отвечает answer_question { project, slug, question_id, text }: ответ подписывается владельцем токена с пометкой «через MCP». Если в пространстве собрана карта системы, architecture_review { project, slug } показывает затронутые компоненты, действующие решения и риски. Об этом рассказывают страницы AI-продакт и Карта системы.

Что дальшеКопировать ссылку на раздел

• Как проверяется работа по намерению: Приёмка.
• Как скиллы ведут фичу от обсуждения до выпуска: Скиллы цикла.
• Статусы задач журнала: Журнал и статусы.