협업 규칙 — 브랜치 전략·커밋 메시지·.gitattributes 줄 끝·hooks 로 팀 규칙 세우기

혼자 쓰는 저장소는 규칙이 없어도 됩니다. 하지만 여러 사람이 같은 저장소를 쓰면 브랜치 이름, 커밋 메시지, 줄 끝, 커밋 전 검사까지 합의가 필요합니다. 이 규칙을 코드와 설정으로 강제하는 방법을 다룹니다.

1. 왜 배우는가

브랜치 이름이 제각각이면 지금 무엇을 작업 중인지 목록만 봐서는 알 수 없습니다. feature/, fix/ 같은 접두어 하나로 이 문제가 풀립니다. 팀 규모와 배포 주기에 맞는 브랜치 전략을 고르면 병합 충돌과 배포 실수가 크게 줄어듭니다.

커밋 메시지도 마찬가지입니다. "수정함" 같은 메시지는 6개월 뒤 git log 를 볼 때 아무 정보도 주지 않습니다. Conventional Commits 형식을 따르면 릴리스 노트를 자동으로 뽑을 수도 있습니다.

Windows 팀원과 리눅스 서버가 섞이면 줄 끝(line ending) 문제가 반드시 터집니다. 사람이 기억해서 조심하는 방법은 실패합니다. 저장소에 .gitattributes 를 두고 훅(hook)으로 커밋 전에 자동 검사하면 실수 자체가 일어나지 않습니다.