AI Agent를 섞어 쓸 때 설정 파일 관리 질문입니다!

Question

안녕하세요. 팀 단위로 개발할 때, 일부는 Codex를 사용하고 일부는 Claude를 사용하는 경우 보통 AI Agent 설정 파일은 어떻게 관리하시나요? .codex/ , .claude/ 처럼 Agent별 디렉터리를 만들어 함께 GitHub에 커밋하는 편인가요? 아니면 각 Agent가 공통으로 참조하는 파일을 따로 두고, 각 에이전트 설정에서는 이를 참조하는 방식으로 관리하시나요? 실무에서는 어떤 방식이 일반적인지 궁금합니다.

altoformula · Answer

안녕하세요 Staty님, 중요한 질문 잘 하신 것 같습니다! 실무에서는 아직 완전히 표준화된 방식이 있다고 보기는 어렵습니다. 그 이유는 회사마다 다른 정책이 있고 써야되는 Model들이 정해져 있어서요. 다만 제가 본 팀들은 보통 AI Agent별 설정을 모두 Git에 포함시키기보다는, 공통 규칙과 프로젝트 컨텍스트를 먼저 공유하고 Agent별 설정은 최소화하는 방향 을 선호합니다. 예를 들어 다음과 같이 관리하는 경우가 많습니다. 프로젝트 공통 규칙 docs/ specs/ README.md AGENTS.md 또는 CONTRIBUTING.md Agent별 설정 .codex/ .claude/ 공통적으로 알아야 할 내용(아키텍처, 코딩 규칙, 배포 방식, PR 정책 등)은 Git으로 관리되는 문서에 두고, Codex와 Claude는 그 내용을 읽어가도록 구성 합니다. 이유는 Agent가 바뀌더라도 프로젝트 지식은 그대로 유지되기 때문 입니다. 만약 모든 규칙을 .codex, .claude 안에 각각 복사해두면 시간이 지나면서 내용이 서로 달라지는 문제가 자주 발생합니다. 그래서 제가 추천하는 방식은: 프로젝트 공통 지식은 Git으로 관리 Agent별 디렉터리에는 해당 Agent만 필요한 설정만 저장 가능한 한 중복 규칙은 만들지 않기 입니다. 실제로 저도 개인적인 프로젝트로는 Codex와 Claude를 같이 사용하는 경우에는 프로젝트 루트에 공통 문서를 두고, 각 Agent 설정은 최소한으로 유지하는 편입니다. Agent는 바뀔 수 있지만 프로젝트 지식은 남아야 하기 때문입니다. 아직 인더스트리에 기준이 성숙해지지 않아서, 제가 100% 확신은 못 드리지만 현재 사용하는 방법을 공유해 드렸습니다.