From 583837fb8d74e9524ce7c76adcb97094e5f3788e Mon Sep 17 00:00:00 2001 From: corpi Date: Fri, 27 Feb 2026 13:28:57 +0900 Subject: [PATCH] =?UTF-8?q?docs(session):=20=EC=BB=A4=EB=B0=8B=20=EB=A9=94?= =?UTF-8?q?=EC=8B=9C=EC=A7=80=20=ED=95=9C=EA=B5=AD=EC=96=B4=20=EA=B7=9C?= =?UTF-8?q?=EC=B9=99=EC=9D=84=20=EB=AA=85=EC=8B=9C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 맥락: - 커밋 메시지는 한국어로 작성해야 한다는 팀 규칙을 문서와 템플릿에 반영하기 위해 변경사항: - docs/06_commit_convention.md에 한국어 작성 필수 규칙 추가 - docs/07_session_recovery.md의 커밋 예시를 한국어로 교체 - .gitmessage-session.txt 템플릿 본문 항목을 한국어로 변경 검증: - 변경 파일 수동 검토 세션-상태: 한국어 커밋 규칙과 템플릿이 반영됨 세션-다음: 기능 커밋에도 동일한 한국어 템플릿을 적용 세션-리스크: 기존 과거 커밋 메시지는 영어가 포함될 수 있음 --- .gitmessage-session.txt | 12 ++++++------ docs/06_commit_convention.md | 24 +++++++++++++++--------- docs/07_session_recovery.md | 16 ++++++++-------- 3 files changed, 29 insertions(+), 23 deletions(-) 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 +세션-상태: 복구 문서와 스크립트가 준비됨 +세션-다음: 다음 기능 커밋부터 동일 포맷 적용 +세션-리스크: 과거 커밋에는 세션 트레일러가 없음 ```