Подключение проекта и первый запуск
Эта инструкция — про настройку контекста: как агенту «рассказать» о проекте, чтобы дальше он предлагал нужные действия, а не угадывал. Всё делается в диалоге, отдельной админ-панели нет.
Что происходит при первом запуске
Если агент не знает контекст, он начинает с короткого опроса — это называется осведомлённость. Три инструмента:
| Команда | Что делает | Результат |
|---|---|---|
/environment | Короткий опрос о том, как устроена работа | Профиль проекта: масштаб, методология, отрасли, трекеры и пространства, которые относятся к проекту |
/documents | Реестр проектных документов: что есть, чего нет, что не применимо | Таблица документов с пояснением, что каждый из них закрывает |
/path | Советник: на какой стадии жизненного цикла проект и что делать дальше | Стадия + до трёх конкретных предложений |
Шаг 1. Профиль проекта: /environment
Наберите /environment — агент задаст вопросы по одному:
- Масштаб работы — один проект, портфель проектов или корпоративные стандарты.
- Рабочие контейнеры — какие из доступных проектов Jira и пространств Confluence относятся к этому проекту (или «никакие», если проект живёт только в документах).
- Методология — как команда ведёт работу: Scrum, Kanban или другая методология. Для спринтовых методологий — ещё и длительность цикла (например, 2 недели).
- Отрасль и масштаб модели — какой отраслевой профиль ближе, есть ли масштабирование.
Перед подтверждением агент покажет все четыре значения — проверьте их и подтвердите явно. Профиль можно исправить в любой момент: скажите, что поле неверно, — агент обновит его.
Шаг 2. Реестр документов: /documents
Наберите /documents (или загрузите документ и попросите классифицировать его). Агент разберёт загруженные материалы и построит реестр: какие документы проекта уже есть — устав, scope, BRD, спецификация, договор, реестр рисков, план и другие, — а чего не хватает.
Важные детали:
- Каждому документу присваивается «покрытие» — краткое пояснение, какой вопрос проекта он закрывает. Так понятно, какой документ отвечать на какой вопрос.
- Неприменимые документы отмечаются явно. Внутренний проект без договора поставки — это не «пропущенный» документ: агент отметит договор как «не применимо» с причиной, и больше не будет напоминать о нём.
- Документы сессии и проекта различаются. Черновик, подготовленный в диалоге, живёт в сессии. Когда документ готов к работе между сессиями, его можно перенести в проект — агент спросит подтверждение перед переносом.
Шаг 3. Советник следующих шагов: /path
Наберите /path — агент сверит, что уже сделано (реестр документов, профиль, текущий диалог), определит стадию жизненного цикла и предложит до трёх конкретных следующих действий.
Стадии, которые различает советник: осведомлённость → устав → scope → требования → спецификация → исполнение → риски → мониторинг → отчётность.
Пример вывода: устав и scope уже есть, BRD нет, договор отмечен как «не применимо» — тогда в приоритете будет /requirements, а договор советник не предложит.
Советник /path работает и автоматически: в начале нового диалога и после завершения любой команды агент сам предлагает, что делать дальше.
