Git Merge Guide

본 프로젝트에서 작업 브랜치를 main에 병합하는 전체 플로우입니다.

⚠ 시작 전 주의사항

1. 이미 main에 올라와 있는 파일의 위치·이름 변경은 반드시 개발자와 상의 후 진행해 주세요.
2. Stash는 가능하면 지우지 마세요. 적어도 한 달 간은 보관해 주세요.
3. 진행이 어려우시면 하단의 연락처로 관리자를 불러 주세요.

01 워킹 트리 정리

Stage 되지 않은 변경사항이 없도록 워킹 트리를 깔끔하게 만들어 주세요.
정리할 수 없는 변경이 있다면 커밋하고 넘어가세요.

📌 대상 프로젝트

본 프로젝트 DreamCraft의 모든 프로젝트 기준입니다.

02 main 체크아웃 & Pull

main 브랜치로 체크아웃한 뒤 원격의 최신 상태를 Pull 해 주세요.

$ git checkout main
$ git pull origin main

03 내 브랜치 → main 머지 (Squash)

내 작업 브랜치를 우클릭 → Merge into 'main' 을 선택해 주세요.

✔ Squash 옵션 활성화

💡 커밋 메시지 규칙

커밋 메시지에 머지한 브랜치 이름을 그대로 적어 주세요.
예시 — feature/smelting-system

메시지 작성 후 커밋해 주세요.

04 내 브랜치로 다시 체크아웃

머지가 완료되면 다시 내 작업 브랜치로 돌아가 주세요.

$ git checkout feature/my-branch

05 main → 내 브랜치 동기화

main 브랜치를 내 브랜치에 Merge into 하여 최신 상태를 동기화해 주세요.

✔ Default 옵션 사용

06 Stash 적용

Step 1에서 스태쉬해 둔 변경사항이 있다면 이 시점에 다시 적용(Pop)해 주세요.

$ git stash pop

⚠ Conflict 가능

스태쉬 내용과 현재 브랜치 상태가 충돌할 수 있습니다. 아래 대처법을 참고해 주세요.

💡 Conflict 대처법

충돌이 발생하면 Stash와 내 브랜치 중 하나를 선택하라는 안내가 나옵니다.

Stash = 자신이 직접 작업한 내용
내 브랜치 = main에서 합쳐진 작업물

어떤 쪽을 살릴지 적절히 판단하여 선택해 주세요.

🛟 문제가 발생하거나 불안한 경우

무리하게 진행하지 말고, 아래 연락처로 관리자에게 문의해 주세요.

Email claud_dev@dreamcraftent.com

Tel 010-9916-5563