Developer Tools

Cursor AI Rules 기초 가이드 Rules는 Cursor와 대화하면서 Edit의 동작을 지속적으로 제어하는 "시스템 지침"입니다. Project Rules: 프로젝트 리포지토리 안에 버전 관리되는 규칙. 코드베이스 맥락/워크플로/스타일을 표준화 할 수 있다. User Rules: 내 Cursor 전역 환경에 항상 적용되는 개인 선호/커뮤니케이션 스타일. AGENTS.md: AI의 메모리에 기억되는 정보. Rules가 하는 일 Rules는 Agent 대화 시 "항상 앞부분 컨텍스트"로 주입되어 예측 가능한 응답과 일관된 코드 생성/편집을 보장해준다. 적용 대상: Chat과 Inline Edit 활성 Rules는 Agent 사이드바에서 확인 가능하다. Rules는 기본적으로 Cursor Settings에서 Rules & Memories에서 설정이 가능하다. Project Rules 설계 Project Rules는 각 규칙이 파일 하나이며, 리포지토리 내 .cursor/rules/에 저장된다. 하위 폴더에 중첩 규칙 디렉터리를 둘 수 있어, 해당 영역의 파일을 다룰 때 자동으로 붙는다. Rule 타입 Always: 항상 모델 컨텍스트에 포함 Auto Attached: 지정한 glob(경로 패턴)에 해당 파일이 참조될 때만 포함 Agent Requested: 에이전트가 필요하다고 판단하면 포함(설명을 꼭 작성) Manual: @ruleName로 명시적으로 불러올 때만 포함 MDC 포맷(메타 + 본문) 각 Rule 파일은 MDC(.mdc) 형식으로 작성한다. 상단 메타에서 동작을 제어하고, 본문에는 실제 지침/예시/레퍼런스를 적는다. 중첩 규칙 구조 예시 생성/관리 워크플로

1. Cursor 란? Cursor는 VS Code와 유사한 사용 경험을 제공하고 자동완성(Tab), 인라인 편집, 여러 AI Agent 프롬프트 등 기능을 활용할 수 있는 AI-first IDE 입니다. 핵심은 "대화 → 제안 → Diff 검토 → 부분 적용" 루프를 에디터 안에서 끝낼 수 있고, 비개발자도 Agent를 통해 비교적 쉽게 개발에 입문할 수 있다는 점입니다. 2. 설치 & 시작 cursor.com에서 OS에 맞춰 앱 설치 → 가입 혹은 소셜 계정을 통한 로그인 기존 프로젝트 폴더 혹은 새 폴더 열기 사이드바 Chat 아이콘으로 Ask/Agent 패널 확인 Agent에 질문을 시작하여 프로젝트 시작. 기존 프로젝트인 경우 해당 프로젝트 분석 요청 가능. (심화) .cursorrules 추가를 통해 프로젝트 이해도 향상 3. 주요 개념/기능 한눈에 자동완성(Tab): 함수/테스트/주석 기반 멀티라인 제안 인라인 편집: 선택 영역에 자연어로 수정 지시 → Diff로 검토 후 부분 적용 Ask vs Agent: Ask: 코드 이해·문서화·설명 등 읽기 중심 Agent: 여러 파일 수정·명령 실행·테스트 등 행동 중심 Repo 문맥: 파일 간 레퍼런스·API 사용처·테스트를 연결해 변경 범위를 제안 Rules 주입: 프로젝트 규칙을 .cursorrules로 고정 → 일관된 제안 유도 4. Cursor의 장점 속도: 자동완성 + 인라인 수정으로 마우스 전환/창 전환을 최소화