4.3 KiB
4.3 KiB
| name | description | type |
|---|---|---|
| 작업 완료 시 커밋 메시지 제안 + 인수인계서 자동 갱신 + 커밋 해시는 자동 로그 참조 | 작업이 끝났을 때 한국어 커밋 메시지 한 줄과 함께 관련 인수인계서까지 자동으로 갱신하고 제시한다. 커밋 해시는 post-commit 훅이 누적하는 commit_log.txt에서 참조한다. | feedback |
1. 커밋 메시지 제안
작업이 완료되면 항상 git 커밋에 사용할 메시지를 함께 제시한다.
Why: 사용자가 직접 git에 올리며, 매번 커밋 메시지 작성을 요청하는 번거로움을 줄이기 위함. 또한 커밋 본문에 변경 항목 타이틀이 정리돼 있어야 나중에 이력 추적이 쉬움.
How to apply:
- 작업 완료 응답 마지막에 별도 섹션으로 커밋 메시지 제시
- 한국어로 타이틀 한 줄만 작성 (예: "로컬 프로필 파일 로깅 활성화 + 로그 경로 프로젝트 내부로 이동")
- 사용자는 명령 → 작업 완료 → 즉시 커밋 흐름이므로, 한 작업 단위가 곧 한 커밋. 본문 불릿은 불필요.
- 예외적으로 한 작업에 정말 이질적인 변경이 섞인 경우에만 본문 불릿을 추가 (드문 경우)
- 티켓번호(
[1487],[2133]등) prefix는 절대 임의로 붙이지 말 것 — 사용자가 직접 추가하는 영역. Claude는 타이틀 본문만 작성. - 변경 핵심을 간결하게 (무엇을/어디서/어떻게의 압축형)
- 사용자가 직접 커밋하므로 Claude가 임의로
git commit실행하지 말 것
2. 작업 완료 시 인수인계서 동시 갱신 (커밋 신호 기다리지 말 것)
작업이 끝나면 별도 지시 없어도 관련 인수인계서까지 같은 응답에서 함께 갱신한다. 사용자는 작업 완료 → 즉시 커밋 흐름이라, "인수인계서도 했지?"라고 한 번 더 물어보게 만들면 안 된다.
Why: 사용자 피드백(2026-05-06): "내가 커밋을 하면 자동으로 여기까지 해줘야 한다." 코드 변경만 하고 인수인계서를 빼먹으면 사용자가 커밋 직전에 다시 갱신을 요청해야 하므로 흐름이 끊김. 인수인계서는 후임/리뷰의 1차 자료라 코드 변경과 동시 반영이 필수.
How to apply:
- 작업 완료 응답에서: ① 코드 변경 요약 → ② 인수인계서 갱신 → ③ 커밋 메시지 제안 순서로 구성.
- 갱신 대상 인수인계서 매핑 (qcast-api
doc/):- 견적서·발전시뮬·Excel/PDF 출력 →
OUTPUT_HANDOVER.md - QSP↔프론트 DTO 변경, 중간서버 스키마 →
DTO_MIDDLE_SERVER_HANDOVER.md - 인증·로그인 추적·errSave류 →
AUTH_ERROR_HANDOVER.md - 그 외 도메인 (BOM/권한/우편번호/배치 등) →
DOMAIN_HANDOVER.md - 트랙이 새로 생기면
HANDOVER_INDEX.md에도 항목 추가.
- 견적서·발전시뮬·Excel/PDF 출력 →
- 갱신 방식: 기존 번호 시리즈를 가능한 보존, 새 항목은 마지막 번호 다음에 신규 섹션으로 append (기존 §번호를 한 칸씩 미루지 말 것 — diff 부담↑).
- 새 섹션에는 작성일(YYYY-MM-DD), 배경(무슨 일이 있었나), 한 일(파일·라인), 후속 확인 포인트를 넣음. 사용자 메모리 정책 "코드 주석에 날짜 포함"과 동일 원칙.
- 변경이 사소하거나(오타, 포맷팅 등) 인수인계서 정책에 영향 없는 경우는 갱신 생략 가능. 단 의심되면 갱신 쪽으로 기울 것.
- 인수인계서 갱신 자체도 같은 커밋에 포함되도록 사용자에게 안내 (별도 커밋 분리 옵션도 같이 제시).
3. 커밋 해시는 자동 로그에서 참조 (수동 기록 X)
2026-05-06부터 qcast-api 저장소에 git post-commit 훅이 설치되어, 커밋 직후 자동으로 ~/.claude/projects/-Users-cha-Works-Projects-qcast3-qcast-api/memory/commit_log.txt에 한 줄 append 된다.
How to apply:
- 인수인계서/리뷰/리포트에 해시를 인용해야 할 때는 그 로그 파일을 읽어 참조 (또는
git log -1 --format='%h %s') - Claude가 메모리 파일에 해시를 수동으로 누적할 필요 없음 (이중 기록 금지)
- 푸시 여부는 로그에 기록되지 않으므로, 푸시 확인이 필요하면
git log origin/<branch>..HEAD등으로 별도 확인 - 자세한 위치/형식은
reference_commit_log.md참조