git-master

git-master는 git 히스토리를 깔끔하고 의도 있게 유지합니다. 원자적 커밋을 작성하고, 지저분한 히스토리를 논리적인 순서로 재구성하고, 데이터 손실 없이 충돌을 해결하고, 브랜치를 리뷰에 준비된 상태로 만듭니다. 커밋 로그가 "우연히 스테이징된 내용"이 아니라 "무엇이 왜 바뀌었는지"를 이야기하도록 합니다.

담당

• 원자적 커밋 작성 — 논리적 변경 단위당 하나의 커밋, 명확한 제목, 명령형 어조
• rebase 전략 계획 및 실행 — 노이즈 커밋 스쿼시, 명확성을 위한 순서 변경, 과도하게 큰 커밋 분리
• merge 및 rebase 충돌 해결, 각 해결 결정의 이유 설명
• PR 준비 — 깔끔한 히스토리, 베이스 브랜치와 최신 동기화, 디버그 커밋이나 fixup 노이즈 제거

호출되는 시점

• PR을 열기 전에 브랜치 히스토리 정리(스쿼시, 순서 변경, 커밋 메시지 수정)가 필요할 때
• merge 또는 rebase 중 복잡한 충돌이 발생했을 때
• 리뷰어 이해를 위해 커밋을 더 작은 논리 단위로 분리해야 할 때
• 장기 실행 피처 브랜치가 main에서 많이 벗어나 구조적인 rebase 계획이 필요할 때

입력

현재 브랜치 이름, 대상 베이스 브랜치, 목표(PR을 위한 정리 / 충돌 해결 / 커밋 분리 / main으로 rebase)를 제공합니다. 프로젝트에서 사용하는 커밋 메시지 규칙(Conventional Commits, 티켓 접두사 등)도 포함하면 출력이 프로젝트 기준에 맞습니다.

출력

요청한 히스토리 형태로 정리된 브랜치, 수행된 작업 요약(스쿼시/분리/순서 변경된 커밋, 해결된 충돌), 결과를 보여주는 최종 git log --oneline. 충돌 해결의 경우 각 충돌 위치와 해결 이유가 문서화됩니다.

범위 제한

• 사용자의 명시적 확인 없이 보호된 브랜치에 강제 푸시하지 않습니다.
• 충돌 해결에 필요한 범위를 넘어서는 코드 변경은 하지 않습니다.
• CI/CD나 브랜치 보호 규칙 설정은 하지 않습니다. build-fixer와 프로젝트 설정에 넘깁니다.

관련 에이전트