القائمة
ddan-ddan-server의 한국어 이슈/브랜치/PR 컨벤션. 이슈 제목 형식 [작업타입] 설명, 브랜치명 타입/#번호-설명, PR 제목 타입 설명, PR 본문 템플릿(작업 내용/기타/close 이슈) 패턴을 다룬다. 이슈 생성, 브랜치 생성, PR 생성 시 반드시 참조 — 팀 컨벤션 위반은 PR이 즉시 반려되는 사유다.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | korean-pr-convention |
| description | ddan-ddan-server의 한국어 이슈/브랜치/PR 컨벤션. 이슈 제목 형식 [작업타입] 설명, 브랜치명 타입/#번호-설명, PR 제목 타입 설명, PR 본문 템플릿(작업 내용/기타/close 이슈) 패턴을 다룬다. 이슈 생성, 브랜치 생성, PR 생성 시 반드시 참조 — 팀 컨벤션 위반은 PR이 즉시 반려되는 사유다. |
| 타입 | 용도 |
|---|---|
feat | 새로운 기능 추가 |
refactor | 동작 변경 없는 코드 정리 |
fix | 버그 수정 |
bug | 버그 수정 (fix와 혼용 — 최근 커밋 기준) |
docs | 문서/주석 수정 |
chore | 빌드, 의존성, CI/CD, 설정 |
[작업타입] 간단한 한국어 설명
[feat] 응원하기 API 추가[refactor] Ranking 기능 레이어드 아키텍처로 변경[fix] 초대수락자 이름이 뜨도록 수정작업 목적과 세부사항을 한국어로 기재. 길이 자유.
gh issue create --title "[chore] Claude Code 하네스 구성" --body "..."
{타입}/#{이슈번호}-{간단한-영어-설명}
feature/#190-ranking-refactor-to-layeredfix/#261-invite-acceptor-namechore/#194-claude-harness-setup주의: 디렉토리 깊이 표현으로 /가 들어간다. git checkout -b feature/#NNN-...로 만들 수 있다 (zsh 기준 따옴표 불필요하지만, #는 코멘트 문자이므로 인용 권장).
git checkout -b "chore/#194-claude-harness-setup"
| 작업 타입 | 브랜치 prefix |
|---|---|
| feat | feature/ |
| refactor | refactor/ |
| fix / bug | fix/ |
| docs | docs/ |
| chore | chore/ |
브랜치 prefix와 PR 타입이 살짝 다름에 유의 (
feat↔feature/).
항상 develop. main/master 직접 PR 금지.
{타입}: {한국어 설명}
feat: 초대코드로 초대자 정보 조회 API 추가refactor: 응원하기 API 성능 개선chore: Claude Code 하네스 구성주의: 제목 끝에 이슈 번호 (#N) 붙이지 않는다. 이슈 연결은 본문의 close #N으로 처리.
.github/pull_request_template.md를 따른다:
## 🔎 작업 내용
- 항목 1
- 항목 2
## ➕ 기타
- 추가 컨텍스트, 스크린샷, 리뷰어가 알아야 할 점
close #이슈번호
gh pr create --title "chore: Claude Code 하네스 구성" --body "$(cat <<'EOF'
## 🔎 작업 내용
- ...
## ➕ 기타
- ...
close #194
EOF
)"
# 1. 이슈 생성
gh issue create --title "[chore] Claude Code 하네스 구성" --body "..."
# → 이슈 번호 N 확인
# 2. 브랜치 생성 (develop 최신화 후)
git checkout develop
git pull
git checkout -b "chore/#N-claude-harness-setup"
# 3. 작업 + 커밋
git add ...
git commit -m "chore: Claude Code 하네스 구성"
# 4. push
git push -u origin "chore/#N-claude-harness-setup"
# 5. PR
gh pr create --title "chore: Claude Code 하네스 구성" --body "..."
| 실수 | 올바른 형태 |
|---|---|
PR 제목 끝에 (#194) | 본문에 close #194 |
브랜치를 feat/...로 시작 | feature/... |
이슈 제목에 feat: (콜론) | [feat] (대괄호) |
| PR을 main으로 | develop으로 |
| 영어 본문 | 한국어 본문 |
ddan-ddan-server의 기능 개발/버그 수정/리팩토링 워크플로우 오케스트레이터. 이슈 분석 → 설계 → 구현 → 테스트·API 문서 → 리뷰 → PR 생성을 6개 전문 에이전트(issue-analyzer, backend-architect, kotlin-spring-implementer, test-engineer, api-documenter, code-reviewer)가 협업하여 자동화한다. 다음 표현이 등장하면 반드시 트리거할 것 - "기능 추가", "API 만들어줘", "이슈
ddan-ddan-server의 한국어 이슈/브랜치/PR 컨벤션. 이슈 제목 형식 [작업타입] 설명, 브랜치명 타입/#번호-설명, PR 제목 타입 설명, PR 본문 템플릿(작업 내용/기타/close 이슈) 패턴을 다룬다. 이슈 생성, 브랜치 생성, PR 생성 시 반드시 참조 — 팀 컨벤션 위반은 PR이 즉시 반려되는 사유다.
ddan-ddan-server의 테스트 작성 가이드. Kotest 5.9.1 FunSpec + MockK 1.13.11 조합, beforeEach 초기화, 한국어 테스트명, shouldBe/shouldThrow assertion DSL을 다룬다. 모든 테스트 코드 작성/수정 시 반드시 참조 — 이 프로젝트는 JUnit 어노테이션 스타일이 아닌 Kotest FunSpec 스타일을 표준으로 사용한다.
ddan-ddan-server의 Kotlin/Spring Boot/MongoDB 코드 컨벤션. 생성자 주입, @Document 엔티티, JWT 인증, WebExceptionHandler 글로벌 예외 처리, LoggingFilter, OpenAPI 문서화 패턴을 다룬다. 새 코드 작성과 코드 리뷰 시 반드시 참조 — 컨벤션 위반은 PR 리뷰의 가장 잦은 지적 사유다.
ddan-ddan-server의 layered 아키텍처 의존 규칙과 패키지 구조 가이드. domain/application/infrastructure/presentation 4개 레이어의 책임, 의존 방향, Gateway 패턴(폐기 예정) 처리 방침을 다룬다. 새 코드 추가, 리팩토링, 코드 리뷰 시 반드시 참조할 것 — 레이어 의존 위반은 가장 흔하고 가장 치명적인 결함이다.
ddan-ddan-server의 기능 개발/버그 수정/리팩토링 워크플로우 오케스트레이터. 이슈 분석 → 설계 → 구현 → 테스트 → 리뷰 → PR 생성을 5개 전문 에이전트(issue-analyzer, backend-architect, kotlin-spring-implementer, test-engineer, code-reviewer)가 협업하여 자동화한다. 다음 표현이 등장하면 반드시 트리거할 것 - "기능 추가", "API 만들어줘", "이슈