Практикум 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 МБ.
