50 lines
4.3 KiB
Markdown
50 lines
4.3 KiB
Markdown
---
|
|
name: 작업 완료 시 커밋 메시지 제안 + 인수인계서 자동 갱신 + 커밋 해시는 자동 로그 참조
|
|
description: 작업이 끝났을 때 한국어 커밋 메시지 한 줄과 함께 관련 인수인계서까지 자동으로 갱신하고 제시한다. 커밋 해시는 post-commit 훅이 누적하는 commit_log.txt에서 참조한다.
|
|
type: 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`에도 항목 추가.
|
|
- 갱신 방식: **기존 번호 시리즈를 가능한 보존**, 새 항목은 **마지막 번호 다음에 신규 섹션으로 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` 참조
|