[Cursor] 있는 지도 몰라서 사용 못하는 .cursorrules 파일 활용법

많은 개발자들이 Cursor IDE를 사용하고 있지만, 대부분은 AI의 기본 기능만 사용합니다. 하지만 .cursorrules 파일 하나로 개발 생산성을 크게 향상시킬 수 있습니다.

.cursorrules가 뭔가요?

.cursorrules는 프로젝트 루트에 생성하는 설정 파일로, Cursor의 AI에게 "이 프로젝트에서는 이렇게 코드를 작성해줘"라고 미리 알려주는 역할을 합니다.

설정 전:

• 매번 코딩 스타일을 설명해야 함
• 프로젝트 컨벤션과 맞지 않는 코드 생성
• 반복적인 설명으로 시간 낭비

설정 후:

• 한 번 설정으로 프로젝트 전체 일관성 확보
• 원하는 패턴의 코드 자동 생성
• 팀원 모두 동일한 AI 지원 받음

실제 사용 예시: NestJS + TypeScript

프로젝트 루트에 .cursorrules 파일을 만들고 다음과 같이 작성합니다:

참고: 아래는 NestJS 프로젝트의 예시입니다. 본인의 프로젝트 요구사항에 맞게 코딩 스타일, 디렉토리 구조, 사용하는 라이브러리 등을 수정해서 사용하세요.

# NestJS TypeScript 프로젝트 개발 규칙

당신은 NestJS와 TypeScript 전문 개발자입니다. 다음 규칙을 따라 코드를 작성하세요:

## 기본 원칙
- 깔끔하고 유지보수 가능한 코드 작성
- TypeScript strict 모드 사용, any 타입 금지
- 의존성 주입과 모듈러 아키텍처 활용

## 파일 구조 (프로젝트에 맞게 수정 필요)
- kebab-case로 파일명 작성 (user.service.ts)
- 기능별 모듈로 구성 (users/, auth/, common/)
- DTO, Entity, Service, Controller 분리

## 코드 패턴
```typescript
// Controller: HTTP 요청만 처리
@Controller('users')
export class UsersController {
  constructor(private readonly usersService: UsersService) {}

  @Post()
  async create(@Body() createUserDto: CreateUserDto): Promise<User> {
    return this.usersService.create(createUserDto);
  }
}

// Service: 비즈니스 로직
@Injectable()
export class UsersService {
  constructor(
    @InjectRepository(User)
    private readonly userRepository: Repository<User>,
  ) {}
}

// DTO: 유효성 검사 (사용하는 validation 라이브러리에 맞게 수정)
export class CreateUserDto {
  @IsString()
  @IsNotEmpty()
  readonly name: string;

  @IsEmail()
  readonly email: string;
}

## 필수 구현 사항 (프로젝트 정책에 맞게 조정)
- 모든 입력에 DTO 검증 적용
- HTTP 예외 처리 (BadRequestException 등)
- 각 기능별 단위 테스트 작성
- 환경변수로 민감 정보 관리

위 내용을 참고하여 우리 프로젝트의 코딩 컨벤션과 사용하는 라이브러리에 맞게 코드를 작성해주세요.

이제 "사용자 CRUD API 만들어줘"라고 하면, NestJS 패턴에 맞는 완전한 코드가 자동으로 생성됩니다.

더 많은 프롬프트는 어디서?

직접 작성하기 어렵다면 이미 검증된 프롬프트들을 활용하세요:

추천 사이트

1. cursor.directory - Cursor 전용 프롬프트 컬렉션, 언어/프레임워크별 정리
2. GitHub: awesome-cursor-rules - 커뮤니티에서 검증한 프롬프트 모음

효과적인 활용법

1. 위 사이트에서 본인 기술 스택 검색
2. 별점이나 포크 수가 높은 프롬프트 확인
3. 중요: 프로젝트 요구사항에 맞게 수정해서 사용
   • 코딩 컨벤션을 프로젝트 스타일에 맞게 조정
   • 사용하는 라이브러리와 도구에 맞게 변경
   • 팀의 디렉토리 구조와 네이밍 규칙 반영
4. 팀과 공유해서 동일한 컨벤션 적용

팀 프로젝트에서 활용하기

.cursorrules 파일을 Git에 포함시키면 팀원 모두가 동일한 AI 지원을 받을 수 있습니다:

# 프로젝트에 포함
git add .cursorrules
git commit -m "Add cursor AI rules for consistent code generation"

이제 신입 개발자도 시니어와 비슷한 품질의 코드를 생성할 수 있고, 코드 리뷰 시간도 크게 단축됩니다.

주의사항

• 너무 세세한 규칙은 오히려 비효율적
• 프로젝트 진행에 따라 규칙 업데이트 필요
• 팀원들과 충분한 논의 후 적용
• 온라인에서 찾은 프롬프트는 그대로 사용하지 말고 프로젝트에 맞게 반드시 수정

마무리

.cursorrules 파일 하나로 AI 개발 도구의 효율성을 극대화할 수 있습니다. 특히 팀 프로젝트에서는 코드 일관성과 품질 향상에 큰 도움이 됩니다.

오늘 당장 프로젝트에 적용해보세요. 개발 속도와 코드 품질의 차이를 바로 체감할 수 있을 것입니다.