팀 도입

팀에서 Codex를 도입한다는 말은 “모두가 AI를 쓰게 한다”가 아닙니다. 같은 저장소에서 같은 승인선, 같은 리뷰 증거, 같은 handoff 규칙을 쓰게 만드는 것입니다.

이 문서를 읽으면

팀 저장소 하나를 골라 “Codex가 만든 PR은 어떤 증거를 포함해야 하는가?”를 5줄로 정리하세요. 그 기준이 없으면 도입은 개인 요령으로 흩어집니다.

영역	정해야 할 것
작업 규칙	팀 공용 `AGENTS.md`, 금지 파일, 실행 명령
리뷰 규칙	PR 설명, 위험 표시, 테스트 증거
보안	secrets, network, production access, audit trail
온보딩	첫 패치, 첫 리뷰, 첫 클라우드 작업
지표	생성량보다 재작업률, 검증률, 리뷰 품질

Codex가 만든 PR도 사람이 만든 PR처럼 검토되어야 합니다. 템플릿은 길 필요가 없지만, 리뷰어가 위험을 바로 볼 수 있어야 합니다.

목표:
변경 범위:
Codex가 사용한 실행 표면:
수정하지 않은 범위:
검증 명령과 결과:
스크린샷 또는 CI 링크:
승인 필요했던 작업:
남은 위험:
handoff:

이 템플릿의 핵심은 “AI가 했다”가 아니라 어떤 증거로 믿을 수 있는가입니다. 자동 리뷰나 GitHub Action을 붙여도 이 최소 증거는 사람이 읽을 수 있어야 합니다.

팀에서 반드시 지켜야 하는 규칙은 AGENTS.md, PR 템플릿, 보안 문서처럼 저장소나 조직 문서에 남깁니다. Memories와 Chronicle은 개인의 반복 맥락을 줄이는 보조층일 뿐, 팀 규칙의 유일한 저장소가 되면 안 됩니다.

항목	팀 기준
`AGENTS.md`	명령어, 금지 행동, 리뷰 증거, 승인 필요한 작업을 저장소에 고정
Memories	개인 선호, 반복 워크플로, 자주 나오는 함정을 보조 기억으로 사용
Chronicle	화면 맥락을 기억으로 만들 수 있으므로 민감 화면, 회의, 사내 자료 앞에서는 일시 중지 기준을 둠
remote connection	연결된 host의 파일, 로그인, plugin, MCP, browser 권한이 실제 실행 권한임을 문서화
auto-review	승인 요청을 자동 검토할 때도 sandbox 안 작업과 승인 필요 작업을 구분하고, 거절/타임아웃 처리 기준을 남김

Codex 도입 초기에 가장 빨리 무너지는 지점은 “지난번에는 확인했는데 이번에는 빠진” 검증입니다. 반복되는 검증은 문장으로 기억하지 말고 저장소 안의 실행 가능한 기준으로 옮깁니다.

반복되는 위험	팀 기준으로 바꾸는 방법
모바일에서 문서 레이아웃이 자주 깨짐	빌드 후 대표 페이지를 모바일 폭으로 확인하고, 스크린샷 이름을 PR 템플릿에 남김
redirect나 내부 링크가 자주 틀어짐	`check:redirects`, `check:links`처럼 실패하는 스크립트로 고정
AI 기능 품질이 주관적으로 리뷰됨	작은 eval 샘플과 통과 기준을 만들고, 실패 요약을 PR에 붙임
승인선이 리뷰마다 달라짐	PR 템플릿에 “승인 필요했던 작업”과 “승인하지 않은 작업”을 분리
handoff가 사람마다 다름	완료 보고 형식을 목표, 변경, 검증, 남은 위험 네 줄로 고정

팀 리드는 모든 것을 자동화하려고 하기보다 “다음 PR에서도 같은 방식으로 확인되는가”를 봐야 합니다. 반복 위험은 문서, 스크립트, eval, CI 중 하나로 남아야 합니다.

팀 도입은 문서만 읽어서는 잘 굳지 않습니다. 실제 저장소에서 작업 패킷을 만들고, Codex가 만든 diff를 읽고, 리뷰 메모와 handoff를 남겨봐야 팀 기준이 됩니다.