코덱스 병렬 작업과 워크트리: 나눌 일부터 정해요

서로의 결과를 기다리지 않아도 되는 일을 골라요. 가이드 개편이라면 기존 문장 교정, 새 글 작성, 이미지 자료 확인을 나눌 수 있어요. 반대로 새 데이터 형식을 정한 뒤 화면을 고치는 작업이라면 형식 합의가 먼저예요.

일을 나눌 때는 파일이나 조사 질문으로 범위를 정해 주세요. ‘각자 사이트를 개선해 줘’처럼 넓게 맡기면 같은 곳을 고치거나 서로 다른 기준을 적용하기 쉬워요.

서브에이전트는 현재 요청의 일부를 다른 에이전트에게 맡기는 방식이에요. 메인 에이전트가 결과를 모아 전체 작업을 마무리해요. 병렬로 처리하고 싶다면 독립된 부분을 나눠 맡겨 달라고 명시해 주세요.

워크트리는 같은 Git 저장소를 다른 폴더에 펼쳐서 작업하는 기능이에요. 서브에이전트를 쓴다고 각자의 파일이 자동으로 분리된다고 생각하면 안 돼요. 작업을 누구에게 맡길지와 파일을 어디에서 바꿀지는 따로 정해야 해요.

아래 예시처럼 담당할 파일, 공통 기준, 완료 조건을 적어 보세요. 서로 같은 파일을 바꿔야 한다면 한 담당자에게 맡기거나 순서를 정해 주세요.

요청 예시: ‘가이드 개편을 서브에이전트로 병렬 진행해 주세요. 한 명은 docs/install.md의 설명을 교정하고, 다른 한 명은 docs/troubleshooting.md의 오류 해결을 보강해 주세요. 두 글 모두 해요체를 쓰고 명령은 공식 문서와 대조해 주세요. 공통 목차 파일은 메인 에이전트가 수정하고, 마지막에 내부 링크를 함께 확인해 주세요.’

작업이 끝났을 때 받을 내용도 정해요. 변경 파일, 확인한 근거, 실행한 검사, 아직 해결하지 못한 문제를 함께 받으면 결과를 모으기 쉬워요.

현재 폴더의 작업을 유지한 채 다른 변경을 따로 진행하고 싶을 때 유용해요. Codex 앱에서 Git 프로젝트를 선택한 뒤 새 작업의 환경을 Worktree로 고르고 시작할 브랜치를 확인해요. 현재 수정 중인 파일까지 포함할지 여부도 시작 상태에서 확인해 주세요.

Git으로 관리하지 않는 폴더에는 이 방식의 워크트리를 쓸 수 없어요. 또한 새 작업 폴더에서 필요한 패키지나 실행 설정을 준비해야 할 수 있어요. 코드가 분리되더라도 실행 중인 서버의 포트나 외부 데이터까지 저절로 분리되는 것은 아니에요.

먼저 각 작업이 시작한 기준과 바꾼 파일을 확인해요. 같은 파일을 수정했다면 어느 변경을 유지할지 내용을 보고 결정해야 해요. 파일 충돌이 없더라도 한쪽이 바꾼 이름을 다른 쪽이 예전 이름으로 부를 수 있어요.

합친 뒤에는 각 담당자의 검사 결과만 모으지 말고 최종 상태를 검사해 주세요. 가이드라면 본문에서 가리키는 파일과 링크가 맞는지, 기능이라면 두 변경이 만나는 흐름이 작동하는지 확인해요.

담당자끼리 같은 결정을 기다리는지, 너무 작은 일을 잘게 나눴는지 살펴보세요. 두 문장 교정을 각각 맡기면 설명하고 합치는 시간이 더 들 수 있어요. 조사 범위가 넓거나 파일이 분리된 작업부터 나누는 편이 좋아요.

막힌 담당자에게는 새 일을 덧붙이기보다 필요한 결정이나 자료를 전달해 주세요. ‘기능 이름은 기존 문서를 기준으로 유지하고, 안내 문장만 고쳐 주세요’처럼 선택 범위를 좁히면 다시 진행하기 쉬워요.