[바이브코딩 교육특전!] Cursor Project Rules 요건정의부터 구현까지 자동화해주는 개발방법(MDC파일) 제공

Cursor Project Rules: AI로 요건정의부터 구현까지 올라운드 패키지

이 자료를 만든 이유

Cursor에 2100시간 이상 접한 경험을 가진 AI코딩 개발자로서 매일 4시간 이상 Cursor와 사투끝에 제품 개발을 극복한 경험을 강의를 듣는 분들에게 공유하기 위해 만든 자료입니다.

“Accept 연타 → 수수께끼 코드 → 오류 지옥”의 무한 반복에서 벗어나는 방법을 소개하고 실제 실무 개발 현장에서 만들어낸 생성형 AI 코드 정리방법을 공유합니다.

왜 개발 프로세스의 체계화가 필요한가?

개인개발이나 팀 개발에 있어서 다음과 같은 문제에 직면하고 있지 않습니까?

코드 품질 편차: 개발자에 따라 다른 코딩스타일과 명명 규칙
설계에서 구현까지 일관성이 없음: 요구사항 정의는 만들었지만 구현시 마주함
프로토타입과 프로덕션 환경 간의 격차: 프로토타입은 실행되지만, 프로독션 마이그레이션에서 많은 문제가 발생함
AI 도구 활용시 지시의 모호함: 커서에게 의뢰하지만 예상대로 결과를 얻을 수 없음
품질 보증 속인화: 테스트와 리뷰는 개인의 경험에 의존함
실패로 인한 학습 부족: 유사한 오류와 문제를 반복함

이러한 문제를 해결하기 위해 내가 실제 프로젝트에서 사용하고 효과를 느끼는 14개의 통합 개발 프로세스 프롬프트 를 자세히 설명합니다.

이번에 공개하는 프롬프트는 요구사항 정의부터 프로덕션 운용, 지속적인 개선에 이르기까지 전 공정을 커버하고 있으며, 커서와 조합함으로써 개발 효율을 극적으로 향상시킬 수 있습니다.

이번에 공개하는 프롬프트는 요구사항 정의부터 구현, 테스트, 디버깅에 이르는 모든 공정을 다루고 있으며, 커서와 결합하여 개발 효율을 극적으로 향상시킬 수 있습니다.

이런 규칙을 만들 기 전에 에러를 Cursor에서 먼저 실행해도 에러의 반복때문에 고생하던 시간들이 이 방법을 도입하게 되면서 오류해결시간이 짧아졌습니다. 이유는 자신이 만든 코드를 AI와 함께 만들어 가기 때문에 “이 Cursor의 에러는 조금 나의 의도하고 있는 부분이 다르겠지?”라고 생각하기 때문입니다.

전체 기술 스택

프론트엔드 기술

프레임워크 라이브러리

Next.js 14+ (App Router)
React (Hooks 지원)
TypeScript
shadcn/ui + Radix UI
Tailwind CSS

상태 관리 · API 연계

React Context API 또는 Redux
커스텀 후크 (useState, useEffect, useCallback 등)
HTTP 클라이언트 (fetch, axios 등)

테스트 및 개발 툴

Jest
React Testing Library
Cypress 또는 Playwright
ESLint
Prettier

백엔드 기술

프레임워크/언어

파이썬 3.8+
FastAPI
Pydantic (데이터 검증)
SQLAlchemy (ORM)

데이터베이스

PostgreSQL
SQLite(개발 환경)

테스트 및 품질 관리

pytest
pytest-mock
TestContainers
httpx(테스트용 HTTP 클라이언트)

개발 환경 및 도구

편집기 IDE

Cursor 또는 Visual Studio Code
Live Server 확장
Playwright MCP(브라우저 자동화)

버전관리, CI/CD

Git
GitHub
CI/CD 파이프라인 설정

인프라 배포

컨테이너 오케스트레이션

Docker
Docker Compose

API, 통합

API 설계 및 문서화

OpenAPI (Swagger) 3.0+
RESTful API 설계 원칙
JSON 스키마

외부 서비스 통합

외부 API 연동
Webhook 대응
인증 및 허가 (OAuth, JWT)

설계 및 아키텍처

설계 기법

4+1 뷰 모델
Mermaid 도표 작성
ADR (Architecture Decision Records)
마이크로서비스 설계(옵션)

UI/UX 디자인

디자인 툴 연계

Figma API 연계
HTML to Figma 변환
반응형 디자인

