Santa Augmentcode Intent Ep.4

Context

여러 AI 에이전트가 동시에 같은 파일을 수정할 때 병합 충돌이 불가피하게 발생한다. Git은 인간 속도의 순차 작업을 가정해 설계되었으나, AI 에이전트는 수분 내 수십 개 파일을 수정할 수 있어 기존 브랜칭 전략으로는 충돌 관리가 불가능하다.

Technical Solution

• Git Worktree를 사용해 각 에이전트에 격리된 작업 디렉토리 자동 생성: Coordinator가 Specialist 에이전트 생성 시 독립적 worktree 할당
• 공유 .git 객체 저장소 유지로 데이터 중복 제거: 각 worktree는 자체 working tree와 index 보유하며 repository 객체 저장소만 공유
• Auto-commit으로 진행 상황 자동 저장: 에이전트가 작업 단위 완료 시 해당 branch에 자동 커밋하여 영구 상태 보존
• Temporal isolation으로 세션 중단 후 정확한 상태 복원: 애플리케이션 종료 후 재개 시 spec, worktree, 커밋, 에이전트 상태 모두 동일하게 유지
• Spec 기반 머지 충돌 해결: Coordinator가 구현 완료 후 검증 완료 시점에 병합 수행하며, 인터페이스 계약 위반 사항을 파일 수준이 아닌 spec 수준에서 해결

Impact

정량적 수치 없음.

Key Takeaway

병렬 멀티 에이전트 시스템에서는 파일 수준 동시성 제어보다 Git Worktree를 통한 완전한 작업 공간 격리가 필수이며, auto-commit과 git history 기반 상태 관리로 시스템 중단 후에도 정확한 재개가 가능해진다.