Context engineering и постановка задач

Практикум 2

Содержание курса

0 / 1 баллов

Практическое задание 1. Спроектируйте набор проектных инструкций для реального проекта

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

Ситуация

Представьте, что команда разрабатывает веб-приложение для внутреннего helpdesk-сервиса. У проекта такая структура:

web-app/
  frontend/
  backend/
  tests/
  docs/
  scripts/
  migrations/

Команда хочет, чтобы агент работал по следующим принципам:

  • сначала разбирался в структуре проекта и не менял файлы наугад;
  • для API-задач сначала читал docs/api.md, а для UI-задач смотрел код в frontend/;
  • не трогал migrations/ без явного запроса;
  • после изменений запускал релевантные тесты, если они есть;
  • в финальном ответе кратко перечислял изменённые файлы и писал, менялась ли структура проекта.

Что нужно сделать

Подготовьте черновик проектных инструкций для такого проекта. Это может быть один файл, например AGENTS.md или CLAUDE.md, а может быть и небольшой набор файлов, если вы считаете, что маршрутизацию и правила лучше разделить по разным документам. Если хотите, можно предложить и вариант со структурированными правилами для Cursor.

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

В решении обязательно должны быть:

  • раздел с базовым контекстом проекта;
  • раздел с маршрутизацией по типам задач;
  • раздел с ограничениями;
  • раздел с рабочими соглашениями или проверками качества;
  • раздел с форматом итогового отчёта.

Что отправить на проверку

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

Пример структуры ответа:

[Файл: AGENTS.md]
# AGENTS.md
...

[Файл: docs/agent-routing.md]
# Routing
...

[Файл: docs/testing-rules.md]
# Testing Rules
...

При желании можно приложить короткое пояснение на 3-5 предложений, почему вы выбрали именно такую структуру, но основным артефактом должны быть сами инструкции.

На что смотрит проверяющий

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

Формат ответа

Допустимый формат: текстовый ответ в Stepik.

Режим проверки: проверяется другими учениками.

О данных в ответах

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

Файлы к ответу

PDF, PNG, JPEG или WebP — до 10 файлов по 8 МБ.

Начать заново?

Помощник начнёт новый диалог по этой задаче. Текущая переписка останется в истории до конца срока хранения.

О переписке

Можно приложить до трёх фото PNG, JPEG или WebP по 5 МБ.

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

Проверка решения остаётся отдельным действием.