Полезные советы при разработке с AI IDE агентами

Основано на личном опыте при работе с Cursor AI на фулстек (Vue.js, PHP, БД, CI/CD) проектах

Используйте по возможности системный промпт. Cursor позволяет иметь .cursorrules файл, в котором можно прописать основные установки по проекту. Пример файла.Напишите свой и попросите AI улучшить его. Автокомплит его плохо видит, но chat и composer - вполне. По крайней мере, CSS дизайн систему проекта и свои компоненты при генерации кода использует четко.
Научитесь азам promp-engineering (https://www.promptingguide.ai/). Это полезно и при разработке, и при диалогах с обычными чатботами. От простого few-shots prompt эффективность результата может вырасти в разы. Не надо винить AI в тупости, если вы не умеете формулировать вопрос на языке, который ему более понятен.
Используйте сильные стороны AI. Он может хорошо сгенерить новый компонент, новый микросервис, добавить функционал, сделать i18n перевод, дать совет по какой-то лучшей практике в определённой области, рефакторить, делать рутинные задачи, писать тесты, но не так хорошо работает на больших изменениях с существующим кодом. Также может с нуля нагенерировать плохой неоптимальный код на нестандартных задачах.
Используйте его как консультанта перед реализацией какой-то задачи. Задайте несколько вопросов в чате, как что-то можно сделать (с использованием вашего кода как контекста), проанализируйте варианты, выберите подходящий и дальше в composer начните постепенно его реализовывать, руководя процессом. Стратегически важные вопросы задавайте также разным внешним системам - Gemini, ChatGPT, DeepSeek. Иногда кто-то один даёт явно более лучший ответ.
Вместо «Напиши такой-то модуль» используйте цепочку: проектирование API, реализация core‑логики, добавление обработки ошибок, интеграция с существующим кодом, оптимизация производительности.
AI - не старик Хоттабыч, он не творит чудеса. Более того, он очень тупой. Тупой инструмент. Но сильный. Управление им это как управление двухтонным ковшом экскаватора - можно быстро сделать много полезного, и можно быстро сделать кучу плохого (со своим кодом). Которую потом будешь долго разгребать.
AI хорошо генерит комментарии и документацию. Можете добавить сразу, например, VitePress к проекту и поддерживать его техническую документацию.
При использовании AI сервисов в приложении используйте структурированные (JSON) ответы. Не все это умеют, но последняя 4o-mini, например, умеет (по JSON-scheme). С учетом цены на нее, она очень эффективна для парсинга, скажем, документов или картинок, из которых предварительно можно вытащить текст конвенциональными методами (pdf2text и OCR).
Пробуйте разные модели. Причем, разные модели для разных случаев. Дороже ≠ лучше.
Часто используемые промпты можно хранить в отдельных текстовых файлах и ссылаться на них.
Научитесь использовать структурированные промпты при необходимости, например:

/analyze-tech-debt --focus=duplication,complexity --suggest-refactoring

Для современных LLM они, часто, предпочтительней для простых ясных задач

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

Другая интересная и полезная информация о Vue.js и фронтенде в целом на нашем Телеграм‑канале: @vuefaq