당신은 세 개의 Claude Code 에이전트를 병렬로 실행했습니다. 각각의 작업이 완료되었습니다. 각 브랜치는 컴파일되었습니다. Git은 충돌이 없다고 말합니다.
당신은 머지(Merge)합니다. 그런데 운영 환경(Prod)에서 무언가 깨집니다. 머지 중에는 에러가 없었습니다. CI 실패도 없었습니다. 그저 컴파일은 잘 되지만 런타임(Runtime)에서 폭발하는 불일치(Mismatch)가 발생했을 뿐입니다.

이것이 바로 에이전틱 드리프트(Agentic Drift)이며, 이는 AI 보조 개발(AI-assisted development)에서 가장 흔한 실패 모드 중 하나가 되고 있습니다.

에이전틱 드리프트의 실제 정의
에이전틱 드리프트는 Git 충돌이 아닙니다. 이는 두 에이전트가 서로의 존재를 모르는 상태에서, 동일한 문제를 서로 호환되지 않는 방식으로 독립적으로 해결할 때 발생하는 현상입니다. 제가 Switchman을 만들게 만든 정확한 시나리오는 다음과 같습니다:

저는 세 개의 Claude Code 세션을 병렬 워크트리(Worktrees)에서 실행하고 있었습니다:

에이전트 1은 JWT 미들웨어(Middleware)를 구축하고 있었습니다. 현재 사용자를 식별하기 위해 req.user.id를 작성했습니다.

에이전트 2는 사용자 스키마(User schema)를 구축하고 있었습니다. id가 아닌 userId 필드를 내보냈습니다(Exported).

에이전트 3은 인증 테스트(Auth tests)를 작성하고 있었습니다. 두 가지 모두 통과했습니다.

머지 충돌은 없었습니다. 두 브랜치는 서로 다른 파일을 건드렸습니다. Git은 만족했습니다. 테스트는 두 구현 모두 고립된 상태에서는 올바르게 보이도록 모킹(Mocking)하고 있었습니다.
미들웨어는 req.user.id를 기대했습니다. 스키마에는 userId가 있었습니다. 이들은 운영 환경(Prod)에 도달할 때까지 결코 만나지 못했습니다.

이것이 에이전틱 드리프트의 핵심입니다: 고립된 상태에서의 정확성, 결합 시의 불호환성.

상황이 악화되는 이유
1년 전만 해도 대부분의 개발자는 사이드바의 제안 엔진(suggestion engine) 정도로, 한 번에 하나의 AI 에이전트(AI agent)만 실행했습니다. 에이전트의 결과물이 코드베이스(codebase)에 반영되기 전에 모든 것을 수동으로 검토했습니다. 하지만 이제 워크플로우(workflow)가 바뀌었습니다. 여러분은 세 개의 Claude Code 세션을 실행하고, 각각에 작업을 부여한 뒤, 작업이 완료될 때까지 기다렸다가 돌아옵니다. 여러분은 구현자(implementer)가 아니라 관리자(manager)가 된 것입니다. 속도 향상은 실질적입니다. 하지만 검토 프로세스(review process)가 그 속도를 따라잡지 못하고 있습니다. 에이전트를 하나만 실행했을 때는 하나의 브랜치(branch)만 검토하면 되었습니다. 하지만 세 개의 에이전트를 병렬로 실행할 때는 각 에이전트가 개별적으로 정확한지뿐만 아니라, 세 에이전트가 서로 어떻게 연관되는지를 이해해야 합니다. Git diff는 무엇이 변경되었는지는 알려줄 수 있지만, 그 변경 사항들이 일관성(coherent)이 있는지는 알려줄 수 없습니다.

네 가지 유형의 드리프트 (drift)
모든 에이전틱 드리프트(agentic drift)가 동일한 모습으로 나타나는 것은 아닙니다. 주의해야 할 사항은 다음과 같습니다:

인터페이스 드리프트 (Interface drift) — 두 에이전트가 동일한 인터페이스(interface)를 서로 다르게 구현합니다. 하나는 { id, email }을 반환하는 함수를 작성하고, 다른 하나는 { userId, emailAddress }를 기대하는 함수를 작성합니다. 둘 다 컴파일(compile)은 됩니다. 하지만 런타임(runtime)에서 충돌이 발생합니다.

의미론적 드리프트 (Semantic drift) — 두 에이전트가 서로 다른 로직(logic)으로 동일한 문제를 해결합니다. 하나는 JWT 만료를 사용하는 인증(auth) 체크를 작성하고, 다른 하나는 세션 토큰(session tokens)을 사용하는 인증 체크를 작성합니다. 각각은 고립된 상태에서 잘 작동합니다. 하지만 함께 사용될 때 두 개의 상충하는 인증 경로를 만들어 하위 코드(downstream code)를 혼란에 빠뜨립니다.

소유권 드리프트 (Ownership drift) — 두 에이전트가 서로의 존재를 모른 채 동일한 파일을 수정합니다. 만약 서로 다른 라인을 수정했다면 Git은 이를 충돌(conflict)로 표시하지 않을 수도 있습니다. 하지만 결합된 결과물은 일관성이 없습니다.

