Составьте карту контекста конкретного изменения
Для анализа требований агенту нужны цель, принятые ограничения и открытые вопросы. Для обзора кода — фрагмент изменения, зависимое поведение и сведения, которые специалист считает существенными. Это разные наборы; ни один не требует автоматически всего репозитория и пользовательской базы.
Опишите связи между документами до передачи. Номер задачи сам по себе не объясняет, какая редакция действует и что уже реализовано. Подготовьте следующие сведения:
- Цель изменения и подтверждённый источник требования.
- Версия продукта, к которой относится описание поведения.
- Разрешённый участок реализации с пояснением границ контекста.
- Подтверждённые примеры входа, результата и обработки отказа.
- Нерешённые вопросы, которые нельзя заполнять предположениями.
Отделите сообщения обсуждения от принятого решения
В переписке могут соседствовать предложение, возражение и отменённый вариант. Аналитик отмечает, какая формулировка принята и где это подтверждено. Агенту передают разрешённую выдержку с сохранением статуса, а не все сообщения ради поиска последнего. Время отправки не всегда означает приоритет содержания.
Таблицы с примерами также требуют пояснений. Пустая ячейка может означать отсутствие значения, неизвестный результат или неприменимость поля. Укажите смысл, иначе модель способна заполнить её по аналогии. Не переносите реальные пароли, ключи и лишние личные сведения в учебные примеры.
Не считайте старый тест описанием нового поведения
Проверка относится к определённой версии и ожидаемому результату. После изменения требования старый тест может быть неактуален; решение о его пересмотре принимает инженер. Агент способен сопоставить текстовые материалы и подготовить вопросы, но результат его чтения не доказывает, что код запущен и поведение воспроизведено.
Частичная документация должна оставаться частичной. Отметьте, какие зависимые участки не переданы, и запретите выводы об их устройстве. Это снижает нагрузку на ведущего разработчика: ему не придётся выяснять, какие уверенные рекомендации основаны на выдуманном интерфейсе.
Проверьте пакет на условном изменении ограничений
Предположим, изменилось правило допустимой длины поля, а инструкция и примеры описывают прежнее ограничение. Аналитик указывает принятое требование, инженер подтверждает соответствующую версию, агент собирает перечень материалов для пересмотра. Обновление кода и тестов не выполняется только по текстовой сводке.
Завершите подготовку проверкой источника каждой строки ответа. Перед рабочим запуском согласуйте отправку содержимого внешней модели: сервер клиента не отменяет передачи. Нужен не максимальный объём документов, а достаточный разрешённый контекст, в котором видно, что известно и где начинается профессиональное решение.
Как с этим работает Coagent
В Coagent у каждого сотрудника есть свой агент с ролью и правилами. Платформа работает на вашем сервере, а решения принимают люди.
Соберите пакет одного изменения с требованием, версией и подтверждёнными примерами, явно обозначив отсутствующий контекст.