CI가 PR별 AI 코드 리뷰 결과를 PR-<번호>.md 한 파일에 누적합니다.
- 이 폴더는 규칙의 정본이 아니라 리뷰 실행 기록입니다.
- 에이전트는 전체 폴더를 컨텍스트로 넣지 않고, 현재 변경과 관련된 PR 문서만 선택해서 읽습니다.
- 각 문서는 현재 차단·제안, 이전 실행 대비 새 지적·지속 지적·재검출되지 않은 지적, 검토 이력을 구분합니다.
재검출되지 않음은 파일·줄·분류 기반의 자동 추정입니다. 최종 반영 여부는 사람이 코드와 함께 확인합니다.- 문서 안의 숨은 상태 블록과 서명은 다음 CI 실행의 비교용이므로 수동으로 편집하지 않습니다. 수정되거나 서명이 맞지 않으면 이전 상태를 신뢰하지 않습니다.
저장소에 문서를 자동 반영하려면 전용 봇 계정의 fine-grained PAT를 AI_REVIEW_PUSH_TOKEN Repository secret으로 등록합니다. 토큰 범위는 WhyLog 저장소 하나와 Contents: Read and write로 제한합니다. 기본 GITHUB_TOKEN은 자신이 푸시한 커밋으로 새 CI 실행을 만들지 않으므로 문서 동기화에 사용하지 않습니다.
전용 쓰기 토큰이 없거나 보호 브랜치가 PR의 head인 경우 CI는 같은 경로의 Markdown을 Actions artifact로만 생성합니다. 인라인 리뷰와 요약 코멘트는 기존 GITHUB_TOKEN으로 계속 게시됩니다.
문서 자동 커밋으로 한 번 더 실행된 CI는 서명, 직전 부모 SHA, 리뷰 입력 digest가 모두 일치할 때만 이전 판단을 그대로 재사용합니다. 이 실행은 문서를 다시 커밋하지 않아 반복 실행되지 않습니다.