클로드·코덱스 함께 쓰는 사람들, 지침 동기화 노하우를 나누다

오후 4시 3분, 한 참여자가 전역의 AGENTS.md와 CLAUDE.md도 심링크로 연결해 동일하게 유지한다는 자신의 설정법을 공유하며 대화를 열었다.

앤스로픽 클로드(Claude)와 오픈AI 코덱스(Codex)를 함께 쓰는 사람이 늘면서, 두 지침 문서를 어떻게 어긋나지 않게 관리할지가 방의 화두로 떠올랐음을 보여주는 장면이었다. AI 협업 방식이 개인 실험 단계를 지나 각자의 운영 체계로 굳어지고 있음을 보여주는 장면이기도 했다.

검증은 코덱스가, 확인은 클로드가

13분 뒤 다른 참여자는 역할 분담 아이디어를 구체적으로 제안했다. 코덱스에게 작업이나 구현 계획이 끝나면 검증 요구 문서를 md 파일로 작성하게 시키고, 그 파일을 클로드에게 넘겨 결과를 확인하게 하는 방식이었다. 지침 파일을 물리적으로 동기화하는 앞선 방식과 달리, 이번에는 두 모델이 서로 다른 역할을 맡아 결과물을 주고받는 구도였다.

"저라면 코덱스에게 ”이 작업(또는 구현 계획 등등) 끝나면 클로드가 결과를 검증하도록 검증 요구문서를 md 파일로 작성해”라고해서 파일을 클로드에게 던져주는것을 시작점으로 할것 같네요"

1분 뒤 같은 참여자는 이 구도에 원칙을 하나 더 붙였다. "검증을 요청하는 쪽보다 검증하는 쪽이 모델이 더 높아야 좋을것 같구요"라는 말은, 작업을 맡기는 모델과 검증하는 모델 사이에 등급 차이를 둬야 교차검증이 실질적인 효과를 낸다는 취지였다.

심링크 대 공유 SSOT 라우팅

지침 동기화 방식을 둘러싼 의견은 갈렸다. 오후 4시 24분, 한 참여자는 심링크를 쓰지 않고 공유 SSOT 지침 문서를 두고 각 지침 파일이 그쪽을 참조하도록 라우팅하게 해뒀다고 전했다.

단일 진실 원천(SSOT) 문서 하나를 두고 모델별 지침 파일이 그쪽을 참조하는 방식이었다. 10분 뒤에는 정반대 진단이 나왔다. 오후 4시 34분, 다른 참여자는 "모델별로 다른 기준의 하네스가 필요하다고 알고있어요"라며 클로드와 코덱스를 애초에 같은 지침으로 묶는 방식 자체에 한계가 있을 수 있다는 입장을 밝혔다.

심링크로 두 파일을 물리적으로 묶는 방식, 공유 SSOT 문서로 라우팅하는 방식, 그리고 모델별로 다른 하네스를 두자는 입장까지 — 같은 자리에서 세 갈래 해법이 나란히 놓인 셈이다. 세 방식 모두 전제는 같다. 지침 문서가 한쪽에서만 갱신되고 다른 쪽에는 반영되지 않으면, 두 모델이 서로 다른 기준으로 같은 코드베이스를 건드리게 된다는 우려다.

목표는 같다. 클로드와 코덱스를 병행하면서도 지침이 한쪽에서만 갱신돼 어긋나는 사고를 막으려는 시도로, 듀얼 하네스 운영이 이제 개인의 취향을 넘어 방식 자체를 두고 겨루는 단계에 들어섰음을 시사한다. 앞서 나온 검증 역할 분담론과 겹쳐 보면, 이날 오간 대화는 결국 하나의 질문으로 수렴한다. 서로 다른 두 모델을 하나의 작업 흐름 안에 묶을 때, 그 흐름을 지탱하는 문서와 규칙을 누가 어떤 형태로 갱신하고 공유할 것인가라는 질문이다.