docs(reviews): 공용 리뷰 가이드 두 파일을 design-docs 정본 포인터로 바꾼다 #9

Merged
donghyeon.kang merged 1 commits from docs/review-guide-pointer into main 2026-11-07 08:22:40 +00:00
Owner

무엇을, 왜

리뷰 가이드 docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md와 실행 체크리스트 docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md는 백엔드·프론트 두 템플릿이 함께 쓰는 리뷰 기준이다. 그런데 지금은 이 repo 안에만 있다.

소유자가 2026-11-06에 이 둘을 design-docs로 옮기기로 정했고(위임 루프 설계 결정 D13), 정본은 이미 design-docs main 5f35810에 들어갔다. 이 repo에 사본이 그대로 남으면 같은 본문이 두 곳에 생겨 서로 갈라진다.

이 PR은 두 파일을 정본 위치만 알려 주는 포인터로 바꾸고, docs/README.md의 reviews/ 행을 그에 맞춘다.

고른 방법과 버린 대안

  • 포인터로 바꾼다. 정본 경로는 design-docs 저장소 기준(conventions/...) 코드 표기로 적는다. 다른 저장소라 상대 링크로는 이 checkout에서 따라갈 수 없기 때문이다.
  • 절 번호는 그대로 쓸 수 있다고 적는다. 정본과 이 repo 판의 차이는 맨 위 「옮긴 기록」 블록과 서로 가리키는 링크뿐이라 절 번호가 같다. 옮기기 전 마지막 판을 읽는 git show 명령(가이드 003832b6, 체크리스트 752a61f2)도 포인터에 적는다.
  • 파일 이름과 위치는 그대로 둔다. CLAUDE.md와 지난 리뷰 문서가 이 경로를 가리키므로 링크가 끊기지 않는다.
  • 버린 대안: 두 파일 지우기. CLAUDE.md 링크와 지난 리뷰 문서의 가이드 경로가 끊긴다.

위험과 영향

  • design-docs를 받지 않은 환경(파생 복사본, CI)에서는 정본을 열 수 없다. 이력이 있는 checkout은 포인터의 git show 명령으로 옛 판을 읽는다.
  • CLAUDE.md는 여전히 포인터 파일을 리뷰 기준으로 가리킨다. 링크를 design-docs로 바꿀지는 소유자가 정한다. 이 PR에서는 바꾸지 않는다.
  • 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)이었다. 지금 main(d359dde6)의 트리는 그 커밋과 같아서 이 결과가 그대로 유효하다.
  • 같은 변경을 옛 main 위에 올린 중복 브랜치 claude/sweet-wilson-d98732(7e5d70e0)는 지웠다. 바뀐 세 파일의 내용이 이 브랜치와 같다.

리뷰어가 볼 곳

  • docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md, docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md: 포인터의 정본 경로와 git show 명령
  • docs/README.md의 reviews/ 행

관련

  • 위임 루프 설계 결정 D13(design-docs)
  • 정본: design-docs main 5f35810
## 무엇을, 왜 리뷰 가이드 `docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md`와 실행 체크리스트 `docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md`는 백엔드·프론트 두 템플릿이 함께 쓰는 리뷰 기준이다. 그런데 지금은 이 repo 안에만 있다. 소유자가 2026-11-06에 이 둘을 design-docs로 옮기기로 정했고(위임 루프 설계 결정 D13), 정본은 이미 design-docs main `5f35810`에 들어갔다. 이 repo에 사본이 그대로 남으면 같은 본문이 두 곳에 생겨 서로 갈라진다. 이 PR은 두 파일을 정본 위치만 알려 주는 포인터로 바꾸고, `docs/README.md`의 `reviews/` 행을 그에 맞춘다. ## 고른 방법과 버린 대안 - **포인터로 바꾼다.** 정본 경로는 design-docs 저장소 기준(`conventions/...`) 코드 표기로 적는다. 다른 저장소라 상대 링크로는 이 checkout에서 따라갈 수 없기 때문이다. - **절 번호는 그대로 쓸 수 있다고 적는다.** 정본과 이 repo 판의 차이는 맨 위 「옮긴 기록」 블록과 서로 가리키는 링크뿐이라 절 번호가 같다. 옮기기 전 마지막 판을 읽는 `git show` 명령(가이드 `003832b6`, 체크리스트 `752a61f2`)도 포인터에 적는다. - **파일 이름과 위치는 그대로 둔다.** `CLAUDE.md`와 지난 리뷰 문서가 이 경로를 가리키므로 링크가 끊기지 않는다. - **버린 대안: 두 파일 지우기.** `CLAUDE.md` 링크와 지난 리뷰 문서의 가이드 경로가 끊긴다. ## 위험과 영향 - design-docs를 받지 않은 환경(파생 복사본, CI)에서는 정본을 열 수 없다. 이력이 있는 checkout은 포인터의 `git show` 명령으로 옛 판을 읽는다. - `CLAUDE.md`는 여전히 포인터 파일을 리뷰 기준으로 가리킨다. 링크를 design-docs로 바꿀지는 소유자가 정한다. 이 PR에서는 바꾸지 않는다. - `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`)이었다. 지금 main(`d359dde6`)의 트리는 그 커밋과 같아서 이 결과가 그대로 유효하다. - 같은 변경을 옛 main 위에 올린 중복 브랜치 `claude/sweet-wilson-d98732`(`7e5d70e0`)는 지웠다. 바뀐 세 파일의 내용이 이 브랜치와 같다. ## 리뷰어가 볼 곳 - `docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md`, `docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md`: 포인터의 정본 경로와 `git show` 명령 - `docs/README.md`의 `reviews/` 행 ## 관련 - 위임 루프 설계 결정 D13(design-docs) - 정본: design-docs main `5f35810`
donghyeon.kang added 1 commit 2026-11-07 08:21:58 +00:00
문제
리뷰 가이드와 실행 체크리스트는 백엔드·프론트 두 템플릿이 함께 쓰는
리뷰 기준인데 프론트 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).
donghyeon.kang merged commit 48c7695b5b into main 2026-11-07 08:22:40 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#9