정백경/연대기/MAGI와 AI 코드리뷰 시스템
MAGI 문서는 내부 구현 세부가 아니라 AI 시대의 코드리뷰 품질 harness로 정리합니다.
MAGI AI 코드리뷰는 AI Native 시대에도 팀 고유의 리뷰 기준을 유지하기 위한 harness 시스템이다. AI가 많은 코드를 만들수록, 팀의 컨벤션과 보안, 유지보수 기준을 지능적으로 확인하는 장치가 필요해진다.
왜 필요한가
- AI 시대가 오면서 많은 규칙이 간소화되거나 제거되더라도, 팀 고유의 최소한의 룰은 남아야 한다.
- 사람 리뷰가 제품 판단과 책임 있는 승인에 집중하려면 반복 검토는 AI가 사전에 맡아야 한다.
- 기계적인 체크리스트가 아니라 수정해야 할 지점을 외과수술식으로 제안하는 리뷰가 필요하다.
리뷰 구조
MAGI는 1 Claude + 2 OpenAI 모델 체제로 1 PR 3인 리뷰에 가까운 검토 구조를 지향한다. 내부 트리거와 설정값보다, 여러 모델을 사용해 리뷰 시야를 분산하는 구조가 핵심이다.
검토 기준
- 컨벤션과 유지보수를 위한 최소 룰
- 디자인 시스템 가이드
- BE security
- DB 룰
- 가독성을 해치지 않는 구체적 수정 제안
- PR 코멘트를 다음 AI 수정 프롬프트로 재사용할 수 있는 구조
목표 상태
목표는 “MAGI review 없이는 불안해서 머지하기 무섭다”는 말을 들을 정도의 신뢰를 만드는 것이다. 사람 리뷰를 없애는 것이 아니라, 사람이 더 중요한 제품 판단과 승인에 집중하도록 사전 검증을 담당한다.