Files
clean-architecture-frontend…/docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md
T
DongHyeonka 21dd9dc96c docs(reviews): 공용 리뷰 가이드 두 파일을 design-docs 정본 포인터로 바꾼다
문제
리뷰 가이드와 실행 체크리스트는 백엔드·프론트 두 템플릿이 함께 쓰는
리뷰 기준인데 프론트 repo의 docs/reviews/ 안에 있었다. 소유자가
2026-11-06 design-docs로 옮기기로 정했고(위임 루프 설계 결정 D13),
정본이 design-docs main 5f35810에 들어갔다. 이 repo의 사본이 그대로
남으면 두 곳에 본문이 생겨 서로 갈라진다.

고른 방법
- 두 파일을 정본 위치만 적은 포인터로 바꿨다. 정본 경로는 design-docs
  저장소 기준(conventions/...)으로, 링크 없이 코드 표기로 적었다.
  다른 저장소라 상대 링크는 이 checkout에서 따라갈 수 없다.
- 포인터에 절 번호가 정본에서도 같다는 것과, 옮기기 전 마지막 판을
  읽는 git show 명령(가이드 003832b6, 체크리스트 752a61f2)을 적었다.
  정본과 이 repo 판의 차이는 맨 위 "옮긴 기록" 블록과 서로 가리키는
  링크뿐이라 절 번호는 바뀌지 않았다.
- 파일 이름과 위치는 그대로 뒀다. CLAUDE.md와 지난 리뷰 문서가 이
  경로를 가리키므로 링크가 끊기지 않는다.
- docs/README.md의 reviews/ 행을 "가이드는 design-docs로 옮겼고
  여기에는 포인터만 있다"로 고쳤다.
- 버린 대안: 두 파일 삭제. CLAUDE.md 링크와 지난 리뷰 문서의 가이드
  경로가 끊긴다. CLAUDE.md는 소유자 승인 대상이라 이 커밋에서 바꾸지
  않는다.

위험과 한계
- design-docs를 받지 않은 환경(다운스트림 복사본, CI)에서는 정본을
  열 수 없다. 이력이 있는 checkout은 git show 명령으로 옛 판을 읽는다.
- CLAUDE.md는 여전히 포인터 파일을 리뷰 기준으로 가리킨다. 링크를
  design-docs로 바꿀지는 소유자가 정한다.
- verify:documentation은 docs/README.md 1절에서 링크한 문서만 보므로
  포인터 두 파일 안의 경로는 검사하지 않는다.

검증
- desktop에서 corepack pnpm verify:documentation, corepack pnpm
  test:unit 통과. 로그는 desktop ~/d13-review-guide-pointer-logs/.
- 기준 브랜치: PR #8 끝 fix/maturity-review-2026-11-06(1141969f).
2026-11-07 11:18:42 +09:00

1.3 KiB

Template 프로젝트 성숙도 리뷰 실행 체크리스트 — 옮긴 곳

이 체크리스트는 2026-11-06에 design-docs 저장소로 옮겼다. 이 파일에는 본문이 없고 정본 위치만 적는다.

  • 정본: design-docs 저장소의 conventions/template-maturity-review-execution-checklist.md
  • 정본이 들어간 design-docs main 커밋: 5f35810 (옮긴 커밋은 ec44d5a)
  • 옮긴 이유: 리뷰 가이드가 실행 순서로 가리키는 짝 문서다. 가이드와 함께 옮겼다.
  • 리뷰 가이드의 정본 위치: TEMPLATE-MATURITY-REVIEW-GUIDE.md

절 번호

정본의 절 번호(1~10절)는 이 파일에 있던 판과 같다. 짝인 리뷰 가이드의 절 번호(0.1·0.3, 35, 36.x 등)도 정본 가이드에서 그대로다.

정본에서 달라진 것은 맨 위 "옮긴 기록" 인용 블록과, 첫 문단에서 리뷰 가이드를 가리키는 링크뿐이다.

옮기기 전 판

옮기기 전 마지막 판은 이 repo 이력에 있다. 이 파일을 마지막으로 바꾼 커밋은 752a61f2다.

git show 752a61f2:docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md

고칠 때

체크리스트를 고칠 일이 생기면 design-docs의 정본을 고친다. 이 파일에 본문을 다시 넣지 않는다. 두 곳에 본문이 있으면 서로 갈라진다.