토스뱅크, Coding Agent의 팀 규칙 위반 해결 위해 'Stylepack' 피드백 루프 도입

토스뱅크 ML Engineer 김경윤은 Coding Agent가 팀의 코드 컨벤션을 준수하도록 돕는 플러그인 Stylepack을 공개했다. 기존 방식은 AGENTS.md 등 Global Instruction을 통해 규칙을 주입했으나, 긴 대화에서 초기 규칙이 무시되는 'Lost in the Middle' 현상으로 인해 세션 후반부에는 규칙 위반이 빈번했다.

Agent Loop에 Feedback Loop 추가

Stylepack은 Hook을 활용해 Linter처럼 즉각적인 피드백을 제공한다. 파일 작성 직후 실행되는 Hook은 정규식과 파일명 패턴으로 관련 규칙을 선별해 에이전트에 주입한다. AI 호출을 배제해 지연을 최소화했으며, 한 번에 최대 2개 규칙만 주입해 Context 오염을 방지한다.

다중 파일 의존성 문제 해결

단일 파일 검사로는 파악하기 어려운 다중 파일 간 의존성 위반(예: 인터페이스 대신 구현체 참조)을 잡기 위해 Agent Loop 종료 시점에 git diff 전체를 재검사하는 두 번째 Hook을 도입했다. 이 최종 안전망은 변경된 파일 전체를 한 덩어리로 인식해 위반 사항을 지적하고 수정하게 한다.

규칙 관리 및 확장

Stylepack은 중앙 저장소에서 최신 규칙을 동기화하여 템플릿 노화 문제를 해결한다. 규칙은 코드 모양으로 즉시 판정 가능한 'Rule'과 실행 시점 문제가 드러나는 'Context'로 분리 관리한다. 또한 PR 리뷰에서 반복되는 지적을 규칙으로 승격시키는 프로세스를 통해 False Positive를 줄이고 팀 컨벤션을 체계화한다.