프레젠테이션

Marp (Markdown 프레젠테이션)
PowerPoint (.pptx) 변환
LibreOffice (soffice 명령)

이 내용들은 어디까지나 시스템 프롬프트에 넣는 내용이므로, “자신의 기술스택을 입력하고 이에 맞게 최적화 해주세요.”와 Cursor에게 요청하면 고쳐줍니다.

Cursor Rules: 14개 개발 프로세스 프롬프트

설계단계 (5단계)

doc01-requirements.mdc: 요구사항정의, 사용자 요구 사항 분석 및 구성 과 질문 생성
doc02-adr.mdc: 아키텍처 결정 기록, 기술 선택 기록 및 이유
doc03-database.mdc 데이터베이스 설계, 데이터베이스 설계 및 ER 다이어그램, 테이블 정의
doc04-api-spec.mdc API 사양, RESTful API 사양 자동 생성
doc05-ui-concept-prototype.mdc UI 개념 프로토타입, 초기 단계에서 UI 개념 설계 및 클라이언트 합의 형성

상세설계 및 검토 단계 (2단계)

doc06-detailed-design.mdc 상세 설계, 시스템 상세 사양 작성 (4+1 뷰 모델)
doc07-design-review-procedure.mdc 설계검토, 상세 설계 이해도 체크・품질 개선 제안

분석 및 계획단계 (2단계)

doc08_prototype_analysis.mdc 프로토타입 분석, 프로토타입의 프로덕션 적성 평가 및 갭 분석
doc09-implementation-plan.mdc 구현계획, 프로덕션 개발 구현 계획 작성 및 단계적 전략 수립

구현 및 테스트 단계(2단계)

doc10-implementation-generation.mdc 구현생성, 상세설계서·API 사양서로부터 코드 생성
doc11-test-generation.mdc 테스트생성, 구현 코드에서 레이어드 테스트 생성

품질보증 및 개선단계(3단계)

doc12-quality-assurance-validation.mdc 품질 보증 및 검증, 구현 및 테스트 계획의 품질 보증 자동화
doc13-debug.mdc 디버그, 최종 목적 역산 사고 오류 처리 및 학습 지원
doc14-ai-task-failure-analysis.mdc AI 실패분석, AI 작업의 체계적 분석 및 지속적인 개선

개발 프로세스 프롬프트를 설정하는 방법

설정시에는 .cursor/rules/에 *.mdc파일을 추가합니다.

Rule Type: Manual
파일명: 각각 파일명 그대로

01. 요구사항 정의 프롬프트 (doc01-requirements.mdc)

프롬프트 목적: 사용자의 모호한 요청을 구체적이고 구현 가능한 요구사항으로 변환하고 부족한 정보를 파악하여 적절한 질문을 생성합니다.
도입에서 고려한 점: 중요한 것은 Cursor를 사용하여 개발하는 사용자는 내 작업환경에서 인프라와 기술에 반드시 밝지 않은 사용자가 많다고 생각하였습니다. 따라서 사용자는 어떤 기술을 사용하면 구현이 완료되는지 위험이 있는지 모르는 상태라고 가정하였습니다. 그런 이유로 Cursor로부터 질문을 받으면서 기능 및 비기능적 요건을 진행시키기 위한 도움을 받도록 합니다.
프롬프트

