Отчётность для руководства
Отчёт в системе — это письмо для конкретного получателя, собранное из доказательств: статус-снимков, дельты, плана и реестра рисков. Не «дашборд», не конспективный пересказ диалога, не выдуманные проценты.
Шаг 1. Формат: /report-format
Перед первым отчётом нужно согласовать формат. Файл report-format.md хранит «слоты» — сочетания стиля и периода:
| Стиль | Что это |
|---|---|
| full | Полный отчёт: RAG-оценки (график, бюджет, scope, риски), резюме, прогресс против плана, темы/эпики, план и исполнение, риски, решения и запросы |
| lean | Короткое письмо: резюме, общий статус, ключевые метрики, сделано, в работе, риски, запросы |
Периоды: weekly, monthly, quarterly — меняют акценты, а не структуру.
Каждый раздел слота — пара «id (машинный ключ) + название (caption) на языке формата». Агент показывает вам названия разделов — их можно менять, добавлять, убирать, пока слот не будет помечен confirmed.
Дополнительные ключи слота:
audience— кому адресован отчёт;include_timeline_appendix— прикладывать ли выдержку из графика;pptx_template— путь к вашему PPTX-шаблону (см. ниже).
Наберите /report-format full weekly (или /report-format defaults — предложить каркасы для всех недостающих слотов) и подтвердите слот.
Шаг 2. Отчёт: /report
Наберите /report (опционально: /report full weekly, /report lean monthly). Что происходит:
- Проверка входных данных. Агент проверяет, всё ли есть: живой реестр рисков, свежий статус-снимок (не старше вчера), при необходимости — снимок бюджета. Чего не хватает — коротким чек-листом и паузой: либо вы запускаете недостающее, либо явно говорите «дальше с пробелами» (в отчёте будет «недоступно»).
- Дельта. Если свежей дельты (за сегодня/вчера) нет — агент сам запускает
/status-deltaпо снимкам, не дожидаясь команды. - Сборка письма. Разделы заполняются только из доказательств: снимков, дельты, плана, реестра, трекера. Нет данных — «недоступно», а не домысл.
Ключевые правила отчёта:
- Общий статус (R/Y/G) задаёт чел овек, а не агент: он не выводит цвет из количества задач. Красный — всегда с запросом (Ask).
- Вехи — бинарно: завершена / не завершена. Без «90% готовности вехи».
- Отрицательное не прячется: проблемы — в резюме и в рисках.
- Решения и запросы — действенные: кто, что, к какому сроку.
Результат — файл status-report-<стиль>-<период>-YYYY-MM-DD.md. Повторный запуск в тот же день — обновление того же файла.
PPTX по вашему шаблону
Если в слоте задан pptx_template (например, «прошлонедельный» отчёт или корпоративный шаблон), агент дополнительно выведет PPTX:
- агент читает текстовые блоки вашего шаблона, понимает их по смыслу (не по именам фигур) и обновляет соответствующие разделы новыми данными;
- на выходе —
status-report-…-YYYY-MM-DD.pptxрядом с.md(текстовая версия остаётся канонической записью); - слайды не добавляются и не удаляются: шаблон задаёт структуру, агент заполняет её.
Как зафиксировать шаблон: загрузите PPTX в материалы сессии и скажите «используй этот шаблон для full/weekly» — агент предложит записать его в слот.
Публикация
Черновик всегда у вас в чате/материалах. Публикация (например, на страницу в Confluence) — только предложением: вы решаете, что и куда отправить. Тихой отправки нет.
Проверка качества: /quality
Отдельная команда — ревью качества поставки на плановых точках (входы фаз, gate-контроли):
- агент запрашивает доказательства — документы и решения, которые должны существовать на этой фазе (устав, scope-база, план, реестр рисков, итоги спринтов, готовность к релизу, закрытие);
- статус каждой строки: есть / частично / отсутствует / н/д — с источником;
- если заказчик отказал от лучшей практики — фиксируются: что предлагалось, последствия, решение (кто, когда) — и напоминание проверить на закрытии;
- на выходе — датированный ревью-документ с планом действий (кто, к какому сроку, какой командой закрыть пробел).
Ритм ревью зависит от длины проекта: короткие (3–5 мес) — 2 точки; средние (6–10) — 3; длинные (10+) — по фазам.
Как это складывается в цикл
конец периода:
/status-snapshot + /budget-snapshot → входные данные
/report full weekly → письмо для руководства
/report + pptx_template → PPTX для презентации
/quality (по расписанию) → проверка процесса на точке фазы
С чего продолжать
- Статус-снимки и анализ изменений — входные данные отчётов.
- Управление рисками — раздел рисков в отчёте.
- Планирование графика — вехи и критический путь в приложении.
