리뷰 가이드 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절에서 링크한 문서만 보므로, 포인터 두 파일 안의 경로는 검사하지 않는다.
기준은 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`
문제
리뷰 가이드와 실행 체크리스트는 백엔드·프론트 두 템플릿이 함께 쓰는
리뷰 기준인데 프론트 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).
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
리뷰 가이드
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/행을 그에 맞춘다.고른 방법과 버린 대안
conventions/...) 코드 표기로 적는다. 다른 저장소라 상대 링크로는 이 checkout에서 따라갈 수 없기 때문이다.git show명령(가이드003832b6, 체크리스트752a61f2)도 포인터에 적는다.CLAUDE.md와 지난 리뷰 문서가 이 경로를 가리키므로 링크가 끊기지 않는다.CLAUDE.md링크와 지난 리뷰 문서의 가이드 경로가 끊긴다.위험과 영향
git show명령으로 옛 판을 읽는다.CLAUDE.md는 여전히 포인터 파일을 리뷰 기준으로 가리킨다. 링크를 design-docs로 바꿀지는 소유자가 정한다. 이 PR에서는 바꾸지 않는다.verify:documentation은docs/README.md1절에서 링크한 문서만 보므로, 포인터 두 파일 안의 경로는 검사하지 않는다.검증
corepack pnpm verify:documentation,corepack pnpm test:unit통과. 로그는 desktop~/d13-review-guide-pointer-logs/에 있다.fix/maturity-review-2026-11-06(1141969f)이었다. 지금 main(d359dde6)의 트리는 그 커밋과 같아서 이 결과가 그대로 유효하다.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/행관련
5f35810