---
alwaysApply: false
--- # 시스템의 목적 및 개요 이 시스템은 AI를 활용하여 프로그래밍 프로젝트의 요구사항 분석을 지원하는 애플리케이션을 개발합니다.
사용자가 제공한 프로젝트 요구사항을 분석하고 정리하고 부족 정보를 파악하여 적절한 질문을 제시합니다.
궁극적으로 일본어로 명확하고 간결한 지침을 생성하고 프로젝트 실행에 도움이 되는 구체적인 UI 요구 사항을 포함하여 제공합니다. # 이해 관계자와의 커뮤니케이션 원칙 ## 배경 이해의 중요성
- **배경 알아보기**: 프로젝트 발생 경위, 비즈니스 과제, 조직의 상황을 깊이 이해합니다.
- **현재 파악**: 기존 시스템의 문제점, 제약, 이용자의 실제 업무 흐름을 파악합니다.
- **과제의 본질**: 표면적 요구가 아니라 진정한 과제와 해결해야 할 문제를 식별합니다. ## 커뮤니케이션 자세
- **관심을 갖고 듣기** : 이해 관계자의 이야기에 적극적으로 관심을 보이고 세부 사항을 파악합니다.
- **진지한 자세로 듣기**: 상대의 발언을 경시하지 않고, 중요한 정보로서 진지하게 받아들입니다.
- **좋은 관계를 가지고 듣기**: 신뢰관계를 구축하고 진심을 끌어낼 수 있는 환경을 만듭니다. ## 질문의 질 향상
- 배경을 이해하고 정확하고 구체적인 질문을 합니다.
- 상대방의 입장과 전문성을 고려한 질문방법 선택합니다.
- 과제의 근본 원인을 찾기 위한 심층 질문을 준비합니다. # 실행 절차 1. **요건 분석**: - **배경 이해 단계**: - 프로젝트 발생의 경위와 배경을 자세히 파악 - 현재 업무 흐름, 시스템 구성, 과제 발생 상황 이해 - 이해관계자의 역할, 관심사, 제약조정 - 사용자가 입력한 요구사항 정보를 신중하게 읽고 주요 요소를 식별합니다. - 논리적 카테고리(예: 개발 언어, 대상 사용자, 주요 기능)로 분류합니다. - 핵심 문구를 나열하고 분석 결과를 기록합니다. 2. **부족 정보 확인 및 질문 작성**: - **배경 기반 부족 정보 파악**: - 이해한 배경을 바탕으로 진정으로 필요한 정보를 파악 - 표면적 요구 뒤에 있는 본질적인 요구를 탐구 - **관계성을 고려한 질문 설계**: - 이해관계자와의 관계를 고려한 질문방법 선택합니다. - 상대방의 전문성 수준에 맞는 질문의 말을 조정합니다. - 신뢰 관계를 손상시키지 않는 건설적인 질문을 작성합니다. - 잠재적인 과제와 제한 사항을 고려하고 구체적인 질문을 작성한다. 3. **분석 결과 제시**: - **배경 이해 공유**: 이해한 배경 및 과제 인식을 이해관계자와 공유하고 인식의 함부를 확인합니다. - 사용자에게 요구사항 분석 결과와 부족 정보를 제시합니다. - 필요한 질문을 명확하고 간결하게 제시합니다. 4. **UI 디자인 검토**: - **사용자 경험 배경 고려**: 실제 업무 흐름과 사용자 상황을 고려한 UI 설계합니다. - 필요에 따라 HTML+CSS로 UI 디자인안을 작성합니다. - 필요한 UI 요소를 나열하고 분석 결과를 기반으로 개선점을 검토합니다. 5. **최종 지침 작성**: - **배경 기반 우선순위 지정**: 이해한 과제의 중요도에 따라 구현 우선순위 결정합니다. - 전체 요구 사항을 통합하고 Markdown 형식으로 단계별 구현 계획을 작성합니다. - 먼저 기본 기능을 구현하고 나중에 추가 기능을 단계적으로 확장하는 설계로 합니다. # 입력 및 출력 형식 - **입력 형식**: 자유 형식의 텍스트로서 프로젝트 요구 사항 정보를 제공.
- **출력 형식**: - **배경 이해 보고서**: 프로젝트 배경, 현상, 과제 인식 정리 - 요구 사항 분석 결과 및 부족 정보 목록. - 최종 지시서는 Markdown 형식으로 기술. - 필요에 따라 UI 디자인안(HTML+CSS)을 부속. # 지시서 구성 다음 형식으로 지침 작성: ``markdown
# 프로젝트 배경 및 문제 인식
(프로젝트의 발생 경위, 현재의 문제, 해결해야 할 과제의 정리) # 시스템의 목적 및 개요 (전체 이미지)
(이 프로젝트에서 실현하고 싶은 것을 기술) # 구현 단계 (개별 지침)
## 1단계
(1단계에서 실장하는 구체적인 기능 및 내용) ## 2단계
(2단계에서 실장하는 구체적인 기능 및 내용)
---

사용예시

@doc01-requirements.mdc를 사용하여 다음 요구 사항을 분석하십시오.
"이커머스 사이트의 사용자 관리 기능을 만들고 싶다. 로그인, 신규 등록, 프로필 편집을 할 수 있도록 하고 싶다."

나머지는 바이브코딩 교육을 받는 수강생들에게 14개 프롬프트(Cursor Project Rules) 내용을 제공합니다.

감사합니다.

교육문의: gaebalai.official@gmail.com

연락처: 010-8014-3479