Cursor Agent: harness, план и Plan Mode

Агент в Cursor — не «чат ради чата», а связка инструкций и правил, инструментов (файлы, поиск по коду, терминал) и выбранной модели. Такой harness в Cursor подстраивается под разные модели: от этого зависит, будет ли агент после правок тянуть к линтеру или упорно грепать по репо.

Сильный приём — думать до генерации: опытные разработчики чаще сначала планируют задачу; у агента тогда появляются конкретные цели, а не размытый запрос «сделай красиво».

Три слоя harness

Cursor описывает агентную обвязку тремя компонентами: инструкции (системный промпт и rules), инструменты (редактирование файлов, поиск, терминал) и модель. Обвязка настраивается отдельно под каждую frontier-модель — одна и та же формулировка на разных LLM даёт разное поведение: кто-то предпочитает grep, кто-то ждёт явного «запусти линтер».

Plan Mode: Shift+Tab

Плановый режим включается в поле ввода агента: Shift+Tab переключает Plan Mode. Вместо немедленного кода агент сначала исследует репозиторий, задаёт уточняющие вопросы и строит пошаговый план с путями к файлам и ссылками на фрагменты кода — удобно для крупных рефакторингов и неочевидных задач.

План открывается как Markdown: лишние шаги можно выкинуть, уточнить формулировки или добавить контекст, который агент пропустил. Кнопка «Save to workspace» кладёт план в .cursor/plans/ — пригодится команде и следующему агенту на той же фиче.

Контекст без перегруза

Не обязательно тегать каждый файл вручную: агент ищет по репозиторию через grep и семантический поиск. Если знаете точный путь — укажите; если нет — опишите задачу словами («поток аутентификации»). Длинные диалоги накапливают шум: после завершения логической единицы работы лучше новый чат, а прошлое подтянуть через @Past Chats.

Rules и Skills

Постоянные правила проекта — в .cursor/rules/ (стиль, команды сборки, куда класть API-роуты). Skills — динамические навыки, которые агент подключает по ситуации. Для ру-соло это способ не объяснять одно и то же на каждом промпте.

Когда откатываться к плану

Если агент собрал не то, что вы хотели, быстрее откатить diff и уточнить план, чем десять раз «подправь вот это». Cursor прямо рекомендует: revert → конкретнее план → повторный прогон. Так меньше мусора в git и меньше шума в контексте чата.

Для мелких правок (одна функция, typo) Plan Mode не обязателен — переключайтесь в обычный агент и идите коротким путём. Граница простая: если затрагивается больше трёх файлов или вы сами не уверены в архитектуре, сначала план.

Источник: Cursor — agent best practices.