corpi
ecb17a485a
Context: - codex cli 중단 후에도 작업 품질과 맥락을 안정적으로 복구하기 위해 Changes: - docs/00~07, 90 문서 세트 추가/정리 - commit convention 문서 및 .gitmessage-session.txt 템플릿 추가 - scripts/session/recover-context.sh 추가 - package.json에 session:recover 스크립트 추가 Validation: - npm run session:recover Session-State: session recovery docs, template, and script are in place Session-Next: apply this commit format to feature and refactor commits Session-Risks: legacy commits before this change do not include session trailers
1.2 KiB
1.2 KiB
06. Commit Convention
목적
세션이 끊겨도 커밋 이력만으로 복구 가능하도록, 메시지를 사람이 읽기 쉬우면서 기계적으로도 파싱 가능한 형태로 통일한다.
기본 형식 (Conventional Commits)
<type>(<scope>): <summary>
예시:
feat(app-hub): compact CTA layout for desktoprefactor(room): replace member count with vibe metadatadocs(session): add recovery playbook and state template
type 규칙
feat: 사용자 가시 기능 추가/변경fix: 버그 수정refactor: 동작 동일한 구조 개선style: UI 스타일/카피 조정docs: 문서 추가/수정chore: 설정/스크립트/의존성 정리
권장 본문 템플릿
Context:
- 왜 이 변경이 필요한지
Changes:
- 실제 변경 사항
Validation:
- 실행한 검증 (예: npx tsc --noEmit)
Session-State: <현재 상태 한 줄>
Session-Next: <다음 우선순위 한 줄>
Session-Risks: <남은 리스크 한 줄>
커밋 크기 규칙
- 1커밋 1의도 원칙
- 화면 변경과 구조 변경이 모두 크면 분리 커밋
- 대규모 리팩터링은 중간 checkpoint 커밋을 남긴다