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

Closed
donghyeon.kang wants to merge 1 commits from docs/review-guide-pointer into fix/maturity-review-2026-11-06
Owner

무엇을, 왜

리뷰 가이드(docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md)와 실행 체크리스트(docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md)를 26줄짜리 포인터로 바꾼다.

  • 이 두 문서는 백엔드·프론트 두 템플릿이 함께 쓰는 리뷰 기준이다.
  • 소유자가 2026-11-06에 design-docs로 옮기기로 정했다. 정본은 design-docs main 5f35810에 들어갔다.
    • conventions/template-maturity-review-guide.md
    • conventions/template-maturity-review-execution-checklist.md
  • 이 repo에 본문이 그대로 남으면 두 곳에 같은 기준이 생기고, 고칠 때마다 갈라진다.

고른 방법과 버린 대안

  • 파일 이름과 위치는 그대로 두고 내용만 포인터로 바꿨다. CLAUDE.md와 지난 리뷰 문서가 이 경로를 가리키므로 링크가 끊기지 않는다.
  • 포인터에 적은 것:
    • 정본 경로(design-docs 저장소 기준, 코드 표기). 다른 저장소라 상대 링크는 이 checkout에서 따라갈 수 없다.
    • 옮긴 날짜와 design-docs 커밋 5f35810
    • 절 번호(0.1, 0.3, 35, 36.x 등)가 정본에서도 같다는 것
    • 옮기기 전 마지막 판을 읽는 명령: git show 003832b6:docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md, git show 752a61f2:docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md
  • docs/README.md의 reviews/ 행을 "가이드와 체크리스트는 design-docs로 옮겼고 여기에는 포인터만 있다"로 고쳤다.
  • 버린 대안: 두 파일 삭제. CLAUDE.md 링크와 지난 리뷰 문서의 가이드 경로가 끊긴다. CLAUDE.md는 소유자 승인 대상이라 이 PR에서 바꾸지 않는다.

위험과 영향

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

검증

desktop(~/workspace/clean-architecture-frontend-template)에서 21dd9dc9를 받아 돌렸다. 로그는 desktop ~/d13-review-guide-pointer-logs/rebased/에 있다.

명령 결과
corepack pnpm verify:documentation exit 0, Documentation readiness: PASS_SCOPED
corepack pnpm test:unit exit 0, 211 files, 3,090 tests passed
  • 실행 뒤 checkout을 fix/maturity-review-2026-11-03으로 되돌렸고 git status가 비어 있다.
  • 바뀐 파일은 3개다(+32 / −2,048). 날짜 폴더(docs/reviews/20*/), CLAUDE.md, AGENTS.md, .claude/는 diff에 없다.
  • merge 게이트 14개는 이 PR만으로 따로 돌리지 않았다. 문서 3개만 바꿨고, 기준인 PR #8 끝(1141969f)의 결과는 PR #8 본문에 있다.

리뷰어가 볼 곳

  • docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md, docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md: 포인터 문안. 정본 경로와 git show 커밋이 맞는지.
  • docs/README.md:90: reviews/ 행.

관련

  • 기준: PR #8(fix/maturity-review-2026-11-06, 1141969f) 위에 쌓았다. merge 순서는 #5 → #7 → #8 → 이 PR이다. 처음에는 main(409d72e7)에서 땄는데 docs/README.md에서 PR #8과 충돌해서 옮겼다.
  • 소유자 결정: 위임 루프 설계 결정 D13(2026-11-06, 공용 리뷰 가이드를 design-docs로 옮긴다).
  • 정본: design-docs 5f35810(옮긴 커밋 ffbd902, ec44d5a).
