AI가 팀 규칙을 지키도록 하는 방법 - 김경윤

토스뱅크가 코딩 에이전트에 팀 규칙을 전달하는 시점과 운영 방식을 바꾼 사례다. 원문.

규칙을 꺼내는 시점과 갱신

저자는 긴 세션에서 초기 지침이 덜 지켜지는 현상을 관찰하고, 규칙을 작업 도중 다시 전달하는 Stylepack을 만들었다. 파일 작성 직후에는 파일명·정규식으로 관련 규칙을 골라 알리고, 종료 직전에는 전체 변경을 대상으로 재검토를 요청한다. 종료 알림은 실패 판정이 아니며 적용 여부는 에이전트가 판단한다.

발동 조건과 전달 문장을 같은 규칙 파일에 두고, 세션 시작에는 언어별 공통 맥락을 제공한다. 복제된 템플릿의 갱신 누락을 줄이려고 중앙 저장소에서 규칙을 가져오며, 발동 로그와 반복 리뷰 지적으로 오탐·누락과 규칙을 수정한다.

사례를 재사용할 때

파일 작성 후 최대 2개·같은 규칙은 세션당 한 번, 종료 시 최대 4개라는 수치는 이 팀의 선택이다. 단일 파일 관찰은 파일 간 의존을 놓쳤고, 정규식은 포맷 문자열을 오탐하거나 다른 반복문 형태를 놓쳤다. 저자는 N+1 안내를 상시 맥락으로 옮겼다.

긴 맥락에 대한 저자의 설명은 이 사례의 원인 해석으로 남긴다. N+1 대응이나 개별 코딩 관례를 보편 규칙으로 채택하지 않으며, 중앙 갱신의 성공·최신성도 별도 확인 대상이다.

연결

• 두 글을 대조한 주장: 규칙을 다시 전달하는 것과 위반을 판정하는 것은 다르다
• 문서의 위치·전달 시점·적용 판단: 에이전트 문서 작성