DeepSeek Harness(DSH)로 코드를 수정하다 보면 항상 같은 지점에서 막히는 경우가 많습니다. 하나의 세션에서 여러 모듈을 건드리면 순서 대기가 발생하고, 병렬화를 위해 두 개의 세션을 열면 양쪽 모두 동일한 작업 디렉토리를 공유하기 때문에 git status가 엉망이 됩니다. 심지어 머지(merge) 전에 누가 어떤 파일을 수정했는지 수동으로 분류해야 하는 상황에 놓입니다. 여기서 제가 확인하고 싶었던 핵심은 '작업의 분할'과 '파일의 격리'를 개별적으로 해결할 수 있는지 여부였습니다.
0.2.2 프리릴리스 버전에는 마침 이 두 가지 절반씩을 담당하는 실험적 플러그인이 포함되어 있습니다. 버전을 0.2.2-rc.1로 고정하고 전용 테스트 리포지토리를 준비하여, 두 개의 서브 에이전트가 두 모듈을 병렬로 수정하도록 하여 처음부터 끝까지 전체 과정을 실행해 보았습니다.
결론 (검증일 2026-11-17, 버전 0.2.2-rc.1): 조합 자체는 성립하지만, 바로 사용할 수 있는 만능 도구는 아닙니다. AgentTeam이 작업을 이름이 지정된 팀원에게 할당하고, Git Worktree가 각 팀원에게 전용 체크아웃 디렉토리와 전용 브랜치를 제공합니다. 이 둘은 자연스럽게 상호 보완적이지만, 프리릴리스 버전에서는 자동으로 연동되지 않습니다. worktree 생성은 작업 지시문에 명시해야 하며, 커밋과 후속 처리는 사용자가 직접 해야 합니다.
- Windows, C:와 D: 드라이브 모두 NTFS 형식
- DeepSeek Harness 0.2.2-rc.1 (설정된 상태에서 시작. 실행 시 업데이트 확인 단계에서 이미 rc.3을 감지하고 있어, 프리릴리스 채널의 변화가 빠릅니다)
- 모델:
deepseek-v4-flash
(Crazyrouter 게이트웨이를 경유) - 테스트용 리포지토리: 공개된 zhouxiaoying416-sketch/dsh-agentteam-worktree-demo
(서로 의존하지 않는 3개 모듈, 베이스라인은 테스트 8건 모두 실패)
이것은 AI의 문제가 아니라 Git 메커니즘의 문제입니다. 체크아웃 디렉토리는 하나의 작업 트리 상태와 인덱스를 가질 수밖에 없습니다. 두 프로세스가 같은 디렉토리에서 파일을 수정하면, git status에는 양쪽의 변경 사항이 섞여 표시되며, 같은 파일을 건드릴 경우 먼저 저장한 쪽이 나중에 저장하는 쪽을 조용히 덮어쓰게 됩니다. 여러 에이전트가 하나의 체크아웃을 공유하는 것은 두 명의 엔지니어가 같은 기기의 같은 폴더를 차지하려는 것과 같은 구도입니다.
git은 이 문제에 이미 답을 가지고 있습니다. git worktree를 사용하면 하나의 리포지토리에 여러 개의 체크아웃 디렉토리를 마운트할 수 있으며, 각각 고유의 브랜치와 인덱스를 가집니다. 충돌이 물리적으로 발생하지 않게 됩니다. DSH의 worktree 플러그인은 바로 이 메커니즘을 세션 사이드바에 가져온 것이며, AgentTeam 문서에서도 "멤버는 체크아웃을 공유할 가능성이 있으며, 독립적인 출력 경로 또는 워크트리가 여전히 중요하다"고 명시되어 있어 일관성이 있습니다.
AgentTeam(지능체 팀) — 누가 무엇을 할지 결정합니다. 세션이 주도권을 갖고 목표를 이름 지정된 작업에 할당하며, 팀원을 가동하고 공유 보드에서 진행 상황을 추적하며, 팀원들 간 메시지를 주고받게 한 후 마지막에 종합적으로 보고합니다.
- 변경 요청 및 워크트리(Change Requests & Worktrees) — 어디서 할지 결정합니다. 사이드바가 관련 PR과 로컬 변경 사항을 추적하고, 각 작업을 독립된 워크트리로 격리시킵니다.
한쪽은 작업 분배를, 다른 쪽은 파일 격리를 담당합니다. 어느 한쪽만으로는 부족합니다.
먼저 두 플러그인을 모두 켭니다. 플러그인 페이지의 '실험적 플러그인' 섹션에 있으며, 기본값은 꺼져 있습니다.
다음으로 세션을 만들고 모델을 선택합니다. 저는 Crazyrouter 게이트웨이를 경유하여 deepseek-v4-flash를 사용했습니다. 프로바이더의 Base URL은 이 값입니다:
작업 전에 반드시 확인해야 합니다. /v1/models로의 요청은 HTTP 200으로 반환되며, 카탈로그에는 173개의 모델과 deepseek-v4-flash가 포함되어 있었습니다. 모델 사용 가능 여부를 직접 확인하려면 모델 카탈로그를, 작업을 시작하기 전에는 게이트웨이의 모델 카탈로그와 과금 조건에 눈을 돌리십시오. 접근 조건과 모델 ID는 이 카탈로그가 기준입니다.
세 번째는 접근 모드 설정이었고, 이곳이 이번 실측에서 첫 번째 함정이었습니다. 기본값인 '작업 공간 내 수정' 모드에서는 Windows 환경의 샌드박스가 워크스페이스에 대한 쓰기 권한(ACL)을 얻는 데 실패하여, 세션이 3% 상태로 10분 이상 정체되었습니다. 모델 자체는 이를 "Windows 샌드박스의 알려진 문제"로 진단했습니다. 먼저 파일 시스템을 분리해 보았습니다—C:도 D:도 NTFS이므로 ACL 미지원일 리가 없고, 막힌 곳은 샌드박스 자체의 승인 단계였습니다. '완전 권한'으로 전환하여 대화 상자를 확인하자 쓰기는 모두 정상화되었습니다. 그 대가로 민감한 작업 확인 단계가 줄어들기 때문에, 신뢰할 수 있는 작업에만 사용해야 합니다. 솔직히 말하자면, 세션에 보낸 지시문은 중국어로 작성한 것이었으며, 리포지토리, 코드, 테스트는 언어에 의존하지 않습니다.
작업은 2개 모듈로 제한하고 규칙을 먼저 고정했습니다.
- 팀원 A는
textutil 을 feature/textutil 브랜치에서 담당 - 팀원 B는 mathutil 을 feature/mathutil 브랜치에서 담당 - 각자 git worktree add 로 독립 워크트리를 만들고, 자신의 파일만 수정 - 상대방에게는 건드리지 않고, merge하지 않고, push하지 않습니다.
작업을 보내자, 리드는 먼저 리포지토리 상태를 확인하고 공유 작업을 생성한 뒤, 두 명의 팀원을 병렬로 가동했습니다. 세션 헤더에 서브 에이전트 수(중국어 UI에서는 '2个子智能体' = 2개의 서브 에이전트)가 표시되고, 사이드바 작업 보드가 움직이기 시작합니다.
워크트리는 정말 별개로 생성되었습니다. git worktree list에 두 줄이 늘어났고, wt-textutil은 feature/textutil에, wt-mathutil은 feature/mathutil에 연결되었으며, 메인 리포지토리는 처음부터 끝까지 깨끗한 상태를 유지했습니다. 두 디렉토리를 개별적으로 확인했을 때, 변경된 것은 각각 자신의 소스 파일뿐이라 교차는 제로였습니다. 각 위치에서 node --test를 실행하자, 둘 다 3개 합격 0개 불합격이었습니다.
커밋 단계에서 경계가 드러났습니다. textutil 측 팀원은 스스로 커밋했습니다. 커밋 신분은 자신의 이름(textutil-dev, 단축 해시 f650772)이었고, 메시지도 깔끔하게 정리되어 있었습니다. 반면 mathutil 측은 수정을 마치고 테스트에 합격했으며 파일을 staged했지만—여기서 멈췄습니다. 리드는 보고를 기다리며 정체되었고, 제가 보낸 두 건의 메시지는 도착하지 않았습니다. 막힌 턴을 멈추고, 직접 wt-mathutil로 들어가 커밋을 보완했습니다. AgentTeam 프로토콜에는 '반드시 git commit까지 완료한다'는 항목이 없습니다. 팀원이 어디까지 진행할지는 그 서브 에이전트에게 달렸으며, 브랜치가 깨끗한지 여부는 마지막에 직접 검증할 수밖에 없습니다.
리뷰는 오히려 가장 쉬운 과정이었습니다. 1개 브랜치, 1개 커밋, 1개 파일이었기 때문에, git show --stat을 흘깃 보는 것만으로 충분했습니다. 저는 실용적인 지적을 한 건 했습니다(clamp 함수가 min > max의 역전 구간에 대한 동작을 정의하지 않았다는 점). wt-mathutil에서 수정 커밋을 만들고, 테스트를 재실행하여 3개 합격 0개 불합격이었습니다.
정리는 git worktree remove로 두 디렉토리를 삭제했습니다. 워크트리 목록은 메인 리포지토리만으로 돌아왔고, 두 개의 브랜치와 커밋은 그대로 남아있었습니다. 메인 리포지토리의 8개 테스트는 여전히 전멸 상태였습니다—이것이야말로 원했던 결과입니다. 격리 기간 동안 main에 유출된 것은 전혀 없으며, merge 타이밍은 완전히 제 손안에 있습니다.
| 공정 | 실측에서의 동작 | 자동? |
|---|
| 작업 분할, 팀원, 보드 | 병렬 실행, 보드는 실시간 업데이트 | 자동 |
| ... | | 정리 |
| Windows 쓰기 권한 | 기본 모드에서 ACL 획득 실패, 완전 권한이면 정상 | 함정, 수동으로 회피 |
시간 기록도 솔직하게 말씀드리자면, 태스크 전송부터 두 모듈의 테스트 전체 통과까지 팀원 2명은 10분 조금 넘었습니다. 리드가 막히는 턴을 포함한 전체로는 20분을 초과하여 제가 순차적으로 하는 것보다 느립니다. 병렬화가 얻는 것은 처리 시간이 아니라 지켜보지 않아도 되는 시간입니다. 분할, 할당, 진행 상황 추적은 리드의 업무이고, 저는 리뷰와 마무리 단계에만 참여하면 됩니다. 모듈이 더 많아진다면 이 차이는 저에게 유리한 방향으로 벌어질 것입니다.
팀원이 메인 리포지토리를 오염시키나요? 그렇지 않습니다. 실측을 통해 메인 리포지토리의 git status는 깨끗했고, main 브랜치는 초기 커밋 상태를 유지했으며, 8개 테스트는 계속해서 전멸(실패) 상태를 유지했습니다. 전제 조건은 지침에 "merge하지 않기, push하지 않기"라고 명시하는 것입니다.
팀원이 직접 커밋하나요? 이름이 지정된 로컬 신원(실측에서는 textutil-dev와 같은 로컬 주소)으로 커밋하는 경우는 있지만, 작동은 보장되지 않습니다. mathutil 담당자는 staged 상태에서 멈췄습니다. 마무리는 반드시 제가 해야 합니다.
업그레이드 시 설정이 사라지나요? 이번에는 업그레이드를 실행하지 않았기 때문에 결론을 내릴 수 없습니다. 관찰된 것은 업데이트 확인이 rc.3을 제시하고 있다는 점과, 실험적 플러그인 설명에 "API는 RC 간에 변경될 수 있다"고 명시되어 있다는 것입니다. 업그레이드 전에 플러그인 설정 스크린샷을 남기는 것이 안전합니다.
3%에서 멈춘다면요? 먼저 접근 모드를 확인하십시오. 기본 모드에서의 샌드박스(Sandbox) ACL 실패는 0~3% 구간이 길게 지속되는 형태로 나타납니다. "완전 권한"으로 전환하면 즉시 회복됩니다. 그 후, 드라이브가 NTFS인지 확인하여 파일 시스템의 ACL 미지원 여부를 구분해 보십시오.
재현에 필요한 것: 테스트 리포지토리는 공개된 zhouxiaoying416-sketch/dsh-agentteam-worktree-demo이며, 3개 모듈과 3개 테스트 파일로 구성되어 있습니다. 클론하면 베이스라인은 8개 테스트 전멸(실패)입니다. 모델은 게이트웨이를 통해 deepseek-v4-flash를 사용하고, 엔드포인트는 /v1/chat/completions이며, 모델 ID는 게이트웨이 카탈로그를 따릅니다.
이 조합은 계속 사용할 것이지만, 용도는 "병렬 멀티 모듈 개조"라는 한 장면에 국한합니다. 단일 파일/단일 모듈 작업이라면 일반 세션이 더 빠르고 저렴합니다. AgentTeam이 담당하는 것은 업무 할당 및 진행 상황 관리이고, Worktree가 담당하는 것은 물리적 충돌 방지이며, 커밋 마무리, 리뷰 반영, 워크트리 정리 정돈은 제 업무입니다. 이 분담을 수용할 수 있느냐가 프리릴리스(pre-release)를 시도해 볼 가치가 있는지를 나누는 기준점입니다. 두 플러그인 모두 실험적이며 API는 RC 간에 변경될 수 있으므로, 프로덕션 리포지토리에는 안정 버전을 기다려 주십시오.