---
name: 작업 완료 시 인수인계서 동시 갱신 + 커밋 메시지 제안 + 커밋 해시는 자동 로그 참조
description: 코드 변경이 끝나면 같은 응답 안에서 관련 인수인계서까지 자동 갱신하고 한국어 커밋 메시지 한 줄을 제시한다. 커밋 해시는 post-commit 훅이 누적하는 commit_log.txt 에서 참조.
type: feedback
---

## 1. 커밋 메시지 제안

작업이 완료되면 항상 git 커밋에 사용할 메시지를 함께 제시한다.

**Why:** 사용자가 직접 커밋한다 (Claude 가 `git commit` 하지 말 것). 매번 메시지 작성 요청을 반복시키지 않기 위함.

**How to apply:**
- 작업 완료 응답 마지막에 별도 섹션으로 커밋 메시지 제시
- 한국어 **타이틀 한 줄** (한 작업 = 한 커밋, 본문 불릿은 일반적으로 불필요)
- **티켓번호(`[1845]` 등) prefix 는 임의로 붙이지 말 것** — 사용자가 직접 추가
- 변경 핵심을 간결히 (무엇을/어디서/어떻게 압축형)

## 2. 작업 완료 시 인수인계서 동시 갱신 (커밋 신호 기다리지 말 것)

작업이 끝나면 **별도 지시 없어도 관련 인수인계서까지 같은 응답에서 함께 갱신**한다.

**Why:** 사용자 피드백 (2026-05-06): "내가 커밋하면 자동으로 여기까지 해줘야 한다." 코드만 변경하고 인수인계서를 빼먹으면 사용자가 커밋 직전에 다시 갱신을 요청해야 하므로 흐름이 끊김. 인수인계서는 후임/리뷰의 1차 자료라 코드 변경과 동시 반영이 필수.

**How to apply:**
- 응답 구성 순서: ① 코드 변경 요약 → ② 인수인계서 갱신 → ③ 커밋 메시지 제안.
- **갱신 대상 인수인계서 매핑** (qcast-front `docs/`):
  - Straight Skeleton 라인 이동, 외벽선/처마선/내부선/오버 이동/phantom ridge/hip vs ridge → `SK_MOVEMENT_HANDOVER.md`
  - 모달·다이얼로그·라인 표시·계산기 패드·라벨/색/인덱스 → `UI_MODAL_HANDOVER.md`
  - API 안정화·인증/세션·동시 UPDATE 데드락·errSave·재시도·dev 스크립트 → `API_STABILITY_HANDOVER.md`
  - 모듈/배치/회로(PCS·접속함)/처마/가대/[1xxx] 티켓 시리즈 → `MODULE_CIRCUIT_HANDOVER.md`
  - 트랙이 새로 생기면 `HANDOVER_INDEX.md` 에도 항목 추가
- 갱신 방식: **기존 §번호 보존**, 새 항목은 **마지막 번호 다음에 신규 섹션으로 append** (기존 §번호를 미루지 말 것 — diff 부담↑)
- 새 섹션에는 **작성일(YYYY-MM-DD)**, 배경(무슨 일이 있었나), 한 일(파일·라인·태그), 후속 확인 포인트
- 사소한 변경(오타·포맷팅 등) 인수인계서 정책에 영향 없으면 갱신 생략 가능. 의심되면 갱신 쪽으로 기울 것.
- 인수인계서 갱신은 같은 커밋에 묶을지 별도 커밋으로 분리할지 사용자에게 안내

## 3. 커밋 해시는 자동 로그에서 참조 (수동 기록 X)

2026-05-06 부터 qcast-front 저장소에 git `post-commit` 훅이 설치되어, 커밋 직후 자동으로 `~/.claude/projects/-Users-cha-Works-Projects-qcast3-qcast-front/memory/commit_log.txt` 에 한 줄 append 된다.

**How to apply:**
- 인수인계서/리뷰/리포트에 해시를 인용해야 할 때 이 로그 파일을 먼저 참조 (또는 `git log -1 --format='%h %s'`)
- Claude 가 메모리 파일에 해시를 수동으로 누적하지 말 것 (이중 기록 금지)
- 푸시 여부는 로그에 기록되지 않으므로, 푸시 확인이 필요하면 `git log origin/<branch>..HEAD` 등으로 별도 확인
- 자세한 위치/형식은 `reference_commit_log.md` 참조