Files
clean-architecture-frontend…/docs/reviews
DongHyeonka ddc6353d81 docs(review): D7 커밋 본문의 다시 짓기 전 해시를 맞는 해시로 적는다
문제: D7 커밋 `287dc6f` 본문의 "늘어난 곳"이 1105/03-01과 1105/08-03에
적은 해시 둘은 통합에서 다시 짓기 전 해시라 `bbde570`에서 닿지 않는다
(`git merge-base --is-ancestor` rc=1). 같은 변경은 이 이력에서 `5c0b37e`,
`f849d78`이다(`git log --format='%h %s' 409d72e..bbde570`, rc=0). 원격
clone에는 두 객체가 없다. 통합 절차에 CHANGELOG·커밋 본문의 해시를 범위와
대조하는 단계가 없다.

고른 방법: 올린 이력은 고쳐 쓰지 않는다(`287dc6f`을 amend·rebase하지 않음).
1105 README 16.2절 D7 행에 본문의 두 해시가 다시 짓기 전 것이라는 것과 이
이력의 해시를 적는다(지시대로 그 행만). 닿지 않는 해시는 새로 적지 않는다.
적으면 아래 대조에 다시 걸린다. CHANGELOG 머리말의 "그 절의 해시는 모두 그
범위에 있다" 뒤에, 해시를 다시 쓴 뒤 절과 범위 커밋 본문의 해시를
`git merge-base --is-ancestor`로 대조하고 결과를 리뷰 README 조치 절에 적는
한 단계를 둔다(리뷰의 대안 b).
버린 대안: 해시를 대조하는 단위 테스트(대안 c). 싸지 않다.
- 복사한 프로젝트에는 템플릿 이력이 없거나(tech-log는 이력 없이 3-way로
  옮긴다) CI checkout이 얕을 수 있어, 테스트가 그때 건너뛰어야 한다. 조건부로
  도는 테스트는 이번 라운드 지시가 막는다.
- 커밋 본문은 작업 트리가 아니라 `git log` 범위를 읽어야 하고, 이미 올린
  `287dc6f`이 영구히 걸리므로 예외가 필요하다. 예외 추가도 지시가 막는다.
- CHANGELOG에는 다른 repo 해시(`d3810a0` 등)가 섞여 있어 repo 표시 규칙부터
  정해야 한다.

위험·한계: 대조는 사람이 하는 단계다. 빼먹으면 같은 일이 다시 난다. 완료
기준 "다음 통합 기록에 그 대조 결과가 있다"는 이번 라운드를 합칠
오케스트레이터가 채운다. 새 clone에서 `git show 287dc6f` 본문의 두 해시는
여전히 열리지 않는다.

검증: 문서만 바꿨다. desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/changelog-review-ids.test.ts
(새 괄호 `(1106/14-02, 1105 README 16.2)`가 참조 꼴을 지킨다)
git merge-base --is-ancestor 5c0b37e bbde570 && git merge-base --is-ancestor f849d78 bbde570

Refs: 1106/14-02
2026-11-06 05:21:41 +09:00
..