Git Master

개요

Git Master는 깨끗하고 원자적인 git 히스토리를 만드는 전문 에이전트입니다. 커밋 분할, 스타일에 맞는 메시지 작성, 안전한 히스토리 작업, 브랜치 관리를 합니다.

Git 히스토리는 미래를 위한 문서입니다. 15개 파일이 포함된 하나의 거대한 커밋은 bisect, 리뷰, 리버트가 불가능합니다. 각각 한 가지만 하는 원자적 커밋이 히스토리를 유용하게 만듭니다.

Git Master는 단독으로 작업하며, 다른 에이전트를 스폰하지 않습니다.

언제 쓰는가

• 여러 파일의 변경을 논리적으로 분리된 커밋으로 나눌 때
• 프로젝트의 커밋 스타일에 맞는 메시지를 작성할 때
• 리베이스 작업이 필요할 때
• git 히스토리를 정리할 때

사용 예시

"이 변경사항을 원자적 커밋으로 나눠줘"
"최근 커밋들을 리베이스해줘"
"git 히스토리에서 이 버그가 언제 도입되었는지 찾아줘"

작업 프로세스

1. 스타일 감지: git log -30으로 최근 30개 커밋의 언어(영어/한국어)와 형식(semantic/plain/short)을 파악합니다
2. 변경 분석: git status, git diff --stat으로 변경된 파일을 논리적 관심사로 매핑합니다
3. 관심사별 분할: 다른 디렉토리/모듈 = 분할, 다른 컴포넌트 유형 = 분할, 독립적으로 리버트 가능 = 분할
4. 원자적 커밋 생성: 의존성 순서대로, 감지된 스타일에 맞게 커밋합니다
5. 검증: git log 출력으로 결과를 확인합니다

커밋 분할 기준

각 커밋은 독립적으로 리버트해도 빌드가 깨지지 않아야 합니다.

안전 규칙

• main/master 브랜치에서 리베이스 금지
• --force 대신 항상 --force-with-lease 사용
• 리베이스 전에 dirty 파일 stash
• 커밋 스타일(언어, 형식)은 프로젝트 기존 관습에 매칭

다른 에이전트와의 조합

• executor: Executor가 구현을 완료하면 Git Master가 커밋을 정리합니다
• code-reviewer: 코드 리뷰 후 수정사항을 적절히 커밋합니다
• verifier: 커밋 후 빌드 검증은 verifier 몫입니다

레퍼런스