---
name: review
description: Use when reviewing repository changes against AGENTS.md, architecture decisions, tests, and build requirements.
---

# Repository Review

`AGENTS.md`를 먼저 읽고 변경 범위와 직접 관련된 제품 문서, 코드와 테스트만 추가로
읽는다. `context_files`가 있으면 해당 목록을 우선한다. 전체 `docs/`를 일괄 읽도록
요구하지 않는다.

사용자가 범위를 지정하지 않으면 현재 작업 트리의 변경을 리뷰한다. 실제 결함을
심각도순으로 제시하고 각 finding에 파일과 줄 번호, 영향, 근거와 수정 방안을 적는다.

다음을 해당 변경에 적용할 수 있는 범위에서 확인한다.

- public header와 implementation의 의존성 방향 및 관련 ADR
- 새 C/C++ 동작을 먼저 재현하는 테스트와 기존 테스트 회귀
- 실제 `.harness/config.json`, preset 또는 solution에 따른 MSVC build/test
- 새 빌드 경고와 범위 밖 변경
- Harness 변경이면 관련 Python 테스트와 운영 문서의 필드·동작 일치

명시적으로 `validation: docs-only`인 문서 step은 실제 변경이 허용된 문서 경로에만
있을 때 제품 build를 생략할 수 있다. 그 외에는 기존 전체 검증을 사용한다. 실행하지
못한 검사는 성공으로 추정하지 않고 `미검증`과 이유를 기록한다.

finding 뒤에는 아키텍처, 기술 스택, 테스트, 필수 규칙, build 가능 여부를 각각
`통과`, `실패`, `미검증`으로 요약한다. finding이 없으면 발견된 문제가 없다고 쓰고
남은 검증 공백을 밝힌다.