Первый проект в Cursor: пошаговый план на вечер

Страх «сломаю проект» обычно не про Cursor, а про отсутствие отката. Пока вы правите файлы в main без коммита и без понимания diff, любая правка агента ощущается необратимой. Когда есть ветка и commit «до агента», паника падает: худший сценарий - удалить ветку и начать снова.

Критерий готового вечера, который я даю новичкам: npm run dev поднимается, вы вручную кликнули изменённый экран, git diff main показывает не больше пяти файлов, и merge прошёл только после lint или test из вашего package.json. Это не «идеальный продукт», это законченный цикл: задача - правка - проверка - merge.

Начать пользоваться cursor без слепого принятия всех правок - значит заранее решить, что сегодня вы не трогаете auth, deploy, миграции БД и production-конфиги. Один видимый результат: текст на лендинге, одна валидация в форме, один failing test, который стал зелёным. Всё остальное - следующий вечер.

Где новичок чаще всего жмёт «принять всё»: Agent предложил десять файлов, diff не открыли, checkpoint не заметили. Итог - полчаса на откат вместо пятнадцати минут на пофайловый контроль. Я не запрещаю Agent на первом проекте; я прошу сначала Git, потом Plan, потом diff.

Открыть папку vs клонировать репо

Создать проект в Cursor - значит открыть папку с кодом, а не нажать «New Project» в мастере. File → Open Folder на существующую директорию или на пустую, куда вы скопируете учебный шаблон. Как открыть проект в cursor повторно: тот же Open Folder или список Recent в стартовом окне.

Новый проект на вечер - пустая папка плюс git init, если у вас свой черновик, либо clone одного учебного репозитория с GitHub. Про запрос «гитхаб лучшие проекты для cursor»: не нужна подборка топ-репо. Возьмите один знакомый стек - landing на Vite, маленький API на Express, тот же шаблон, что на курсе. Цель - потренировать ветку и diff, а не изучать чужую архитектуру.

Критерии маленькой задачи на 2-3 часа

Примеры, которые я даю на первом занятии: поменять заголовок и CTA на hero-блоке; добавить проверку email в одной форме; починить один падающий unit-test. Каждый вариант виден глазами за минуту.

WordPress и Cursor - один абзац

Если сайт на WordPress, откройте в Cursor папку child-темы или локальной копии, а не весь хостинг целиком. Редактор видит файлы темы как обычный проект: style.css, functions.php, шаблоны. Отдельного «соединения» WordPress с Cursor нет - есть папка с кодом. Подробнее в FAQ внизу статьи.

Git на первом вечере - не «для красоты», а слой страховки. Checkpoint в Agent откатывает файлы внутри сессии, но не заменяет version control между вечерами. Официальная формулировка в документации checkpoints: снимки Agent и Git живут отдельно.

Порядок до первого промпта, который я прошу повторить:

1. 01

   Open Folder на папку проекта.

2. 02

   git init или clone, если репо ещё нет.

3. 03

   Добавить .gitignore с .env, node_modules, build-артефактами.

4. 04

   git checkout -b first-evening/<короткое-имя-задачи>.

5. 05

   Commit «до агента» - чистое состояние ветки.

6. 06

   Минимум Cursor Rules - scope, verify-команды, запрет .env.

Для cursor git удобнее начать с панели Source Control в боковой колонке: Initialize Repository, Stage, Commit - без обязательного терминала. Терминал всё равно пригодится для npm test, но ветку можно завести и через UI, как в VS Code.

Фрагмент bash-страховки на вечер:

git checkout -b first-evening/fix-hero-text
git add -A
git commit -m "checkpoint: before agent"
# если агент ушёл не туда до commit:
git checkout .

Минимум cursor rules до Agent - текстом в .cursor/rules или project rule:

