diff --git a/.gitmessage-session.txt b/.gitmessage-session.txt index 54cd11a..8b438b4 100644 --- a/.gitmessage-session.txt +++ b/.gitmessage-session.txt @@ -1,14 +1,14 @@ (): -Context: +맥락: - -Changes: +변경사항: - -Validation: +검증: - -Session-State: -Session-Next: -Session-Risks: +세션-상태: +세션-다음: +세션-리스크: diff --git a/docs/06_commit_convention.md b/docs/06_commit_convention.md index bf04f88..559834c 100644 --- a/docs/06_commit_convention.md +++ b/docs/06_commit_convention.md @@ -10,11 +10,17 @@ (): ``` +## 언어 규칙 (필수) + +- 커밋 제목의 ``는 한국어로 작성한다. +- 커밋 본문도 한국어로 작성한다. +- 영문 사용은 `type/scope`, 경로, 코드 식별자 같은 고유명사에 한정한다. + 예시: -- `feat(app-hub): compact CTA layout for desktop` -- `refactor(room): replace member count with vibe metadata` -- `docs(session): add recovery playbook and state template` +- `feat(app-hub): 데스크톱 CTA를 내용폭 버튼으로 조정` +- `refactor(room): 인원 수 표시를 분위기 메타데이터로 전환` +- `docs(session): 세션 복구 가이드와 템플릿 추가` ## type 규칙 @@ -28,18 +34,18 @@ ## 권장 본문 템플릿 ```text -Context: +맥락: - 왜 이 변경이 필요한지 -Changes: +변경사항: - 실제 변경 사항 -Validation: +검증: - 실행한 검증 (예: npx tsc --noEmit) -Session-State: <현재 상태 한 줄> -Session-Next: <다음 우선순위 한 줄> -Session-Risks: <남은 리스크 한 줄> +세션-상태: <현재 상태 한 줄> +세션-다음: <다음 우선순위 한 줄> +세션-리스크: <남은 리스크 한 줄> ``` ## 커밋 크기 규칙 diff --git a/docs/07_session_recovery.md b/docs/07_session_recovery.md index 2f09992..37f4079 100644 --- a/docs/07_session_recovery.md +++ b/docs/07_session_recovery.md @@ -7,7 +7,7 @@ ## 권장 방식 (Hybrid) -1. 커밋 메시지: Conventional + Session trailer +1. 커밋 메시지: Conventional + 세션 트레일러(한국어) 2. 상태판: `docs/90_current_state.md` 유지 3. 복구 커맨드: `npm run session:recover` @@ -22,20 +22,20 @@ ## 커밋 예시 ```text -docs(session): add recovery workflow and commit template +docs(session): 세션 복구 워크플로우와 커밋 템플릿 추가 -Context: +맥락: - codex cli 중단 시 작업 맥락 손실을 줄이기 위해 -Changes: +변경사항: - docs/06_commit_convention.md 추가 - docs/07_session_recovery.md 추가 - scripts/session/recover-context.sh 추가 -Validation: +검증: - 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 +세션-상태: 복구 문서와 스크립트가 준비됨 +세션-다음: 다음 기능 커밋부터 동일 포맷 적용 +세션-리스크: 과거 커밋에는 세션 트레일러가 없음 ```