---
name: 작업 완료 시 인수인계서 동시 갱신 + 2단계 커밋 (선코드 후문서) + 커밋 해시는 자동 로그 참조
description: 코드 변경이 끝나면 같은 응답에서 인수인계서/메모리도 작성. 단, 커밋은 2단계 — 1차 코드만 커밋 → 해시 확인 → 인수인계서/메모리에 해시 명시 → 2차 커밋. 해시 자리는 [TBD-CODE] placeholder.
type: feedback
---

## 1. 커밋 메시지 제안 (2단계)

작업이 완료되면 git 커밋 메시지를 **2개** 제시한다 — 1차 코드용 / 2차 문서·메모리용.

**Why:** 사용자가 직접 커밋한다 (Claude 가 `git commit` 하지 말 것). 또한 인수인계서/메모리에 자기참조 해시를 쓰려면 코드 커밋이 먼저 이뤄져야 한다 (§3 참조).

**How to apply:**
- 작업 완료 응답 마지막에 **커밋 메시지 2개** 별도 섹션으로 제시
  - **1차 (코드)**: 한국어 타이틀 한 줄. 변경 핵심 간결히.
  - **2차 (문서/메모리)**: `docs: <태그> 인수인계서/메모리 갱신 (<해시>)` 형식. `<해시>` 자리는 사용자가 1차 커밋 후 알려주면 채움.
- **티켓번호(`[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)**, 배경(무슨 일이 있었나), 한 일(파일·라인·태그), 후속 확인 포인트
- 사소한 변경(오타·포맷팅 등) 인수인계서 정책에 영향 없으면 갱신 생략 가능. 의심되면 갱신 쪽으로 기울 것.
- **커밋 해시 자리는 `[TBD-CODE]` placeholder** 로 두고 §3 의 2단계 커밋 흐름에 맡긴다.

## 3. 2단계 커밋 — 선(先)코드, 후(後)문서/메모리 (2026-05-06 신규)

**Why:** UI_MODAL_HANDOVER §1.1 표처럼 "어떤 작업이 어느 커밋인지" 인수인계서/메모리에 정확한 해시로 추적하려면, 코드 커밋이 먼저 이뤄지고 그 해시를 사후에 인수인계서/메모리에 적어야 함. 한 번에 커밋하면 자기참조 해시를 쓸 수 없음.

**How to apply:**
- 응답 구성: 코드 + 인수인계서/메모리 모두 같은 응답에서 작성. 해시가 들어갈 자리는 `[TBD-CODE]` placeholder 표시.
- 커밋 가이드 (사용자가 직접):
  1. **1차 — 코드 파일만 stage 후 커밋** → 해시 확보 (`git rev-parse --short HEAD`)
  2. 사용자가 해시를 Claude 에게 알려줌
  3. Claude 가 인수인계서/메모리의 `[TBD-CODE]` → 실제 해시로 교체
  4. **2차 — 인수인계서 + 메모리 stage 후 커밋**
- post-commit 훅의 `commit_log.txt` 에는 두 커밋 모두 자동 append (§4 참조)
- 인수인계서/메모리 변경만 단독으로 있는 작업(코드 변경 없음)은 1단계로 끝.

## 4. 커밋 해시는 자동 로그에서 참조 (수동 기록 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` 참조