Task Brief

Бриф задачи — шаг 0, до любого действия

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

Когда обязателен. Любая работа по делу: картирование, практика, позиция, документ, заседание, разбор правок. Многосоставная задача владельца («сделай X, потом Y, учти Z»). Когда не нужен. Справочный вопрос («когда заседание у X», «где файл Y») — точечный ответ без ритуала.

Порядок

1. Разобрать запрос на перечень (без интерпретации)

Выписать КАЖДОЕ требование владельца отдельной строкой, своими словами не подменять. Требование прозвучало вскользь — все равно в список. Ничего не объединять «для краткости»: объединение прячет пункты.

Отдельно пометить: что владелец запретил, что назвал обязательным, какие цифры и имена назвал точно.

2. Классифицировать

3. Preflight — три команды, до плана

python3 scripts/themiz_status.py cases/{клиент}/{дело} --brief   # сводка старта + состояние + валидность frontmatter
python3 scripts/preflight_search.py                       # каналы поиска
ls $HOME/Desktop/inbox/                                       # новые материалы

Сломан frontmatter — чинить до работы: агент с невалидным YAML молча не попадет в реестр (прецедент 02.08.2026, конвейер встал на шаге 4). Внешних каналов нет — охота не запускается, работаем по knowledge/practice_index.md.

Работа по подпискам, без долларового предела. python3 scripts/budget_preflight.py --track FULL фиксирует подписочный режим. Отсутствие цены в USD не блокирует FULL. Токены — наблюдение за расходом контекста, не счет к оплате и не измеренный остаток подписки. Плановую норму не превращать в дополнительный жесткий потолок. Если провайдер сообщил об исчерпании квоты или отказе авторизации — остановить его вызовы и назвать причину; неизвестную квоту не объявлять свободной. Решение владельца 08.09.2026.

4. Сервисы — только из белого списка

Свериться с knowledge/allowed-services.md. В бриф вписать поименно, что будет использовано. Нужного сервиса нет в списке — СТОП, спросить владельца, внести после согласия. Молча подбирать замену запрещено.

5. План с прогнозом

Шаги по порядку: агент, модель, вход, прогноз токенов. Прогноз считать от объема входа, а не от числа агентов: повторная передача контекста увеличивает учтенные токены. Это не долларовая цена подписочного вызова. Материал до 15 000 токенов подавать агенту текстом в промпте, а не путем.

Модель шага берется из прибора, а не из головы и не из пина в frontmatter:

python3 scripts/model_policy.py --level L1 --step draft     # фактическая модель текущего профиля
python3 scripts/model_policy.py --brief .agent/context/_working/brief.md   # сверка плана

Шаги: draft review hunt council-role council-chair read-text read-scan classify. В Codex брать модель из model_policy.py и конфигурации роли; исторические алиасы Claude не передавать как имена моделей Codex. Заполнив таблицу, прогнать --brief по записанному файлу: код 1 — план правится до начала работ. Шаг, запрещенный триажем на этом уровне (охота на MICRO, совет на L1), прибор называет запрещенным — в план он не попадает.

Итог сверить прибором: python3 scripts/token_ledger.py --track FAST|FULL после шагов 2 и 3. Превышение плановой нормы токенов — информация для сокращения лишних чтений, не доказательство исчерпания подписки и не самостоятельный запрет продолжения. Ошибки счета, явный лимит контекста и отказ провайдера не скрывать. Ручное сложение usage субагентов не заменяет прибор.

6. Заморозка фактуры — перед шагом 4, обязательно

Самая дорогая статья проекта — не советы, а перегенерация документа: 773 000 токенов за одну сессию (54% ее расхода) и 285 061 на простом L1. Причина одна: материалы приходят волнами, и doc-drafter запускается заново на каждой.

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

Перечень пуст → строкой в брифе: ФАКТУРА ЗАМОРОЖЕНА ДД.ММ.ГГГГ. После этой строки:

• doc-drafter запускается один раз;
• новые вводные после заморозки вносятся Edit-патчем в готовый черновик, а не перегенерацией;
• полная перегенерация допустима только при смене правовой позиции (меняется positions.md) — тогда откат на шаг 3, и это фиксируется в брифе отдельной строкой с причиной.

7. Критерии приемки

Что должно лежать на диске, с какими маркерами, чтобы задача считалась выполненной. Формулировать проверяемо: «файл X с маркером Y», а не «качественная карта».

Формат брифа

Показать владельцу в чате и записать в cases/{клиент}/{дело}/.agent/context/_working/brief.md (нет дела — cases/_logs/brief_ДД-ММ-ГГГГ.md). Держать в пределах 40 строк: бриф экономит токены, а не тратит.

## БРИФ — {задача одной строкой}                Дата: ДД.ММ.ГГГГ

ЗАДАЧИ (полный перечень, ничего не опущено)
1. ...   2. ...   3. ...

КЛАССИФИКАЦИЯ  Дело: {путь} · Уровень: L{N} · Трек: {FAST|FULL} · Результат: {что}

PREFLIGHT  Frontmatter: {чист|сломан X} · Агенты: {N}/13 · Каналы: {список} · Инбокс: {N файлов}

ПЛАН
| Шаг | Исполнитель | Модель | Прогноз |
|---|---|---|---|

СЕРВИСЫ  {поименно из allowed-services.md}
ЗАПРЕТЫ  {что владелец запретил + инварианты CLAUDE.md, относящиеся к задаче}
ПРИЕМКА  {проверяемые критерии}
ФАКТУРА  {открытые вопросы списком | ФАКТУРА ЗАМОРОЖЕНА ДД.ММ.ГГГГ}
ПОДПИСКА   token_ledger.py --track {FAST|FULL} после шагов 2 и 3; без долларового потолка, остаток квоты не выдумывать.

Дальше

Бриф утвержден владельцем либо не вызвал возражений — исполнять строго по нему. Отклонение от брифа по ходу работы фиксировать строкой в том же файле: дата, что меняется, почему. Задним числом бриф не переписывать.

Сбои