cursor-dev-sdd

Cursor IDE용 스펙주도개발(Spec-Driven Development, SDD) 템플릿, 룰(규칙), 커맨드 모음 패키지이다.

v1.5.1

설치방법

# 권장 방식 (매번 실행 / 설치 불필요)
npx cursor-dev-sdd@latest

# 프로젝트 의존성으로 추가하고 싶은 경우
npm i -D cursor-dev-sdd

실행 시, 프로젝트의 .cursor/ 폴더에 필요한 파일들이 복사된다.

의존성으로 설치한 경우 실행방법

npm i -D cursor-dev-sdd만 실행해도, .cursor/폴더는 자동으로 변경되지 않는다. 아래 명령어를 명시적으로 실행해야 설정이 완료된다:

npx cursor-dev-sdd

강제 덮어쓰기

이미 .cursor/ 폴더가 존재하는 경우, 동일 이름의 파일은 기본적으로 스킵된다. 기존 파일을 무시하고 강제로 덮어쓰고 싶은 경우 다음 옵션을 사용한다.

npx cursor-dev-sdd --force

초기 설정

rules/frontend.md 파일에는 현재 기본 룰이 작성되어 있지 않다. 이 파일에는 각자 평소에 사용하던 프론트엔드 관련 규칙을 작성한다.

• 파일 이름은 자유롭게 변경해도 문제없다.
• 다만, 각 규칙 파일은 frontend.md에서 참조되고 있으므로 파일명을 변경할 경우 frontend.md에서 해당 이름을 검색하여 점진적으로 파일명 변경 또는 신규 파일 추가를 권장한다.

사용법

Cursor IDE에서 다음과 같은 커맨드를 사용할 수 있다:

| 커맨드 | 설명 | | ---------------------- | -------------- | | /init | 프로젝트 사양 초기화 | | /requirements | 요구사항 정의서 생성 | | /requirements-import | 기존 요구사항 불러오기 | | /design | 기술 설계서 작성 | | /check-design | 설계서 검증 | | /tasks | 작업(Task) 목록 생성 | | /impl | 구현 시작 | | /status | 진행 상황 확인 | | /difference-check | 변경·차이점 검증 |

/init 사용 방식 구분

• 프로젝트 전체 초기화: /init <프로젝트 설명>
• 특정 화면 / 기능 단위 초기화: /init --feature billing-history <화면 또는 기능 설명>
  • --feature 또는 -f로 지정한 키가 .cursor/<프로젝트명>/<feature> 디렉토리로 생성된다.
  • 이후 /requirements등의 커맨드는 <프로젝트명>/<feature> 를 인자로 전달해야 합니다.(예: /requirements my-project/billing-history)

포함된 파일 구조

.cursor/
├── commands/          # Cursor 커맨드 정의
│   ├── init.md
│   ├── requirements.md
│   ├── requirements-import.md
│   ├── design.md
│   ├── check-design.md
│   ├── tasks.md
│   ├── impl.md
│   ├── status.md
│   └── difference-check.md
├── rules/             # AI 동작 규칙 및 가이드라인
│   ├── artifacts-generation.md
│   ├── design-principles.md
│   ├── design-review.md
│   ├── design-discovery-full.md
│   ├── design-discovery-light.md
│   ├── ears-format.md
│   ├── frontend.md
│   ├── gap-analysis.md
│   ├── implementation.md
│   ├── tasks-generation.md
│   └── tasks-parallel-analysis.md
└── templates/
    ├── artifacts/     # 데이터 및 테이블 정의 템플릿
    │   ├── artifacts_rules.md
    │   ├── create-data-model.md
    │   ├── create-feature-list.md
    │   └── create-table-definition.md
    └── specs/         # 명세서 템플릿
        ├── init.json
        ├── requirements-init.md
        ├── requirements.md
        ├── design.md
        ├── tasks.md
        └── research.md

기본 워크플로우

/init → /requirements → /design → /tasks → /impl
                ↑                    ↓
            /status ←←←←←←←←←←←←←←←←

라이선스

MIT License - 자세한 내용은 LICENSE를 참조하세요.

작성자

gaebalai

변경 이력

.

문서ID: README
버전: 1.0.0
최종 업데이트: 2026-01-25