tomevault-io 리뷰
개요
저장소 변경사항을 프로젝트 문서의 규칙에 맞춰 검토하고, 구체적인 수정 방향이 포함된 간결한 체크리스트 보고서를 작성할 때 이 워크플로우를 사용한다.
워크플로우
맥락 읽기
먼저 아래 파일을 읽는다:
/AGENTS.md/docs/ARCHITECTURE.md/docs/ADR.md/docs/COMMANDS.md
docs/adr/ 디렉터리가 있으면 분리된 ADR도 함께 읽는다. 변경 diff가 다른 문서에서 설명하는 영역을 건드릴 때만 추가 문서를 읽는다.
변경사항 확인
변경된 파일과 관련 주변 코드를 확인한다. git status --short, git diff --stat, git diff, 대상이 분명한 rg 검색을 우선 사용한다.
체크리스트 검증
다음을 확인한다:
- 아키텍처 준수: 변경사항이
ARCHITECTURE.md의 디렉터리와 모듈 구조를 따르는가? - 기술 선택: 변경사항이 ADR 결정을 위반하지 않는가?
- 테스트 커버리지: 새로운 동작에 적절한 테스트가 있거나, 테스트가 필요 없는 명확한 이유가 있는가?
- 핵심 규칙: 변경사항이
AGENTS.md의 CRITICAL 규칙을 위반하지 않는가? - 빌드 준비 상태:
docs/COMMANDS.md의 빌드, 린트, 테스트 명령을 로컬에서 실행할 수 있을 때 통과하는가?
출력
아래 표를 반환한다:
| 항목 | 결과 | 비고 |
|---|---|---|
| 아키텍처 준수 | 통과/실패 | {상세} |
| 기술 스택 준수 | 통과/실패 | {상세} |
| 테스트 존재 | 통과/실패 | {상세} |
| CRITICAL 규칙 | 통과/실패 | {상세} |
| 빌드 가능 | 통과/실패 | {상세} |
어떤 항목이라도 실패하면 파일 경로, 구체적인 문제, 수정 방안을 포함한다. 의존성이 없어서 검사를 실행하지 못한 경우에는 빌드 행에 그 사실을 명확히 적는다.
리뷰 관점
스타일 의견보다 버그, 회귀, 누락된 테스트, 규칙 위반을 우선한다. 응답은 간결하고 실행 가능하게 유지한다.
Source: vanilalatte03/codex-project-ops-template — distributed by TomeVault.