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

작성한 질문수 2

0

안녕하세요 Staty님,

중요한 질문 잘 하신 것 같습니다!

실무에서는 아직 완전히 표준화된 방식이 있다고 보기는 어렵습니다. 그 이유는 회사마다 다른 정책이 있고 써야되는 Model들이 정해져 있어서요. 다만 제가 본 팀들은 보통 AI Agent별 설정을 모두 Git에 포함시키기보다는, 공통 규칙과 프로젝트 컨텍스트를 먼저 공유하고 Agent별 설정은 최소화하는 방향을 선호합니다.

예를 들어 다음과 같이 관리하는 경우가 많습니다.

• 프로젝트 공통 규칙

  • docs/

  • specs/

  • README.md

  • AGENTS.md 또는 CONTRIBUTING.md

• Agent별 설정

  • .codex/

  • .claude/

공통적으로 알아야 할 내용(아키텍처, 코딩 규칙, 배포 방식, PR 정책 등)은 Git으로 관리되는 문서에 두고, Codex와 Claude는 그 내용을 읽어가도록 구성합니다. 이유는 Agent가 바뀌더라도 프로젝트 지식은 그대로 유지되기 때문입니다.

만약 모든 규칙을 .codex, .claude 안에 각각 복사해두면 시간이 지나면서 내용이 서로 달라지는 문제가 자주 발생합니다.

그래서 제가 추천하는 방식은:

1. 프로젝트 공통 지식은 Git으로 관리

2. Agent별 디렉터리에는 해당 Agent만 필요한 설정만 저장

3. 가능한 한 중복 규칙은 만들지 않기

입니다.

실제로 저도 개인적인 프로젝트로는 Codex와 Claude를 같이 사용하는 경우에는 프로젝트 루트에 공통 문서를 두고, 각 Agent 설정은 최소한으로 유지하는 편입니다. Agent는 바뀔 수 있지만 프로젝트 지식은 남아야 하기 때문입니다.
아직 인더스트리에 기준이 성숙해지지 않아서, 제가 100% 확신은 못 드리지만 현재 사용하는 방법을 공유해 드렸습니다.