confeti-pr-creation

name	confeti-pr-creation
description	Confeti 프로젝트 PR 생성 워크플로우. 브랜치 생성, 커밋 분리, PR 템플릿 작성, gh CLI 사용법을 포함. 코드 변경 후 PR을 올려야 할 때 사용.
license	MIT
metadata	{"author":"claude","version":"1.0.0"}

Confeti PR Creation Skill

confeti-client 모노레포에서 PR을 생성하는 전체 워크플로우.

When to Apply

• 코드 변경 완료 후 PR을 올려야 할 때
• 커밋을 논리적으로 분리해야 할 때
• PR 템플릿에 맞춰 본문을 작성해야 할 때

Prerequisites

NVM + Husky 환경 설정

이 프로젝트는 husky pre-commit hook이 pnpm을 사용하므로, git commit 전에 반드시 NVM을 소싱해야 한다:

export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

이 명령어를 모든 git commit 명령어 앞에 붙여야 한다. 그렇지 않으면 husky hook이 pnpm: command not found 에러를 발생시킨다.

Workflow

Step 1: 변경 사항 확인

git status
git diff --stat

변경된 파일 목록과 범위를 확인한다.

Step 2: 기존 PR 스타일 확인

gh pr list --state merged --limit 5 --json number,title,body

최근 머지된 PR의 제목과 본문 형식을 참고한다.

Step 3: 브랜치 생성

현재 브랜치에서 feature 브랜치를 생성한다:

git checkout -b <type>/<description>

브랜치 네이밍 컨벤션:

• feat/기능-설명 — 새 기능
• refactor/리팩토링-설명 — 리팩토링
• fix/버그-설명 — 버그 수정
• chore/작업-설명 — 설정, 의존성 등

Step 4: 커밋 분리 전략

변경 사항을 관심사별로 논리적 커밋으로 분리한다:

1. 새로운 훅/유틸리티 → 별도 커밋 (의존성 없는 새 파일)
2. 컴포넌트 리팩토링 → 관련 컴포넌트를 묶어 하나의 커밋
3. 기능 통합 (orchestration) → 새 훅/유틸을 사용하는 상위 컴포넌트 변경
4. UX/스타일 변경 → UI 관련 변경은 별도 커밋

Step 5: 커밋 실행

반드시 NVM 소싱 후 커밋:

export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh" && git add <files> && git commit -m "<type>: <한국어 설명>"

커밋 메시지 컨벤션:

• feat: 한국어 설명 — 새 기능
• refactor: 한국어 설명 — 리팩토링
• fix: 한국어 설명 — 버그 수정
• chore: 한국어 설명 — 기타 작업
• style: 한국어 설명 — 스타일 변경
• docs: 한국어 설명 — 문서 변경

Step 6: 푸시

git push -u origin <branch-name>

Step 7: PR 생성

gh pr create --base develop --head <branch-name> --title "<Type>(Scope): 설명" --body "$(cat <<'EOF'
## 📌 Summary

> 관련 이슈 또는 요약

변경 내용 요약

## 📚 Tasks

- [ ] 작업 항목 1
- [ ] 작업 항목 2

## 👀 To Reviewer

- 리뷰어에게 전달할 내용

🤖 This PR was authored by Claude
EOF
)"

PR 제목 형식: <Type>(Scope): 한국어 설명

• 예: Refactor(Timetable): 타임테이블 블록 편집 배치 저장 리팩토링

PR 본문 필수 섹션:

1. ## 📌 Summary — 변경 요약 (관련 이슈 태그 포함)
2. ## 📚 Tasks — 수행한 작업 목록
3. ## 👀 To Reviewer — (선택) 리뷰어에게 전달할 내용
4. ## 📸 Screenshot — (선택) 스크린샷

Claude가 작성한 PR인 경우: 본문 마지막에 🤖 This PR was authored by Claude 추가.

Common Pitfalls

1. NVM 소싱 누락 → husky hook 실패. 모든 git commit 앞에 NVM export 필수.
2. develop 대신 main에 PR → 항상 --base develop 사용.
3. 커밋 너무 크게 묶기 → 관심사별로 분리. 하나의 커밋에 훅 + 컴포넌트 + 스타일 전부 넣지 말 것.
4. lint-staged 실패 → pre-commit에서 eslint/prettier가 자동 수정. 수정된 파일 다시 add 후 amend.