리뷰와 증거
에이전트 보조 작업은 증거가 명확할 때만 유용합니다. Lumie는 리뷰어 지적사항, 체커 신호, Verify 단계 증거, 필수 human ownership을 분리해 agent output이 조용히 승인이 되지 않도록 합니다.
review routing의 정본은 .codex/routing/review-matrix.md입니다.
역량 분류
| Capability | Phase | 의미 |
|---|---|---|
human-owner:* | Review | 필수 human owner coverage |
reviewer-agent:* | Review | 전문 리뷰어 증거 |
checker-agent:* | Review | 자문 또는 정책 체커 증거 |
verify-evidence:* | Check | Review coverage가 아닌 검증 증거 |
항상 일치하는 base surface와 overlay row를 모두 합친 뒤 같은 capability token을 중복 제거합니다. reviewer agent, checker agent, hook, Verify-evidence row는 필수 human-owner row를 대체하지 않습니다.
제품 문서 적용 범위
lumie-document/** 변경은 human-owner:document-owner와
reviewer-agent:lumie-doc-reviewer가 필요합니다.
diff가 다음 surface를 바꾸면 coverage를 추가합니다.
| 변경 | 추가 |
|---|---|
sidebar root, _category_.json, page placement, locale structure | reviewer-agent:lumie-doc-structure-reviewer |
| 한국어 현지화 적용 범위 | reviewer-agent:lumie-doc-i18n-reviewer |
따라서 Docusaurus 탭 분리는 영문 문서 리뷰, 구조 리뷰, 한국어 i18n 리뷰가 필요합니다. 그래도 커밋 준비가 완료된 것으로 간주되려면 document-owner coverage가 필요합니다.
리뷰어 출력 읽기
리뷰어 출력은 증거로 다뤄야 합니다.
- 심각도순 지적사항은 구체적인 위험이나 결함을 식별합니다.
No findings는 리뷰어가 할당된 범위 안에서 문제를 찾지 못했다는 뜻입니다.- 어떤 리뷰어 결과도 커밋을 승인하지 않습니다.
- 후속 편집이 검토된 범위를 무효화하면 오래된 리뷰어 증거는 새로고침해야 합니다.
- 모순되는 리뷰어 증거는 Report 또는 commit 전에 해결해야 합니다.
No findings는 가치 있지만 전체 시스템이 옳다는 증명은 아닙니다. 하나의 리뷰어
역할이 낸 범위 지정 신호입니다.
커밋 준비
커밋 준비는 .codex/routing/commit-policy.md가 소유합니다. 종료 게이트는
staged scope에 맞는 증거를 기대합니다.
git diff --cached --name-only의 정확한 staged file;- 대상 저장소에 대한 통과한 commit-readiness checker 출력;
- 일치하는 work-log 증거;
- 필수
human-owner:*row를 포함한 staged scope의 Review 증거; - staged scope에 대한 Verify 증거 또는 selector-defined
no_run증거; - staged scope가 공개 문서, 개발자 문서, 라우팅 문서, 워크플로 정책, 문서 구조에 영향을 줄 때 Docs Sync 증거;
.codex/routing/commit-conventions.md를 만족하는 commit 메시지.
커밋 준비는 reviewer routing을 다시 만들거나, 넓은 검증을 다시 실행하거나, Docs Sync를 처음부터 실행하지 않습니다. 증거는 이미 존재해야 하고 staged scope와 일치해야 합니다.
검증
review routing은 이 소스 파일로 검증합니다.
sed -n '1,150p' .codex/routing/review-matrix.md
sed -n '1,120p' .codex/routing/repos/document.md
sed -n '1,120p' .codex/routing/commit-policy.md
예상 성공 신호: matrix는 역량 분류와 제품 문서 row를 보여주고, document route는 문서 전문 역할 라우팅을 보여주며, commit policy는 staged scope 증거 계약을 보여줍니다.