문서
AI가 팀 규칙을 지키도록 하는 방법
김경윤 토스 · 토스 기술 블로그
AI 핵심 요약
Coding Agent가 세션 초반의 AGENTS.md 지침을 긴 작업 중 놓치고, 세세한 팀 컨벤션도 일관되게 따르지 못하는 문제를 해결하기 위해 Stylepack을 만들었습니다. 파일 작성 직후에는 정규식과 파일 패턴으로 관련 규칙을 골라 최대 2개까지 주입하고, 작업을 마치기 전에는 전체 git diff를 검토해 여러 파일에 걸친 설계 문제를 확인합니다. 규칙은 레포 환경에 맞춰 중앙 저장소에서 갱신하며, 적용 기록과 반복되는 PR 리뷰 코멘트를 바탕으로 오탐·누락을 개선합니다. 코드 모양으로 판별할 수 있는 규칙은 Hook으로, 실행돼야 드러나는 문제는 상시 Context로 다루는 것이 핵심입니다.
- 세션 시작 지침만으로는 긴 작업 중 규칙이 묻힐 수 있으므로, 코드 작성 직후에도 관련 피드백을 주입하세요.
- Hook은 매번 실행되므로 AI 호출 대신 파일 패턴과 정규식으로 후보 규칙을 빠르게 좁히고, 최종 판단은 에이전트에 맡기세요.
- 파일 단위 검사로 잡기 어려운 설계 문제는 작업 종료 직전에 전체 git diff를 검토하는 별도 단계로 보완하세요.
- 오탐이 잦은 규칙은 조건을 다듬고, 코드 모양만으로 판별하기 어려운 런타임 문제는 상시 Context로 안내하세요.
- 반복되는 PR 리뷰 지적을 규칙으로 만들고 적용 기록을 살펴야 규칙의 유효성을 개선할 수 있습니다.
소개
Coding Agent를 위한 Stylepack
