Files
clean-architecture-frontend…/CLAUDE.md
DongHyeonkaandClaude Opus 5.5 412b3d1f1e docs: add the maturity review guide and the 2026-09-25 full review
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>
2026-09-25 21:05:08 +09:00

2.6 KiB

CLAUDE.md

리뷰 기준 (모든 리뷰에 적용)

이 repo를 리뷰할 때는 전체 리뷰든 모듈·PR·diff 리뷰든 docs/reviews/TEMPLATE-MATURITY-REVIEW-GUIDE.md를 기준으로 한다.

  • 발견 사항은 가이드의 28개 관점 번호로 분류한다. 결함 하나는 항목 하나로 적고 관련 관점 번호를 모두 붙인다(0.3절). 같은 결함을 여러 번 세지 않는다.
  • 성격(확인된 결함 / 구조적 위험 / 미검증 / 개선 제안), 심각도(CriticalLow), 우선순위(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은 없다.

전체 리뷰 절차

  1. 기준 커밋과 가이드 0.1절 전제 표를 먼저 고정한다.
  2. 게이트를 직접 실행하고 결과를 기록한다: check:architecture, check:types, lint, test:unit, test:component, test:integration, test:contract, test:runtime-schema, verify:documentation, check:adapter-inventory, check:ci.
  3. 영역별로 서브에이전트를 병렬로 띄운다. 영역 분할은 가장 최근 docs/reviews/*-maturity-review/README.md의 영역 표를 재사용한다.
  4. 각 에이전트는 docs/reviews/<YYYY-MM-DD>-maturity-review/NN-<영역>.md에 결과를 쓴다.
  5. 오케스트레이터는 High 이상 발견을 코드에서 직접 재확인한 뒤 같은 폴더의 README.md에 범위(36.1), 28개 관점 판정표(36.2), 최종 요약(36.5), 발견 색인을 쓴다.