AI로 개발 환경 자동화하기, Cursor에 스택 설명 반복하는 거 이제 끝냄

Photo by Franck V. on Unsplash

AI로 개발 환경 자동화하기 — 세션마다 같은 말 반복하던 거 설정 파일 하나로 끊어냄

Cursor에 매번 "우리 프로젝트 Next.js 14 App Router야, Pages 아니야"라고 처음부터 설명하는 대신, 설정 파일 두 개로 그 반복을 완전히 없애버린 사람 이야기야.

배경

6개월 동안 Cursor를 매일 쓰면서 가장 시간 갉아먹는 게 뭔지 찾아봤더니, AI가 느린 게 아니었어. 문제는 세션 시작할 때마다 같은 설명을 반복하는 거였거든.

• "App Router야, Pages 아니야"
• "API 레이어 건드리지 마"
• "shadcn이랑 Zod 써"
• "수정 제안 전에 npm run typecheck 먼저 돌려"

이 대화를 매번 처음부터 하고 있었던 거지. 그게 쌓이면 하루에 꽤 되는 시간이야.

사용한 AI 툴과 방법

Cursor를 메인으로 쓰면서, 두 가지 파일을 만들었어.

하나는 CLAUDE.md, 다른 하나는 .cursorrules. 이 두 파일을 프로젝트 루트에 넣어두면 Cursor가 세션 시작할 때 자동으로 읽어들여. 거기다 디버그용, 스캐폴드용, 배포 체크리스트용 프롬프트 파일 세 개를 미리 만들어서 필요할 때 바로 붙여넣는 방식으로 운영해.

핵심은 DO NOT 섹션이야. "API 레이어 리팩토링하지 마", "Pages Router 패턴 쓰지 마" 같은 금지 항목을 명시적으로 적어두면, AI가 갑자기 멀쩡한 코드를 뜯어고치는 상황 자체가 안 생겨.

결과

• Pages Router 패턴 제안이 사라짐
• 불필요한 리팩토링 시도가 차단됨
• 매번 다르게 썼던 프롬프트가 일관성 있게 유지됨
• GitHub에 무료 샘플 공개 후 반응 좋음 (Next.js 스택 + 프롬프트 3개 포함)

세션 시작 비용이 거의 0에 가까워졌다고 표현하더라.

따라할 수 있는 포인트

AI로 개발 환경 자동화하기 원한다면 이 순서대로 해봐.

1. 프로젝트 루트에 .cursorrules 파일 만들고, 스택 정보 + DO NOT 항목 적어
2. [CUSTOMIZE] 태그 달아서 나중에 수정할 부분 표시해두면 관리 편해
3. 자주 쓰는 작업(디버그, 기능 추가, 배포 전 체크)별로 프롬프트 파일 분리해서 저장해
4. 새 프로젝트 시작할 때 이 파일들 복사해서 3줄만 바꾸면 끝

스택이 다르면 파일 내용만 바꾸면 돼. 구조 자체는 React, Vue, 어디든 그대로 써.

---

한줄 정리: Cursor에 반복 설명하는 시간, 설정 파일 두 개로 끊을 수 있어.

🔗 참고 링크

• 원본 출처: I stopped re-explaining my Next.js stack to Cursor every session — here's the config I use
• 관련 AI 툴: Cursor