규칙은 프롬프트가 아니라 장치로, 에이전트에 일을 맡기는 팀의 공통점
에이전트의 반복 실수를 훅, 린트, 승인 절차로 막은 국내 팀 기록
더블테이크 노아 - 4분 분량 - 처음 쓴 날
AI 에이전트에 일을 맡기는 법
AI 에이전트에 일을 맡겨 온 국내 팀들은 같은 실수를 프롬프트로 고치지 않았다. 지켜야 할 규칙은 훅, 린트, 규칙 재주입 같은 장치로 강제했다. 되돌리기 어려운 행동은 사람 승인으로 남겼고, 잘 된 설정은 개인이 아니라 팀이 같이 쓰게 했다.
프롬프트로 고치면 왜 다시 틀리나?
에이전트는 일을 시킨 범위만 본다. 토스뱅크 ML Engineer 김경윤 님은 이렇게 적었다. "에이전트는 전반적인 코드 맥락을 보지 않습니다. 수정이 필요한 일부 맥락만 파악하고, 그 안에서만 코드를 작성하다 보니, 큰 틀의 규칙을 잘 지키지 못하는 문제가 발생합니다."[1] 프롬프트에 규칙을 한 줄 더 넣어도 작업이 길어지면 묻힌다.
카카오페이 기술블로그의 한 글은 에이전트가 실수하면 프롬프트를 고치지 않고 그 실수가 구조적으로 불가능하게 만든다고 했다. "지켜야 하는 규칙은 프롬프트가 아니라 Hook으로 강제하는 편이 낫습니다."[2]
팀들은 어떤 장치를 썼나?
토스뱅크 김경윤
- 막으려던 실수
- 큰 틀의 팀 규칙을 놓친다
- 장치
- Stylepack. 파일 작성 직후 규칙 최대 2개, 완료 전 변경 내역에 규칙 최대 4개를 다시 넣는다 [1]
카카오페이
- 막으려던 실수
- 같은 실수가 반복된다
- 장치
- Hook으로 강제 [2]
우아한형제들 박재용
- 막으려던 실수
- 번역 누락. 사람 리뷰도 AI 리뷰도 놓쳤다
- 장치
- ESLint 플러그인을 직접 만들어 운영 배포 전에 번역 누락 182개와 오역 5개를 고쳤다 [3]
우아한형제들 이형준
- 막으려던 실수
- 화면 코드의 역할 경계를 넘는다
- 장치
- 뷰, 폼, 스토어 경계는 린트가 보고, 명세, 테스트, 구현은 단계마다 사람이 승인 [4]
| 팀 | 막으려던 실수 | 장치 |
|---|---|---|
| 토스뱅크 김경윤 | 큰 틀의 팀 규칙을 놓친다 | Stylepack. 파일 작성 직후 규칙 최대 2개, 완료 전 변경 내역에 규칙 최대 4개를 다시 넣는다 [1] |
| 카카오페이 | 같은 실수가 반복된다 | Hook으로 강제 [2] |
| 우아한형제들 박재용 | 번역 누락. 사람 리뷰도 AI 리뷰도 놓쳤다 | ESLint 플러그인을 직접 만들어 운영 배포 전에 번역 누락 182개와 오역 5개를 고쳤다 [3] |
| 우아한형제들 이형준 | 화면 코드의 역할 경계를 넘는다 | 뷰, 폼, 스토어 경계는 린트가 보고, 명세, 테스트, 구현은 단계마다 사람이 승인 [4] |
박재용 님은 복잡한 컨벤션을 강제하려면 확률론적인 AI보다 "결정론적인 정적 분석 도구인 린트" 가 낫다고 봤다. 그는 "AI는 요술램프가 아닙니다." 라고도 썼다[3]. 찾는 일은 매번 같은 결과를 내는 도구에 맡기고, AI는 고치는 쪽에 쓴다.
사람 승인은 어디에 남기나?
LINE Plus Home SRE 팀은 장애 알림을 묶고 원인 가설을 검증하는 분석과 담당팀 알림, 에스컬레이션을 AI로 자동화했다. 초기 알림 노이즈의 85~95%를 실시간으로 걸러 냈고 평균 장애 식별 시간(MTTR)은 50% 줄었다. 그래도 파드 재시작, 롤백, 스케일 조정은 사람이 승인한다. 가설을 모두 확인하지 못하면 원인을 "other(원인 미특정)" 로 낮추는 장치도 뒀다[5].
비개발자 사례도 있다. 당근 피플팀의 한 인턴은 회의실 노쇼 문제를 풀려고 Claude와 대화하며 회의봇을 만들었다. 출시 뒤 개인 캘린더 정보가 전사 브리핑에 섞여 나가는 사고가 났고, 토큰을 분리하고 권한 범위를 제한한 뒤 변경할 때마다 테스트 계정으로 먼저 확인하는 절차를 더했다[6]. 돌아가는 것과 안전한 것은 따로 확인해야 했다.
잘 된 설정은 누가 갖나?
우아한형제들 조현석 님 팀은 팀원마다 프롬프트와 스킬이 흩어져 무엇이 최신인지 모르게 되자 MCP stdio로 중앙 패키지를 만들었다. 개인이 만든 자산은 팀 회의에서 제안해 채택한다[7]. 이재홍 님 팀도 Cursor Rules와 Skills로 팀 규칙을 박아 뒀다[8]. Tech-Verse 참관기는 이를 "공통화는 천장이 아니라 바닥을 만드는 일" 이라고 표현했다[9].
내 팀에서는 무엇부터 하나?
아래는 위 기록에서 뽑은 우리 제안이다.
- 1에이전트가 두 번 이상 반복한 실수를 하나 고른다
- 2그 실수를 프롬프트 대신 검사 도구, 훅, 체크리스트 중 하나로 막는다
- 3되돌리기 어려운 행동 (배포, 삭제, 외부 발송) 은 사람 승인 단계를 둔다
- 4잘 된 설정은 팀 저장소에 올린다
AI 결과를 그냥 믿지 않고 확인하는 감각, 4분 테스트로 먼저 재 보자
4분 테스트 하기자주 묻는 질문
- 개발자가 아니어도 에이전트를 업무에 쓸 수 있나?
- 당근 인턴 사례처럼 이미 쓰고 있다. 다만 그 사례의 첫 사고는 권한과 데이터에서 났다. 만들기 전에 무엇을 읽고 어디로 보내는지부터 정한다.
- 장치를 만들 여유가 없는 작은 팀은?
- 가장 자주 반복된 실수 하나만 막아도 된다. 박재용 님도 번역 누락이라는 문제 하나를 잡으려고 플러그인을 만들었다.
- 에이전트에게 롤백까지 맡겨도 되나?
- 공개된 국내 기록에서는 맡기지 않았다. LINE Plus SRE 팀은 1차 분석까지 자동으로 하고 롤백은 사람 승인으로 남겼다.
출처
- 1AI가 팀 규칙을 지키도록 하는 방법 토스 기술블로그, 2026.09.08
- 2AI Agent, 넌 누구냐 1 - Tool, MCP, Skill, Harness는 무엇인가 카카오페이 기술블로그, 2026.09.01
- 3사람도 AI도 놓친 번역 누락, ESLint 플러그인을 만들어 해결하기 우아한형제들 기술블로그, 2026.06.23
- 4배달의민족 전자계약서 화면 개편기: AI에게 맡긴 것과 사람이 챙긴 것 우아한형제들 기술블로그, 2026.09.18
- 5장애 Alert의 원인을 스스로 찾다: SRE Observer 개발기 LY Tech Blog
- 6비개발자로 회의봇 만들기는 처음이라 당근 채용 블로그, 2026.04.30
- 7흩어져 있는 AI 자산, 'MCP stdio'로 헤쳐모여! 우아한형제들 기술블로그, 2026.03.17
- 8하네스 엔지니어링(harness engineering)으로 팀 맞춤형 AI 환경 구축하기 우아한형제들 기술블로그, 2026.04.17
- 9AI를 전제로 다시 설계하다, Tech-Verse 2026 참관기 LY Tech Blog