범위 드리프트 (Scope drift) — 한 에이전트가 수행한 변경 사항이 다른 에이전트가 이미 완료한 작업을 소리 없이 무효화합니다. 에러도 없고, 경고도 없습니다. 그저 커밋된(committed) 코드 안에 오래된 가정(stale assumptions)이 박혀 있을 뿐입니다.

Git이 이를 잡아낼 수 없는 이유
Git은 줄 단위(line-by-line) 변경 추적기입니다. Git은 의미론(semantics), 인터페이스(interfaces), 또는 의도(intent)에 대해서는 전혀 알지 못합니다. 머지 충돌(merge conflict)은 두 브랜치가 동일한 줄을 건드릴 때 발생합니다. 반면 에이전틱 드리프트(Agentic drift)는 두 브랜치가 서로 일치해야 하는 서로 다른 파일들을 건드릴 때 발생합니다. src/middleware/auth.ts와 src/db/schema.ts는 서로 다른 파일입니다. 이들은 깔끔하게 머지(merge)될 것입니다. Git은 한쪽의 req.user.id가 다른 쪽의 userId에 의존한다는 사실을 알 방법이 없습니다. 이것이 바로 간극(gap)입니다. 그리고 병렬 에이전트 워크플로(parallel agent workflows)가 주류가 됨에 따라 이 간극은 현저하게 커졌습니다.

머지하기 전에 이를 잡아내는 방법
해결책은 머지하기 전에 모든 워크트리(worktrees)에 대해 의미론적 검토(semantic review)를 수행하는 것입니다. 이는 단순한 git diff가 아니라, 각 에이전트가 실제로 무엇을 구축했는지, 그리고 그 결과물들이 서로 잘 맞는지 이해하는 검토입니다.
그것이 바로 제가 Switchman을 만든 목적입니다.

에이전트 작업이 완료된 후, 다음을 실행하세요:
bashswitchman review --pr-ready --all-worktrees
이 명령은 모든 워크트리를 스캔하여 각 에이전트가 구축한 내용에 대한 평이한 영어 요약(plain-English summary)을 생성하고, 의미론적 충돌(semantic conflicts) 및 인터페이스 불일치(interface mismatches)를 표시하며, 단일한 신뢰도 판정(confidence verdict)을 내려줍니다:

🟢 GREEN - 머지해도 안전함.
🟡 AMBER - 머지 전 검토 필요. 인증 미들웨어(auth middleware)에서 인터페이스 불일치 발생.
🔴 RED - 머지 금지.

만약 Claude Code를 구체적으로 사용 중이라면, 세션이 종료될 때마다 이를 자동으로 실행하는 스탑 훅(Stop hook)을 설치할 수 있습니다:
bashswitchman claude hooks install

설치 후에는 모든 Claude Code 세션이 조용한 신뢰도 확인(confidence check)과 함께 종료됩니다. 문제가 생겼을 때만 알림을 받게 됩니다.

더 큰 그림
에이전틱 드리프트는 소프트웨어가 구축되는 방식의 더 광범위한 전환을 보여주는 증상입니다. 우리는 AI를 제안 엔진(suggestion engine)으로 사용하던 시대에서 자율적 구현체(autonomous implementer)로 사용하는 시대로 이동했습니다. 이는 진정으로 강력하지만, 그에 따른 다른 안전 수칙(safety practices)을 요구합니다.

인간 개발자가 기능 브랜치(feature branch)에서 단독으로 작업할 때는 코드베이스의 나머지 부분에 대한 문맥(context)을 머릿속에 담고 있습니다. 그들은 userId가 필드 이름이라는 것을 알고 있는데, 왜냐하면 지난주에 직접 작성했기 때문입니다.

당신이 명시적으로 제공하지 않는 한, AI 에이전트(AI agent)는 그러한 맥락을 전혀 가지고 있지 않습니다. 에이전트는 고립된 상태에서 일관된 결과물을 만들어내겠지만, 한 시간 전에 다른 에이전트가 구축한 내용과 충돌한다는 사실을 전혀 알지 못할 것입니다.

병렬 에이전트 개발(parallel agent development)을 둘러싼 도구와 관행은 여전히 워크플로(workflows)를 따라잡기 위해 노력 중입니다. 에이전틱 드리프트(Agentic drift)는 우리가 해결해야 할 첫 번째 실패 모드(failure modes) 중 하나입니다. 왜냐하면 이것은 눈에 보이지 않고, 흔하게 발생하며, 병렬 에이전트 세션이 소프트웨어를 출시하는 기본 방식이 됨에 따라 발생 빈도가 더욱 높아질 것이기 때문입니다.

Switchman은 병렬 AI 코딩 세션 이후에 병합(merge)에 대한 확신을 주는 오픈 소스 CLI 도구입니다. MIT 라이선스로 제공되며, 별도의 설정이 필요하지 않습니다.

npm install -g switchman-dev