CLAUDE.md makes the guide the standing review standard for this repo. The review folder holds 14 area reports and the summary with the 28-perspective table and the finding index. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2.6 KiB
2.6 KiB
CLAUDE.md
리뷰 기준 (모든 리뷰에 적용)
이 repo를 리뷰할 때는 전체 리뷰든 모듈·PR·diff 리뷰든 docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md를 기준으로 한다.
- 발견 사항은 가이드의 28개 관점 번호로 분류한다. 결함 하나는 항목 하나로 적고 관련 관점 번호를 모두 붙인다(0.3절). 같은 결함을 여러 번 세지 않는다.
- 성격(확인된 결함 / 구조적 위험 / 미검증 / 개선 제안), 심각도(Critical
Low), 우선순위(P0P3), 통제 수준(M0M4), 증거(E0E4)를 따로 적는다(35절). 확인하지 못한 것은 M0가 아니라미확인이다. - 발견 사항은 36.3절 양식, 최종 요약은 36.5절 양식, 관점별 판정은 36.2절 표를 쓴다.
- README와 설계 문서는 주장이다. 근거는 현재 커밋의 코드·설정·실행 결과에서 찾는다(34.1절). 이전 리뷰의 실행 결과를 현재 증거로 재사용하지 않는다.
- 리뷰에서는 코드를 고치지 않는다. 고치는 작업은 리뷰 문서를 근거로 별도로 진행한다.
이 repo의 리뷰 전제
- 이 repo는 템플릿(reference implementation)이다. repo 안에 소비자가 없는 코드와 빈 레지스트리는 다운스트림용 확장 지점이지 죽은 코드가 아니다. 다만 갈라진 중복 복사본은 문제로 본다.
- adapter 배럴(
src/adapters/*/index.ts)이 공개 경계다. - adapter끼리 import할 수 있는 예외는
.dependency-cruiser.json의 kernel 예외(src/adapters/platform/폴더 전체,browser-file-storage/result.ts,cross-context-invalidation/index.ts)뿐이다. 새 파일 단위 예외를 제안하지 않는다. - 실행 형태는 브라우저 SPA + 정적 호스팅 + Service Worker다. SSR은 없다.
전체 리뷰 절차
- 기준 커밋과 가이드 0.1절 전제 표를 먼저 고정한다.
- 게이트를 직접 실행하고 결과를 기록한다:
check:architecture,check:types,lint,test:unit,test:component,test:integration,test:contract,test:runtime-schema,verify:documentation,check:adapter-inventory,check:ci. - 영역별로 서브에이전트를 병렬로 띄운다. 영역 분할은 가장 최근
docs/reviews/*-maturity-review/README.md의 영역 표를 재사용한다. - 각 에이전트는
docs/reviews/<YYYY-MM-DD>-maturity-review/NN-<영역>.md에 결과를 쓴다. - 오케스트레이터는 High 이상 발견을 코드에서 직접 재확인한 뒤 같은 폴더의
README.md에 범위(36.1), 28개 관점 판정표(36.2), 최종 요약(36.5), 발견 색인을 쓴다.