naw103/foremerge

해결하는 문제

Foremerge는 여러 AI 코딩 에이전트가 동시에 같은 프로젝트에서 작업할 때 발생하는 "의도 충돌"을 해결합니다. Git은 두 에이전트가 같은 코드 줄을 편집했는지는 감지할 수 있지만, 서로 다른 파일에 있는 두 개의 논리적으로 타당한 변경이 서로 모순되는 경우(예: 한 에이전트가 다른 에이전트가 확장 중인 서비스를 교체하는 경우)는 감지할 수 없습니다. Foremerge는 에이전트가 코드를 작성하기 전에 계획을 조정할 수 있게 하여 낭비되는 노력과 깨진 통합을 방지합니다.

작동 방식

Foremerge는 Git 위에 구축된 조정 프로토콜로 작동합니다. 프로젝트의 .git 폴더 안에 저장된 공유 SQLite 데이터베이스를 사용하여, 별도의 Git 워크트리에서 작동하는 에이전트들이 "시맨틱 화이트보드"를 공유할 수 있게 합니다.

1. 의도 게시: 코딩 전에 에이전트는 대상(예: "sendEmail 함수를 변경 중입니다")과 작업(예: replace 또는 extend)을 선언합니다.
2. 충돌 감지: Foremerge는 이러한 선언을 다른 에이전트의 계획과 비교합니다. 두 에이전트가 충돌하는 작업으로 같은 심볼을 대상으로 하면 권고 경고를 발생시킵니다.
3. 검증 게이트: 작업이 완료되면 Foremerge는 작업을 승인됨으로 표시하기 전에 특정 코드 지문에 대해 검증 검사(예: 테스트 스위트)를 실행하도록 요구합니다.
4. 비차단: 파일을 잠그거나 에이전트를 차단하지 않습니다. 권고 경고와 증거를 제공하여 사람이나 에이전트가 어떻게 진행할지 결정할 수 있게 합니다.

대상 사용자

단일 코드베이스에서 여러 AI 코딩 에이전트(예: Claude Code, Codex, Cursor)를 병렬로 사용하며 논리적 충돌을 방지하고 에이전트 결정의 감사 추적을 필요로 하는 개발자.

하이라이트

• 시맨틱 인식: 단순한 텍스트 줄뿐 아니라 심볼과 의도를 기반으로 충돌을 감지합니다.
• 로컬 우선: .git 디렉터리의 로컬 SQLite 저장소를 사용하여 로컬 워크트리 간 제로 구성 공유를 제공합니다.
• MCP 통합: Model Context Protocol (MCP) 서버를 제공하여 AI 에이전트가 기본적으로 등록하고, 의도를 게시하고, 충돌을 조회할 수 있게 합니다.
• 검증 게이트 적용: ChangeSet이 에이전트가 보고한 상태에 의존하지 않고 실제 명령 실행(예: cargo test)으로 검증되도록 보장합니다.