저희는 AI 코딩 도구를 하나만 쓰지 않습니다. 작업 공간 규칙 문서에는 Claude Code와 ChatGPT Codex가 각각 작업을 끝냈을 때 알림을 보낼 채널이 따로 적혀 있습니다. 지난 편에서 예고한 대로 이번 편은 두 도구를 같이 쓰면서 저희가 정해 둔 것과, 아직 정하지 못한 것을 적습니다. 어느 도구가 더 낫다는 이야기는 아닙니다. 저희 기록으로는 그런 비교를 할 수 없습니다.
세 줄 요약
- 도구가 달라도 규칙은 하나입니다. 저장소마다 AGENTS.md를 두고, Claude Code가 읽는 CLAUDE.md는 @AGENTS.md 한 줄로 연결한 저장소도 있습니다.
- 작업이 끝나면 어느 도구든 같은 형식으로 알림을 보내고, 채널만 도구별로 나눴습니다.
- Claude Code의 메모리에만 적힌 규칙은 다른 도구가 읽지 못합니다. 같이 지켜야 할 규칙은 AGENTS.md로 옮기는 편이 맞습니다.
같은 규칙을 읽게 하기
도구마다 읽는 규칙 파일의 이름이 다릅니다. 저희는 이 차이를 파일 하나로 맞췄습니다. 모든 저장소의 규칙은 AGENTS.md에 쓰고, Claude Code용 CLAUDE.md가 필요하면 그 안에 @AGENTS.md 한 줄만 둡니다. 어드민 웹 저장소가 저장소를 만든 첫날인 7월 5일부터 이 방식이었습니다. 규칙을 두 군데에 적으면 한쪽만 고쳐져 어긋나기 쉽기 때문입니다.
작업 공간 루트의 규칙 문서는 두 도구가 똑같이 따르는 약속을 이렇게 정해 둡니다(저장소 이름은 일반화했습니다).
하위 프로젝트에서 작업할 때는 해당 디렉토리의 AGENTS.md(또는 CLAUDE.md)를 반드시 먼저 확인한다.
기존 구조/패턴을 임의로 변경하거나 추측으로 구현하지 않는다.
요청받지 않은 리팩토링이나 작업 범위를 벗어난 수정을 하지 않는다.
저장소별 AGENTS.md는 짧은 것은 열 줄도 되지 않습니다. 서버 저장소의 규칙 문서는 “우선적으로 참고할” 명세 문서 목록이 거의 전부입니다. 반대로 안드로이드 앱 저장소의 규칙 문서는 1,400줄이 넘고, 기술 스택, 패키지 구조, 새 라이브러리를 임의로 추가하지 않는다는 원칙까지 담았습니다. 도구가 바뀌어도 이 문서를 읽고 시작하면 같은 구조 안에서 작업하게 되는 것이 목표입니다.
작업이 끝나면 같은 형식으로 알리기
두 도구를 같이 쓰면 “방금 누가 무엇을 바꿨는지”를 놓치기 쉽습니다. 그래서 루트 규칙 문서에 작업 종료 규칙을 넣었습니다. 작업이 끝나면 항상 Slack으로 알리고, 형식은 아래 템플릿으로 고정했습니다.
[작업 완료] 작업 내용 한 줄 요약
– 작업 프로젝트
– 작업 내용 1, 2, … n
– 커밋 Hash (master 브랜치 푸시 여부)
채널은 도구마다 나눠서, 알림 채널 이름만 보고도 어느 도구가 한 작업인지 알 수 있게 했습니다. 알림에는 프로젝트와 커밋 해시가 들어가므로, 이상한 변경이 보이면 해당 커밋을 바로 찾아볼 수 있습니다. 작업 종료 후 커밋과 푸시는 별도 요청이 없으면 master 브랜치에 바로 진행한다는 규칙도 같은 문서에 있어서, 두 도구의 작업이 같은 줄기에 쌓입니다.
기록으로 확인되는 것, 확인되지 않는 것
그러면 실제로 누가 얼마나 작업했을까요? 기록으로 확인되는 범위가 좁습니다.
| 확인되는 것 | 숫자 |
|---|---|
| Claude Code의 공동 작성자 꼬리말(Co-Authored-By)이 붙은 커밋 | 5개 저장소에서 327개 |
| 그중 안드로이드 앱 저장소 | 252개 |
| 가장 이른 꼬리말 | 2026년 8월 8일 (안드로이드) |
| Codex 표기가 남은 커밋 | 0개 |
2026년 10월 3일 기준 집계이고 머지 커밋이 포함돼 있습니다. 중요한 것은 이 표가 Codex의 작업량이 0이라는 뜻이 아니라는 점입니다. 꼬리말이 없는 커밋이 어느 도구로 만든 것인지는 git 기록으로 구분할 수 없습니다. 그래서 “어느 도구가 몇 퍼센트를 했다”는 숫자는 이 글에 쓰지 않았습니다. 기록으로 구분하고 싶다면 두 도구의 커밋 꼬리말을 처음부터 규칙 문서로 정해 두는 편이 좋았을 것입니다. 저희가 뒤늦게 얻은 교훈입니다.
한 가지 더 확인되는 것은 쓰임새의 일부입니다. 이 블로그의 대표 이미지는 Codex로 만들고, 글 쓰는 절차는 Claude Code 전용 스킬 폴더에 있습니다. 같은 블로그 안에서도 도구마다 맡은 일이 다르다는 정도가 기록으로 확인됩니다.
한 도구에만 남은 규칙
가장 눈에 띄는 어긋남은 규칙을 적는 위치였습니다. Claude Code는 작업 중 바로잡은 일을 메모리에 피드백으로 남깁니다. 저희 메모리 기록에는 “커밋 메시지 본문은 한국어로 쓴다”와 “안드로이드 디버그 앱은 연결된 기기 두 대에 모두 설치한다” 같은 규칙이 있습니다. 앞의 것은 8월 29일에 정했고, 한글이 들어간 커밋 제목의 비율이 그 전후로 달라졌다는 것은 12주, 저장소 11개 편에서 적었습니다.
문제는 이 메모리 파일이 Claude Code가 자기 설정 폴더에 저장하는 것이라 다른 도구는 읽지 않는다는 점입니다. 두 도구가 같이 지켜야 할 규칙인데 한쪽 메모리에만 있으면, 다른 쪽은 규칙이 있는지조차 모릅니다. 이 규칙들이 AGENTS.md에는 아직 없다는 것을 이번에 소재를 모으며 확인했습니다. 그래서 저희가 정리한 기준은 이렇습니다.
- 함께 지킬 규칙은 AGENTS.md에 씁니다. 커밋 메시지 언어, 푸시 규칙, 알림 형식이 여기에 들어갑니다.
- 도구 하나의 사용법만 도구 전용 위치에 둡니다. 스킬이나 자동 실행 설정이 그렇습니다.
- 메모리에 피드백이 쌓이면 가끔 열어 보고, 다른 도구에도 필요한 것은 AGENTS.md로 옮깁니다.
따라 해 보기: 두 도구를 같이 쓸 때 정해 둘 네 가지
- 규칙 파일 하나: AGENTS.md를 기준으로 삼고, 도구별 규칙 파일은 그 파일을 가리키게 합니다.
- 끝낼 때의 보고 형식: 무엇을, 어느 저장소에서, 어느 커밋으로 바꿨는지를 같은 틀로 남깁니다.
- 누가 했는지 남기기: 커밋 꼬리말이나 알림 채널처럼 도구를 구분할 표시를 처음부터 정합니다.
- 같은 파일을 동시에 건드리지 않기: 한 저장소에서 두 도구가 동시에 일하게 하지 않는 것이 가장 단순한 방법입니다. 저희 기록에는 이 문제의 사례가 따로 남아 있지 않아, 지금은 원칙으로만 적어 둡니다.
마무리와 다음 편
두 도구를 함께 쓰는 일의 핵심은 도구를 고르는 것보다 규칙과 기록을 한곳에 모으는 것이었습니다. 저희는 규칙 파일은 하나로 맞췄지만, 메모리에 갇힌 규칙과 구분 표시가 없는 커밋은 아직 숙제로 남아 있습니다.
다음 편에서는 AI가 틀렸던 순간들과, 그것을 규칙으로 막은 방법을 적겠습니다.
