[#52] branch 비교와 AI 코드 처리 정책을 README에 문서화한다

[opficdev]

🔗 연관된 이슈

• closed branch 비교와 AI 코드 처리 정책을 README에 문서화한다 #52

🎯 의도

• consumer가 설치 전에 branch 검사 범위, OpenAI API 코드 전송 범위, repository 변경 여부, report 확인 경로를 이해할 수 있도록 README 정리

📝 작업 내용

📌 요약

• branch 선택·조합 분석 정책과 최대 비교 범위 문서화
• OpenAI API 전송 데이터와 AI 제안의 비자동 적용 경계 명시
• GitHub Actions summary, stdout fallback, Discord 분할 전송, report 예시와 troubleshooting 정리

🔍 상세

• 최신 commit의 committer date가 14일 이내인 branch를 최대 30개 선택하고 초과 branch를 stale_branch, branch_limit으로 제외하는 고정 정책 명시
• 14일·30개 정책을 조정하는 workflow input을 추가하지 않는 범위 명시
• base_branch와 활성 branch를 포함한 최대 465개 조합 및 confirmed_conflict, potential_overlap, error 구분 설명
• git merge-tree --stdin --name-only --messages 기반 가상 병합과 checkout, worktree 수정, merge commit, push, PR 수정이 없는 읽기 전용 경계 명시
• OpenAI API로 전달되는 조합 metadata와 merge base, left branch, right branch, virtual merge 결과 코드 원문 및 400줄·128 KiB 제한 설명
• AI 분석과 Suggested Patch가 report 제안으로만 제공되고 자동 적용되지 않는 동작 명시
• GITHUB_STEP_SUMMARY 기록과 stdout fallback, Discord 2,000자 분할 전송 방식 설명
• formatter 구조에 맞춘 report 예시와 branch 선택, 조합 수, merge-tree, AI 상태, report 전달 관련 troubleshooting 추가

📸 영상 / 이미지 (Optional)

[gemini-code-assist]

Code Review

이번 풀 리퀘스트는 README.md 파일을 업데이트하여 Watcher의 브랜치 선택 기준, 가상 병합 분석 방식, OpenAI API 데이터 전송 규격 및 제한, 그리고 GitHub Actions Summary 및 Discord 전송 정책에 대한 상세한 설명을 추가하고 트러블슈팅 가이드를 보강했습니다. 리뷰어는 트러블슈팅 가이드의 비교 조합 수 계산 공식에서 변수 n을 명확히 정의하여 독자가 수식을 더 쉽게 이해할 수 있도록 개선할 것을 제안했습니다.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.