Дайте агенту полезный контекст репозитория

Начните с текущей рабочей копии

Агенту нужно знать, какой репозиторий и какую ветку он меняет. Ему также нужно знать, есть ли в рабочем каталоге посторонние изменения. От этого зависит, что можно безопасно редактировать и как понимать итоговый diff.

До реализации попросите агента изучить инструкции проекта и конфигурацию пакета. Команда, запомнившаяся из другого репозитория, здесь может быть неверной. Знакомое название framework не определяет установленную версию или соглашения проекта.

Для небольшого изменения предоставьте нужный модуль, вызывающий код, тесты и архитектурное решение. Добавляйте информацию, когда исследование покажет конкретную потребность.

Храните стабильные правила в инструкциях репозитория

Файл инструкций может описывать поддерживаемые команды, границы модулей, требования к review и действия, для которых нужно решение ответственного. Соглашение AGENTS.md даёт инструментам программирования узнаваемое место для этой информации. Поддержка этого соглашения инструментами и приоритет инструкций могут различаться, поэтому проверьте поведение своего инструмента.

Стабильные правила проекта храните в репозитории. Текущую задачу оставьте в задании. Не превращайте файл инструкций в историю всех разговоров или список временных планов.

Полезная инструкция: «Запускай интеграционные тесты авторизации, если маршрут меняет правила доступа». Неясная инструкция: «Всегда будь осторожен с безопасностью». Первая задаёт условие и действие, которые можно проверить.

Сверяйте инструкции с кодом

Инструкции устаревают при изменении команд, каталогов или архитектуры. Если руководство ссылается на отсутствующий скрипт, изучите конфигурацию пакета. Если документ называет сервис доступным только на чтение, проверьте разрешения, прежде чем полагаться на это утверждение.

Зафиксируйте противоречие. Используйте прямые сведения о текущей версии, чтобы понять поведение реализации. Не отбрасывайте молча установленное правило только потому, что старый код его нарушает. Правила и фактическое поведение отвечают на разные вопросы.

Например, руководство может запрещать прямую запись в общую ветку, а старый скрипт всё ещё её выполняет. Правильный ответ — сохранить правило и исправить скрипт. Существующий код не разрешает повторять запрещённое действие.

Ограничивайте контекст нужной и допустимой информацией

Полный репозиторий может содержать учётные данные, конфиденциальные тестовые наборы, клиентские экспорты и старые логи поддержки. Доступ к репозиторию не делает автоматически каждый файл допустимым для сервиса модели.

Используйте одобренные инструменты и правила обработки данных. Исключайте секреты из контекста. По возможности заменяйте клиентские примеры вымышленными данными. Проверяйте подключённые инструменты наряду с загруженными файлами: поисковый коннектор может получить информацию, которой не было в исходном промпте.

Инструкция репозитория «не читай секреты» полезна. Но она не заменяет ограничений доступа к хранилищу секретов и конфиденциальным каталогам.

Оставьте полезную запись для следующего участника

После завершения запишите в pull request изменённое поведение, результаты проверки и неустранённые ограничения. Если поддерживаемый процесс меняется, обновите документацию проекта, которая служит постоянным справочным источником. Не копируйте в репозиторий весь диалог с агентом.

Запись должна помочь будущему сопровождающему повторить работу без восстановления длинной переписки. Ссылайтесь на канонические документы и сохраняйте одно авторитетное описание каждого стабильного правила.

Хороший контекст сокращает повторное исследование. Он также помогает обнаруживать ошибки, поскольку ожидаемое поведение и рабочие команды заданы явно.