## 무엇을, 왜 리뷰 가이드(`docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md`)와 실행 체크리스트(`docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md`)를 26줄짜리 포인터로 바꾼다. - 이 두 문서는 백엔드·프론트 두 템플릿이 함께 쓰는 리뷰 기준이다. - 소유자가 2026-11-06에 design-docs로 옮기기로 정했다. 정본은 design-docs main `5f35810`에 들어갔다. - `conventions/template-maturity-review-guide.md` - `conventions/template-maturity-review-execution-checklist.md` - 이 repo에 본문이 그대로 남으면 두 곳에 같은 기준이 생기고, 고칠 때마다 갈라진다. ## 고른 방법과 버린 대안 - 파일 이름과 위치는 그대로 두고 내용만 포인터로 바꿨다. `CLAUDE.md`와 지난 리뷰 문서가 이 경로를 가리키므로 링크가 끊기지 않는다. - 포인터에 적은 것: - 정본 경로(design-docs 저장소 기준, 코드 표기). 다른 저장소라 상대 링크는 이 checkout에서 따라갈 수 없다. - 옮긴 날짜와 design-docs 커밋 `5f35810` - 절 번호(0.1, 0.3, 35, 36.x 등)가 정본에서도 같다는 것 - 옮기기 전 마지막 판을 읽는 명령: `git show 003832b6:docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md`, `git show 752a61f2:docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md` - `docs/README.md`의 `reviews/` 행을 "가이드와 체크리스트는 design-docs로 옮겼고 여기에는 포인터만 있다"로 고쳤다. - 버린 대안: 두 파일 삭제. `CLAUDE.md` 링크와 지난 리뷰 문서의 가이드 경로가 끊긴다. `CLAUDE.md`는 소유자 승인 대상이라 이 PR에서 바꾸지 않는다. ## 위험과 영향 - design-docs를 받지 않은 환경(다운스트림 복사본, CI)에서는 정본을 열 수 없다. 이력이 있는 checkout은 위 `git show` 명령으로 옛 판을 읽는다. - `CLAUDE.md`는 여전히 포인터 파일을 리뷰 기준으로 가리킨다. 링크를 design-docs로 바꿀지는 소유자가 정한다. - `verify:documentation`은 `docs/README.md` 1절에서 링크한 문서만 본다. 포인터 두 파일 안의 경로는 검사하지 않는다. - 코드·설정·게이트는 바꾸지 않았다. ## 검증 desktop(`~/workspace/clean-architecture-frontend-template`)에서 `21dd9dc9`를 받아 돌렸다. 로그는 desktop `~/d13-review-guide-pointer-logs/rebased/`에 있다. | 명령 | 결과 | |---|---| | `corepack pnpm verify:documentation` | exit 0, `Documentation readiness: PASS_SCOPED` | | `corepack pnpm test:unit` | exit 0, 211 files, 3,090 tests passed | - 실행 뒤 checkout을 `fix/maturity-review-2026-11-03`으로 되돌렸고 `git status`가 비어 있다. - 바뀐 파일은 3개다(+32 / −2,048). 날짜 폴더(`docs/reviews/20*/`), `CLAUDE.md`, `AGENTS.md`, `.claude/`는 diff에 없다. - merge 게이트 14개는 이 PR만으로 따로 돌리지 않았다. 문서 3개만 바꿨고, 기준인 PR #8 끝(`1141969f`)의 결과는 PR #8 본문에 있다. ## 리뷰어가 볼 곳 - `docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md`, `docs/reviews/TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md`: 포인터 문안. 정본 경로와 `git show` 커밋이 맞는지. - `docs/README.md:90`: `reviews/` 행. ## 관련 - 기준: PR #8(`fix/maturity-review-2026-11-06`, `1141969f`) 위에 쌓았다. merge 순서는 #5 → #7 → #8 → 이 PR이다. 처음에는 main(`409d72e7`)에서 땄는데 `docs/README.md`에서 PR #8과 충돌해서 옮겼다. - 소유자 결정: 위임 루프 설계 결정 D13(2026-11-06, 공용 리뷰 가이드를 design-docs로 옮긴다). - 정본: design-docs `5f35810`(옮긴 커밋 `ffbd902`, `ec44d5a`).
donghyeon.kang added 1 commit 2026-11-07 09:09:32 +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).
Author
Owner

같은 커밋(21dd9dc9)이 #9로 이미 main에 병합돼(48c7695b) 중복이라 닫는다.

같은 커밋(21dd9dc9)이 #9로 이미 main에 병합돼(48c7695b) 중복이라 닫는다.
donghyeon.kang closed this pull request 2026-11-07 09:10:08 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
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#10