qcast-front/.claude/memory/feedback_handover_sync.md

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