좋은 커밋 메시지 쓰기
미래의 여러분이 고마워할 메시지
⏱ 예상 ~8분
01 · 읽기
좋은 커밋 메시지는 미래의 여러분(과 팀원)에게 주는 선물이에요. 단지 무엇을 바꿨는지뿐 아니라, 왜 바꿨는지 설명해 줘야 해요. 명확한 메시지가 깃 이력을 진짜로 쓸모 있게 만들어요.
💡 상상해 봐요좋은 커밋 메시지를 쓰는 건 사진 뒷면에 라벨을 붙이는 것과 같아요. '할머니 집에서 한 세 살 생일 파티'는 큰 도움이 돼요. '사진'은 안 그렇죠. 몇 달 뒤가 되면, 이 라벨이 각 스냅샷이 무엇을 찍은 건지 떠올릴 수 있는 유일한 단서예요.
핵심 정리
- 좋은 메시지는 이유를 설명해요: 'Fix login timeout for slow connections'
- 나쁜 메시지는 모호해요: 'fixed stuff', 'update', 'asdf'
- 첫 줄은 짧게(50자 이내), 명령형 어조로: 'Add', 'Fix', 'Update'
02 · 터미널 실습
HTML과 CSS가 들어 있는 블로그 프로젝트가 있어요. 전체 흐름으로 좋은 커밋 메시지 쓰기를 연습해요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
03 · 터미널 실습
모든 파일을 스테이지해서 첫 커밋을 만들어요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
04 · 터미널 실습
첫 커밋에서는 이 프로젝트에 무엇이 들어 있는지 설명해야 해요. 'first commit'이라고만 쓰지 말고, 출발점이 무엇인지 구체적으로 적어요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
05 · 퀴즈
아래 중 베스트 프랙티스에 맞는 커밋 메시지는 무엇일까요?
- "fixed stuff"
- "Add user login validation for email format"
- "update"
- "changes"
06 · 터미널 실습
이제 블로그에 새 기능을 추가해 봐요 — 내비게이션 바예요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
07 · 터미널 실습
수정된 파일을 스테이지해요.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
08 · 터미널 실습
이 변경의 커밋 메시지를 작성해요. 'update'라고만 쓰지 말고, 무엇을 추가했는지 설명해요. 좋은 예: 'Add navigation bar to blog', 'Add nav links for Home, About, Contact'.
(이 섹션은 인터랙티브해요 — JavaScript를 켜 주세요.)
09 · 퀴즈
아래 중 프로 관례에 가장 맞는 커밋 메시지는 무엇일까요?
- "updated stuff"
- "asdfjkl"
- "Fix password reset for expired tokens"
- "I changed the login page to fix a bug where users couldn't log in when their session expired after 24 hours"
⚠ 전체 인터랙티브 경험에는 JavaScript가 필요해요. JavaScript를 켜고 새로 고침해 주세요.
※ 이 사이트는 독립 운영되는 교육 프로젝트로, Anthropic의 공식 제품이 아니에요. Claude™ 는 Anthropic, PBC 의 상표예요.