Проектные документы: создание и ведение
Помимо загруженных вами документов, агент создаёт и ведёт рабочие документы проекта — те, на которых держится управление: устав, scope, требования, спецификация, планы и реестры. Эта инструкция — как они создаются, как вы их ревьюите и как они живут вместе с проектом.
Какие документы ведёт агент
У каждого документа своя команда — агент создаёт документ только через неё, а не «свободной формулировкой»:
| Документ | Команда | Что в нём |
|---|---|---|
| Устав (charter) | /initiate | Цель, цели, критерии успеха, высокий уровень In/Out |
| Scope | /scope | Границы объёма: что входит, что не входит, допущения |
| BRD (бизнес-требования) | /requirements | Живой документ требований: функциональность, критерии приёмки |
| Спецификация | /specify | Детализация требований до уровня реализации |
| Договор / SOW | /contract-review | Анализ договора поставки: обязательства, сроки, риски |
| Реестр рисков | /risks | Идентифицированные риски, оценка, меры реагирования |
| Метод оценки | /estimate | Как проект оценивает трудозатраты |
| Планы (спринт / релиз / Гант) | /plan | Коммит по периодам, базовые линии |
| Формат отчёта | /report-format | Шаблон статус-отчёта |
| Отчёты | /report | Готовые статус-отчёты за периоды |
Список фиксированный: агент не изобретает новы е типы документов — он работает с этим набором и с вашими загруженными файлами.
Как создаётся документ
Типичный цикл одинаков для всех документов:
- Заявка. Вы вызываете команду (например,
/scope) — или агент сам предлагает её, когда приходит очередь. - Черновик. Агент собирает материал из трекера, базы знаний, загруженных документов и диалога и готовит документ в рабочей области.
- Ревью. Изменения в документе отмечаются блоками: добавленное — подсвечено, удалённое — зачёркнуто, рядом кнопки «Принять» / «Отклонить». Любую часть можно дописать вручную.
- Сохранение. Документ сохраняется в нужном формате (Markdown или ADF) — в сессию или сразу в проект.
Подробнее о механике редактора — в разделе Коллаборативные редакторы.
Как документы живут дальше
Рабочие документы — «живые»: агент обновляет их по мере развития проекта и всегда через ревью. Примеры:
- BRD пополняется по мере уточнения требований: новые требования добавляются блоками, устаревшие — помечаются.
- Реестр рисков растёт: новые риски появляются через
/risks, меры реагирования — через/risk-mitigate; вы принимаете каждую правку. - Scope не меняется «тихо»: любое расширение объёма проходит через проверку (см. Контроль объёма).
Реестр и «не применимо»
Агент держит реестр рабочих документов: что уже создано, чего не хватает, а что не применимо. Если проект внутренний и договора поставки нет, документ «договор» отмечается как «не применимо» — и агент больше не предлагает его создавать.
Черновик в сессии и документ проекта — разные уровни. Когда документ готов к работе между сессиями, агент предлагает перенести его в проект — перенос подтверждаете вы.
С чего продолжать
- Инициация проекта — как создаются первые документы: устав, анализ договора, scope.
- Сбор и проработка требований — как живёт BRD.
- Работа с базой документов — ваши загруженные документы.