Observer

Observer는 리뷰어가 머릿속에 들고 있어야 할 맥락에 변경을 근거시키는 도구입니다. 플랫폼 인식 PR 분석기 + API 계약 검증기로, 반복되는 세 가지 리뷰 질문을 결정론적 검사로 바꿉니다:

1. 이 PR 범위가 적절한가? 같은 7개 파일이 Spring Boot에서는 하나의 응집된 변경이고 Next.js에서는 분리해야 할 세 관심사일 수 있습니다. 파일 수로 판단하면 오판하므로, Observer는 플랫폼 프로파일 대비 논리적 응집도로 판단합니다.
2. API 변경이 하위 호환인가? nullable 누락, 에러 응답 불일치, breaking change가 리뷰에서 빠집니다. Observer는 스펙을 린트하고 base와 diff합니다.
3. 이 변경이 규정에 맞는가? 가이드라인이 있어도 리뷰어가 매번 기억해 대조하기 어렵습니다. Observer는 PR 타입을 추론해 맞는 체크리스트를 생성하고, Nexus가 연결돼 있으면 관련 규정과 영향까지 붙입니다.

관통하는 원칙 하나: 정상일 때는 아무 말도 하지 않는다. 노이즈는 신뢰를 죽입니다. 경고할 때는 어떻게 분할할지까지 제안합니다.

한마디로: 범위·계약·규정 준수를 근거시켜 PR 리뷰를 정직하게 유지합니다. Nexus가 연결되면 더 풍부해지지만, 없어도 완전히 동작합니다.

핵심 개념

• 플랫폼 프로파일 — 프레임워크별(Spring Boot, Next.js, React SPA) 파일 패턴 → 역할 매핑. 역할이 모여 응집 그룹을 이룹니다.
• 범위 분석 — 변경 파일에 역할을 부여하고 응집 그룹에 매칭, severity를 매겨 관심사가 섞였으면 머지 순서까지 담은 분할을 제안합니다.
• 관심사 드리프트 — 편집 중 현재 변경과 다른 관심사의 파일이 들어오면 즉시 경고합니다.
• API 린트 + diff — 10개 내장 룰(observer/nullable, observer/error-response 등)로 스펙을 검사하고, base 대비 breaking change를 감지합니다.
• PR 타입 → 체크리스트 — 10개 PR 타입이 각각 리뷰 체크리스트로 매핑됩니다.
• Nexus는 선택적 — 없어도 모든 기능이 동작하고, 있으면 규정·영향·설계-관측 갭이 더해집니다.

설치(npm 미게시 — 저장소에서 pnpm install && pnpm build), 명령어(observer check 등), MCP 등록은 영어 페이지(Observer)를 참고하세요.