С чего начинается полезная работа агента

Начать с репозитория

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

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

Обозначить границы задачи

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

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

Сделать результат проверяемым

К изменению нужно короткое объяснение: что сделано, почему, что проверено и что пока неизвестно. Успешная сборка полезна, но она не показывает, удобно ли читать страницу с телефона.

Понять задачу
  → изучить проект
  → внести ограниченное изменение
  → проверить поведение и просмотреть diff
  → описать результат и открытые вопросы

Держать процесс рядом с работой

Я хочу показывать этот подход в реальном репозитории, которым пользуюсь и который поддерживаю. Этот сайт подходит для такого примера: решения и проверки могут быть видны рядом с кодом.

Следующий шаг — показать полное изменение через задачу и отревьюенный pull request. Такой пример ещё предстоит опубликовать.