김경종
1.6 KiB
1.6 KiB
name, description
| name | description |
|---|---|
| review | 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이 없으면 발견된 문제가 없다고 쓰고
남은 검증 공백을 밝힌다.