문제 리뷰 가이드와 실행 체크리스트는 백엔드·프론트 두 템플릿이 함께 쓰는 리뷰 기준인데 프론트 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).
1.6 KiB
1.6 KiB
Template 프로젝트 성숙도 리뷰 가이드 — 옮긴 곳
이 가이드는 2026-11-06에 design-docs 저장소로 옮겼다. 이 파일에는 본문이 없고 정본 위치만 적는다.
- 정본: design-docs 저장소의
conventions/template-maturity-review-guide.md - 정본이 들어간 design-docs main 커밋:
5f35810(옮긴 커밋은ffbd902) - 옮긴 이유: 백엔드·프론트 두 템플릿이 함께 쓰는 리뷰 기준이다. 소유자가 2026-11-06에 design-docs로 옮기기로 정했다(design-docs
delegation-loop/02-design.md결정 D13). - 짝 문서인 실행 체크리스트도 같이 옮겼다:
TEMPLATE-MATURITY-REVIEW-EXECUTION-CHECKLIST.md
절 번호
정본의 절 번호는 이 파일에 있던 판과 같다. 0.1·0.3, 28개 관점(128절), 35절, 36.136.5절 모두 같은 번호로 찾으면 된다. CLAUDE.md와 지난 리뷰 문서가 적은 절 번호도 정본에서 그대로 통한다.
정본에서 달라진 것은 맨 위 "옮긴 기록" 인용 블록과, 실행 체크리스트를 가리키는 두 곳(「먼저 읽을 부분」, 36절 끝)의 링크뿐이다.
옮기기 전 판
옮기기 전 마지막 판은 이 repo 이력에 있다. 이 파일을 마지막으로 바꾼 커밋은 003832b6이다.
git show 003832b6:docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md
고칠 때
리뷰 기준을 고칠 일이 생기면 design-docs의 정본을 고친다. 이 파일에 본문을 다시 넣지 않는다. 두 곳에 본문이 있으면 서로 갈라진다.