```markdown

На первом проекте я включаю Plan Mode почти всегда. Shift+Tab в поле Agent переключает режим: агент задаёт уточняющие вопросы, показывает reviewable plan, и только после вашего одобрения переходит к Build. Если план ушёл в сторону - не «долечивайте» бесконечным чатом, а revert и уточните план заново. Так описано в Plan Mode docs.

Промпт, который я копирую ученикам:

Задача: заменить заголовок hero на «…» и подзаголовок на «…».

Разрешённые файлы:
- src/components/Hero.tsx
- src/styles/hero.css

Не трогать: package.json, .env, deploy, config, тесты вне Hero.

Критерий готовности:
- npm run dev без ошибок
- я вручную открыл главную и вижу новый текст
- git diff не больше 3 файлов

Checkpoints создаются автоматически перед крупными правками Agent. Restore в истории чата откатывает файлы, но не сообщения - это undo внутри сессии. Для отката между вечерами или перед merge нужен Git. Две страховки, не взаимозаменяемые.

Worktrees и команда /worktree - следующий шаг, когда одной ветки на вечер мало и вы хотите изолировать агента в отдельном checkout. В IDE нативная кнопка worktree - в Agents Window; в обычном окне - через skills. На первый вечер это опционально, не обязательный вход.

Терминальные команды по умолчанию требуют approval - это нормально. Не отключайте подтверждения ради скорости на первом проекте. .cursorignore дополнительно скрывает от агента чувствительные пути, но не заменяет .gitignore и дисциплину diff.

После Build откройте Source Control и просмотрите каждый изменённый файл. Agent Review через /agent-review в окне Agent - опциональный слой: Quick для скорости, Deep для глубины. С Cursor 3.11 часть настроек review переезжает в Git & PRs → Pull Requests; если пункт в Settings сместился - ищите там. Я на первом вечере делаю review вручную: diff глазами, потом скрипты из package.json.

Сокращённая таблица PASS перед merge - практика из как проверять код от ИИ, не теория:

Verify после Agent - только ваши команды, не слова в чате:

npm run lint && npm test && npm run build

Если агент написал «тесты прошли», но вы не видели вывода в терминале - считайте, что тесты не запускались. Зелёный merge - после реального exit code 0.

Принимайте правки по файлам или небольшими группами. Когда diff разросся до десятков файлов без вашего контроля - stop, restore checkpoint или git checkout ., сузьте Plan и начните снова. На разборе это экономит часы.

Три уровня отката - когда какой:

1. 01

   Restore Checkpoint - агент только что ушёл не туда, вы ещё в той же сессии, файлы нужно вернуть на минуту назад.

2. 02

   git checkout . или git restore . - правки после commit «до агента», но до нового commit; рабочая копия грязная.

3. 03

   git switch main && git branch -D first-evening/... - вечер неудачный, начинаете задачу с чистого листа на новой ветке.

Не пытайтесь «договориться» с агентом починить хаос из двадцати файлов одним сообщением. Revert, сузить scope, один файл за раз - быстрее.

Первый вечер закрыт, когда вы прошли полный цикл: ветка, Plan, правка, diff, verify, merge. Дальше можно углублять инструменты, а не расширять scope до «перепиши весь проект».

Worktrees имеют смысл, когда параллельно крутите несколько гипотез агента и не хотите мешать их в одной рабочей копии. Команды /apply-worktree и /delete-worktree переносят или убирают изолированный checkout - см. worktrees docs. Пока одна задача на вечер - хватает обычной ветки.

Что читать дальше:

• Как пользоваться Cursor AI - режимы, установка, первый вход.
• Cursor Rules - scope и verify на постоянку.
• Как проверять код от ИИ - полная таблица merge PASS.

На разборе я смотрю не «красивый ли промпт», а есть ли обратимый цикл: commit до Agent, diff после, rollback без паники. Без этого любой cursor проект превращается в лотерею.

Проверено 2026-08-26. Источники: cursor.com/docs/agent/plan-mode, cursor.com/docs/agent/overview#checkpoints, cursor.com/docs/agent/agent-review, практика первых вечеров на наставничестве.