docs(session): 커밋 메시지 한국어 규칙을 명시

맥락:

- 커밋 메시지는 한국어로 작성해야 한다는 팀 규칙을 문서와 템플릿에 반영하기 위해

변경사항:

- docs/06_commit_convention.md에 한국어 작성 필수 규칙 추가

- docs/07_session_recovery.md의 커밋 예시를 한국어로 교체

- .gitmessage-session.txt 템플릿 본문 항목을 한국어로 변경

검증:

- 변경 파일 수동 검토

세션-상태: 한국어 커밋 규칙과 템플릿이 반영됨

세션-다음: 기능 커밋에도 동일한 한국어 템플릿을 적용

세션-리스크: 기존 과거 커밋 메시지는 영어가 포함될 수 있음
This commit is contained in:
2026-02-27 13:28:57 +09:00
parent ecb17a485a
commit 583837fb8d
3 changed files with 29 additions and 23 deletions

View File

@@ -1,14 +1,14 @@
<type>(<scope>): <summary> <type>(<scope>): <summary>
Context: 맥락:
- -
Changes: 변경사항:
- -
Validation: 검증:
- -
Session-State: 세션-상태:
Session-Next: 세션-다음:
Session-Risks: 세션-리스크:

View File

@@ -10,11 +10,17 @@
<type>(<scope>): <summary> <type>(<scope>): <summary>
``` ```
## 언어 규칙 (필수)
- 커밋 제목의 `<summary>`는 한국어로 작성한다.
- 커밋 본문도 한국어로 작성한다.
- 영문 사용은 `type/scope`, 경로, 코드 식별자 같은 고유명사에 한정한다.
예시: 예시:
- `feat(app-hub): compact CTA layout for desktop` - `feat(app-hub): 데스크톱 CTA를 내용폭 버튼으로 조정`
- `refactor(room): replace member count with vibe metadata` - `refactor(room): 인원 수 표시를 분위기 메타데이터로 전환`
- `docs(session): add recovery playbook and state template` - `docs(session): 세션 복구 가이드와 템플릿 추가`
## type 규칙 ## type 규칙
@@ -28,18 +34,18 @@
## 권장 본문 템플릿 ## 권장 본문 템플릿
```text ```text
Context: 맥락:
- 왜 이 변경이 필요한지 - 왜 이 변경이 필요한지
Changes: 변경사항:
- 실제 변경 사항 - 실제 변경 사항
Validation: 검증:
- 실행한 검증 (예: npx tsc --noEmit) - 실행한 검증 (예: npx tsc --noEmit)
Session-State: <현재 상태 한 줄> 세션-상태: <현재 상태 한 줄>
Session-Next: <다음 우선순위 한 줄> 세션-다음: <다음 우선순위 한 줄>
Session-Risks: <남은 리스크 한 줄> 세션-리스크: <남은 리스크 한 줄>
``` ```
## 커밋 크기 규칙 ## 커밋 크기 규칙

View File

@@ -7,7 +7,7 @@
## 권장 방식 (Hybrid) ## 권장 방식 (Hybrid)
1. 커밋 메시지: Conventional + Session trailer 1. 커밋 메시지: Conventional + 세션 트레일러(한국어)
2. 상태판: `docs/90_current_state.md` 유지 2. 상태판: `docs/90_current_state.md` 유지
3. 복구 커맨드: `npm run session:recover` 3. 복구 커맨드: `npm run session:recover`
@@ -22,20 +22,20 @@
## 커밋 예시 ## 커밋 예시
```text ```text
docs(session): add recovery workflow and commit template docs(session): 세션 복구 워크플로우와 커밋 템플릿 추가
Context: 맥락:
- codex cli 중단 시 작업 맥락 손실을 줄이기 위해 - codex cli 중단 시 작업 맥락 손실을 줄이기 위해
Changes: 변경사항:
- docs/06_commit_convention.md 추가 - docs/06_commit_convention.md 추가
- docs/07_session_recovery.md 추가 - docs/07_session_recovery.md 추가
- scripts/session/recover-context.sh 추가 - scripts/session/recover-context.sh 추가
Validation: 검증:
- bash scripts/session/recover-context.sh - bash scripts/session/recover-context.sh
Session-State: recovery docs and script are in place 세션-상태: 복구 문서와 스크립트가 준비됨
Session-Next: apply workflow to next feature commit 세션-다음: 다음 기능 커밋부터 동일 포맷 적용
Session-Risks: legacy commits have no trailers 세션-리스크: 과거 커밋에는 세션 트레일러가 없음
``` ```