몇가지 Cursor rules 자동생성도구 중 Cursor의 장점인 “프로젝트 고유 규칙”을 설정하면 AI가 훨씬 정확하고 일관된 코드를 작성해준다. 그런데 규칙 파일을 처음부터 직접 타자를 쳐서 만드는 것은 상당히 번거로운 일이다.

​

예를 들어, 아래와 같은 문제가 있다.

  • 프로젝트 아키텍처를 완전히 이해해야 한다.

  • 어떤 레이어에 대한 어떤 룰을 적용해야 하는지 판단해야 한다.

  • 예시도 많이 넣어야 한다.

  • 작성 시간이 꽤 많이 듦

그래서 이런 불편을 해결하려고 cursor-rules-composer라는 툴을 만들었다. 이 도구를 사용하면 Cursor에게 프롬프트 한번 던지는 것만으로 리포지토리 구조를 기반으로 완전 자동 룰 파일을 생성할 수 있다.

​

cursor-rules-composer란?

cursor-rules-composer는 리포지토리의 구조 및 아키텍처를 분석하고 그 결과를 기반으로 Cursor Rules(.mdc파일)을 자동생성해주는 도구이다.

​

주요 특징

① 아키텍처 자동 분석

  • 디렉토리 구조 분석

  • 다양한 아키텍처 패턴 자동 인식(클린 아키텍처, MVC, 기능단위 구조 등)

  • 사용언어, 프레임워크 자동 감지

② 적절한 Rule 파일 구조 분리

  • base/: 프로젝트 전체에 적용되는 글로벌룰 (alwaysApply: true)

  • app/: 레이어/모듈별 상세 규칙 (alwaysApply: false)

  • testing/: 테스트 관련 규칙

③ 정확한 glob 패턴 자동 생성

minimatch 규칙에 맞춰 룰마다 필요한 파일 패턴을 자동 생성한다.

④ 실코드 기반 “구현 예시 링크” 자동 생성

해당 레이어의 실제 파일을 찾아 룰파일에 링크로 달아준다.

사용방법

① 도구 다운로드

GitHub에서 cursor-rules-composer를 내려받는다.

리포지토리: https://github.com/gaebalai/cursor-rules-composer

② tree 설치

리포지토리 구조 인식을 위해 tree 명령이 필요하다.

brew install tree # macOS

③ 설정

룰을 생성하고 싶은 프로젝트 루트에 .cursor/commands/cursor-rules-composer/디렉토리를 통째로 넣는다.

④ Rule 생성 흐름

Cursor의 Plan mode를 사용해 아래 단계를 진행한다.

1단계: Plan 작성

  • Plan Mode 열기

  • 모델: GPT-5.1, GPT-5.1-codex, Claude Opus등 고성능 모델 추천

  • 프롬프트

  • @init.md 의 내용을 완전히 읽고, 파일의 지시에 따라 전력을 다해 작업해 주세요.

2단계: Cursor가 질문하면 답하기

프로젝트 구조나 의도에 대해 몇가지 질문을 한다. 있는 그대로 답하면 된다.

3단계: Plan 실행

Cursor에게

build

이라고 입력하면 작업이 시작된다. 모델은 고성능이 아니라더라도 문제는 없다.

4단계: 생성된 룰 확인

.cursor/rules/ 아래에 룰 디렉토리가 자동생성된다. 부자연스러운 부분이나 빠진 부분이 있으면 Cursor에게 바로 수정요청을 하면 된다.

5단계: 마무리

작업이 끝나면 커맨드 디렉토리를 삭제해도 된다.

​

모범사례

① alwaysApply 전략

전체 규칙을 향상 적용하면 성능과 컨텍스트 점유율이 나빠진다. 그래서 아래처럼 나누는 것을 추천한다.

  • alwaysApply: true – 프로젝트 전체의 지침, 아키텍처 개요, 코딩스타일 규칙 (3~5개 파일이면 충분)

  • alwaysAPply: false – 레이어별/모듈별 상세규칙 (domain, usecase, controller 등)

② 단계적 개선

처음부터 완벽하게 맞추려고 하지 마세요. 사용하면서 조금씩 AI에게 수정하게 하면 된다.

Rule 생성 → 실사용 → 모델이 오작동 → Rule 조정

이 사이클이 정답이다.

​

지원하는 아키텍처 패턴

레이어 아키텍처

  • 클린 아키텍처/어니언 아키텍처

  • 헥사고날(PA, Ports & Adapters)

  • 3-Layers 구조

UI/기능 기반 아키텍처

  • MVC

  • MVVM

  • Feature-based Architecture

  • Modular Monolith

  • 마이크로서비스

프레임워크 기반

  • Django

  • Next.js

  • NestJS

  • Rails

  • 기타 주요 프레임워크

​

​

마무리

cursor-rules-composer를 사용하면 손으로 룰을 만들었던 귀차니즘이 많이 사라진다.

Cursor를 제대로 활용해보고 싶은 분들은 꼭 사용해 보세요.

​

GitHub 리파지토리: https://github.com/gaebalai/cursor-rules-composer

2026년도 차세대 AI 개발 트렌드에 맞춤 교육을 제공합니다.

AI 코딩의 새로운 흐름, 바이브 코딩과 스펙 주도 개발로 생산성을 극대화하세요! LangChain/LangGraph를 활용한 실전 에이전트 구축부터, LLM의 잠재력을 깨우는 정교한 컨텍스트 엔지니어링까지. 단순 코딩을 넘어 미래 기술을 설계하는 실전형 AI 엔지니어링 노하우를 전수합니다.