하나의 저장소 위 여러 AI 에이전트
쓰기가 조정된다면 여러 에이전트가 저장소를 공유할 수 있습니다. 에이전트가 건드릴 경로를 알리면 서버가 그것을 부여하고, 놓아줄 때까지 다른 모든 에이전트에게 거부합니다. 이 조정이 없으면 두 번째 에이전트는 아무 알림 없이 첫 번째의 작업을 지워버립니다.
모든 것을 망가뜨리는 경우
두 에이전트가 같은 파일을 건드리는 두 작업을 받습니다. 첫 번째가 파일을 읽고, 20초 동안 생각한 뒤 씁니다. 두 번째는 첫 번째가 쓰기 전의 같은 버전을 읽었고, 그 위에 덮어씁니다. 아무것도 멈추지 않았고, 아무 경고도 없었고, 첫 번째의 작업은 사라졌습니다.
에이전트가 하나 이상이 되는 순간부터 이 경우는 드물지 않습니다. 에이전트는 넓게 읽고 빠르게 쓰기 때문입니다. 거의 모든 도구가 격리를 택하는 이유가 여기 있습니다. 에이전트마다 머신 하나, 브랜치 하나.
다른 곳에서 하는 방식: 에이전트마다 worktree
이 문제에 대한 흔한 답은 분할입니다. 각 에이전트에게 자체 git worktree, 자체 인덱스를 가진 파일 전체 복사본을 주고, 영역이 겹치지 않도록 조정합니다. Windsurf, Conductor, OpenHands가 하는 방식이고, 대부분의 가이드가 권장하는 방식입니다.
작동하고, 결함이 정확히 하나 있습니다. 분할은 보장이 아니라 약속입니다. 아무도 영역이 겹치지 않는지 확인하지 않고, 겹칠 때는 병합 시점, 즉 두 에이전트가 모두 끝나고 아무도 이유를 기억하지 못할 때 알게 됩니다.
세 단계로 본 점유
쓰기 전에 에이전트는 건드릴 경로를 알립니다. 보드는 비어 있으면 부여하고, 점유되어 있으면 거부합니다. 어느 순간이든 파일 하나에 소유자는 한 명뿐입니다.
작업하는 동안 감시자는 디스크의 실제 쓰기를 지켜보며 각각을 작성자에게 연결합니다. 다른 사람이 점유한 경로에 쓰기가 발생하면 반영되기 전에 스냅샷됩니다. 이전 버전이 보존되므로 규칙을 우회하더라도 아무것도 잃지 않습니다.
끝나면 에이전트는 경로를 놓아줍니다. 파일은 다음 에이전트를 위해 다시 사용 가능해지며, 병합이 필요 없습니다. 살아 있는 버전이 동시에 둘이었던 적이 없기 때문입니다.
화면에 보이는 것
각 창은 자신의 에이전트가 작업하는 모습을 보여주고, 보드는 누가 무엇을 쥐고 있는지 보여줍니다. 어떤 에이전트가 기다리고 있는지, 왜 기다리는지 보입니다. 막힌 에이전트는 피해를 내기 전에 보이며, 이것이 보이지 않는 대기열과의 진짜 차이입니다.
사람도 셈에 들어갑니다. 같은 캔버스의 여러 사람이 각자 자신의 에이전트를 조작하고, 이름이 붙은 다른 사람들의 커서를 봅니다.
이 형태가 맞지 않을 때
작업이 정말로 독립적이고 오래 걸린다면 머신 단위 격리로도 충분합니다. 조정할 것도 기다릴 것도 없습니다. 공유는 작업들이 서로 맞닿을 때 이깁니다. 같은 기능을 함께 작업하는 순간 바로 그런 경우입니다. 비교 페이지가 도구별로 이 선택을 자세히 다룹니다.
직접적인 답변
여러 에이전트를 실행하려면 git worktree를 써야 하나요?
대부분의 가이드가 주는 답이고 실제로 작동합니다. 에이전트마다 worktree 하나, 각자 자체 인덱스와 파일을 가지므로 충돌 가능성이 없습니다. 대가가 있는데 항상 같습니다. 에이전트 수만큼의 복사본, 그리고 마지막에 복사본마다 한 번의 병합입니다. 파일 점유 기능이 있는 단일 디렉터리는 이 둘을 모두 없애는 대신, 에이전트가 가끔 30초 정도 기다리게 합니다.
에이전트마다 브랜치를 주면 안 되나요?
흔한 해법이지만 비용을 끝으로 미룰 뿐입니다. 브랜치 셋은 병합 셋을 만들고, 충돌은 세 에이전트가 모두 끝난 뒤, 즉 아무도 이유를 기억하지 못하는 시점에 드러납니다. 공유 디렉터리는 충돌이 발생하는 순간 해결합니다.
에이전트가 점유를 무시하면 어떻게 되나요?
선택의 여지가 없습니다. 규칙은 서버가 강제하는 것이지 모델에 제안하는 것이 아닙니다. 감시자가 실제 쓰기를 지켜보며 각각을 작성자에게 연결하고, 다른 사람이 점유한 경로에 쓰기가 발생하면 반영되기 전에 스냅샷됩니다. 두 버전 모두 여전히 존재합니다.
동시에 몇 개의 에이전트가 가능한가요?
Pro 요금제에서 다섯 개의 에이전트 창, 그 이상은 상위 요금제에서 가능합니다. 실질적인 한계는 머신이 아니라 그 순간 프로젝트가 담고 있는 독립적인 작업의 수입니다.