Claude Code와 Codex를 병렬로 가동했더니 충돌 파티가 열려서 AI 전용 락 파일(Lock file)을 만들었다

서론

최근 개인 개발에서 Claude Code나 Codex를 활용하며 개발하고 있습니다.

처음에는 단순하게 생각했습니다.

• Claude Code로 UI 개발
• Codex로 게임 로직 개발
• 별도의 Claude Code로 리팩터링 (Refactoring)

각각 별도의 브랜치(Branch)나 별도의 워크트리(Worktree)에서 작업하게 하면, 개발 속도가 2배, 3배가 될 것이라고 말이죠.

하지만 실제로 운용해 보니 예상치 못한 문제가 발생했습니다.

발생한 문제

AI끼리는 당연하게도 서로 무엇을 하고 있는지 모릅니다.

예를 들어,

Codex

src/game/bomb/Bomb.ts

를 수정하고 있습니다.

Claude Code

src/game/explosion/Explosion.ts

를 수정하고 있습니다.

처음에는 문제가 없습니다.

하지만 개발이 진행됨에 따라,

Bomb.ts
Explosion.ts
collision.ts

와 같은 관련 파일들을 여러 AI가 건드리기 시작합니다.

결과적으로,

• 동일한 파일을 수정함
• 동일한 함수를 서로 다른 방침으로 변경함
• 설계 사상이 어긋남
• 머지 충돌 (Merge Conflict)이 증가함

이라는 문제가 발생했습니다.

worktree만으로는 해결되지 않았다

처음에는 Git Worktree를 사용했습니다.

git worktree add ../game-ui ai/ui
git worktree add ../game-logic ai/logic

확실히 작업 환경은 분리할 수 있습니다.

하지만,

"누가 어떤 파일을 건드리고 있는가"

까지는 관리할 수 없습니다.

이는 인간 팀에서도 마찬가지입니다.

별도의 브랜치에서 작업하더라도, 같은 파일을 편집하면 충돌이 발생합니다.

그래서 생각한 메커니즘

해결책으로서,

AI 전용 락 파일 (Lock file)

을 만들기로 했습니다.

예를 들어,

~/ai-dev-locks/my-game/AI_LOCKS.md

라는 파일을 준비합니다.

내용은 간단합니다.

# 현재 작업 중
## Codex
상태: 작업 중
...

AI에 대한 지시

각 AI에게는 작업 시작 전에 반드시 다음 지시를 내립니다.

작업 전에 AI_LOCKS.md를 확인해 주세요.
변경 예정 파일이 락(Lock)되어 있는 경우
작업을 시작하지 말고 중단해 주세요.
...

그러면,

Bomb.ts가 현재 락되어 있습니다.
작업을 중단합니다.

와 같은 동작이 됩니다.

왜 리포지토리 외부에 두는가

당초에는 프로젝트 직하에 두려고 생각했습니다.

project/
├── src/
├── package.json
...

하지만 이렇게 하면,

• Git 관리 대상이 됨
• 불필요한 커밋이 늘어남
• 컨플릭트 (Conflict)의 원인이 됨

이라는 문제가 있습니다.

따라서 현재는,

~/ai-dev-locks/

와 같이 Git 관리 외의 장소에 배치하는 것이 좋다고 생각하고 있습니다.

향후 하고 싶은 일

이상적으로는 Markdown이 아니라,

{
"owner": "Codex",
"files": [
...

와 같은 형식으로 관리하여,

AI가 자동으로 취득 및 업데이트할 수 있도록 하고 싶습니다.

또한 장래에는,

• Claude Code
• Codex
• Gemini CLI
• Cursor Agent

등 여러 AI 에이전트가 동시에 작업하는 케이스가 늘어날 것입니다.

그렇게 되면,

"어떤 AI가 가장 똑똑한가"

보다,

"여러 AI를 어떻게 관리할 것인가"

가 더 중요해질지도 모릅니다.

요약

AI를 병렬 가동할 때 느낀 점은,

AI의 성능보다 태스크 관리 (Task Management)가 더 중요했다

는 것입니다.

저는 현재,

• worktree로 작업 환경을 분리
• AI_LOCKS.md로 편집 대상을 관리

라는 운용을 시도하고 있습니다.

만약 똑같이 여러 AI 에이전트를 병렬 운용하고 계신 분이 있다면, 더 좋은 방법이 있다면 꼭 알려주세요.

Discussion