process Work Flow

작업 흐름

Cherrish 프로젝트의 표준 작업 흐름입니다. 모든 작업은 이 흐름을 따라주세요.

---

📋 이슈 관리

모든 이슈는 초기에 정의해놓고 시작합니다.

새로운 이슈 추가가 필요한 경우

• 추가 기능이 필요하거나 버그를 발견한 경우
• ISSUE 추가 또는 Discussions에 글을 올려주세요

---

⚠️ 주의사항

작업 전에 꼭 확인해주세요!

1. Custom Command는 Github CLI가 설치되어 있어야 사용 가능합니다
2. 코드 리뷰는 해당 코드에 대해 책임을 같이 가져가는 일입니다!

---

🚀 새로운 작업 시작하기

1. 이슈 상태 업데이트

TODO → In Progress로 변경

2. 브랜치 생성

작업용 브랜치를 생성합니다.

3. 해당 작업 진행

이슈에 정의된 작업을 진행합니다.

---

✅ 작업 완료 후 체크리스트

1. 테스트 코드 작성 및 실행

• 테스트 코드 작성
• 모든 테스트 통과 확인

2. AI 코드 리뷰 진행

Claude Custom Command 또는 직접 프롬프트를 작성하여 사용합니다.

# 커밋 리뷰
/commit-review c11e0a4   # 특정 커밋 이후부터 HEAD까지 리뷰
/commit-review HEAD~3    # 최신 커밋 3개 리뷰
/commit-review develop   # develop 브랜치부터 현재 작업까지 리뷰

# 도메인 리뷰
/domain-review post      # post 도메인에 대해 리뷰
/domain-review src/main/java/com/sopt/cherrish/global  # 절대 경로 사용 (토큰 절약)

3. 빌드 및 포맷 검사

./gradlew build  # Checkstyle 포맷 검사

4. PR 작성

PR 템플릿에 맞춰 작성합니다.

5. 검증 확인

• ✅ CI 파이프라인 통과 확인
• ✅ 코드래빗 리뷰 개선사항 반영
• ✅ 최소 1명 Approve

6. 병합

모든 조건이 충족되면 병합합니다.

---

👀 다른 사람 PR 검토하기

1. AI 코드 리뷰 진행

Claude Custom Command 또는 직접 프롬프트를 작성하여 사용합니다.

/pr-review 6  # 6번 PR 리뷰

2. 추가 코드 검토 후 Approve

• 코드를 꼼꼼히 확인합니다
• 문제가 없다면 Approve 합니다
• 개선사항이 있다면 코멘트로 공유합니다

---

📊 전체 작업 흐름 요약

이슈 생성 → TODO로 등록
    ↓
이슈 상태 변경 (TODO → In Progress)
    ↓
브랜치 생성
    ↓
작업 진행
    ↓
테스트 코드 작성 및 실행
    ↓
AI 코드 리뷰
    ↓
빌드 및 포맷 검사
    ↓
PR 작성
    ↓
CI/코드래빗/팀원 리뷰
    ↓
병합