AI는 덧대기만 합니다 — 코드 9.5만 줄, 다 갈아엎는 중
2026.10.07

소개

카톡으로 들어오는 체험단 문의, 혼자 다 받다 보면 하루가 그냥 사라집니다.
그래서 AI한테 맡겼습니다. 6월 1일부터요.
맥 카카오톡으로 오는 1:1 문의에는 AI '선원'이 대답하고, 일정이랑 상태는 구글 시트에 적고, 정말 사고 나면 안 되는 것(엉뚱한 사람한테 보내기 같은 거)만 코드가 막아 주는 시스템입니다.
처음엔 신났습니다. 이제 딸깍이면 다 해 줄 줄 알았거든요.
...인 줄 알았는데!!!
4개월 뒤에 한번 세어 봤습니다.
커밋(저장 기록) 806번
운영 코드 95,264줄
테스트 코드 110,538줄 ??? 테스트가 코드보다 더 많아요
문서 260개 (글자로 치면 약 197만 자)
그리고 파일 딱 하나가 22,882줄

파일 하나가 보통 300줄만 넘어도 읽기 힘든데, 이건 그 76배입니다. 어... 이게 맞나? 싶었어요.
그런데 진짜 문제는 따로 있었습니다. 사고가 줄지 않았어요.
작업 일지를 6월 / 7~8월 / 9~10월로 나눠서, 비슷한 사고끼리 묶어 봤습니다. (일지에 적힌 횟수라서 같은 사고가 겹쳐 셌을 수도 있어요.)
환경이 달라서 조용히 멈추고, 고쳤더니 또 멈춤: 6월 8건 → 9~10월 16건
오류 하나가 전체 정지로 번짐: 6월 1건 → 9~10월 9건
실제론 안 되는데 '정상입니다'라고 보고함: 7~8월 3건 → 9~10월 8건


더 소름이었던 건 이겁니다.
한 사고를 막으려고 만든 대책이 다음 사고의 원인이 된 경우가, 확인된 것만 2건이었어요. (봇이 새로 만들어 버린 시트 칸, 키워드로 땜질한 코드)
고칠수록 사고가 줄어든 게 아니라, 모양만 바뀌고 있었던 겁니다.
그래서 이번에는 목표를 바꿨습니다.
고쳐서 계속 쓰기 ❌
통째로 다시 짜기 ⭕
그리고 다시 짜는 동안 AI가 또 덧대지 못하게, 이번엔 AI한테 고삐(하네스) 부터 씌우기로 했습니다. 이 글은 완성기가 아니라 1/3 지점 중간보고예요. 결말은... To be continued!
진행 방법
사용한 도구: Claude Code(만들기), Codex(검사하기), OpenClaw 선원 AI(카톡 응대), 맥 카카오톡, 구글 시트(업무 사실의 원본), SQLite(재시작해도 안 잊게 적어 두는 장부), git 훅(저장할 때 검사하는 장치). 이미지는 ChatGPT 이미지 생성이랑 Nano Banana 2로 만들었어요.
① 첫 번째 깨달음: AI는 고칠 때 '더하는' 쪽으로 기운다
"이거 고쳐줘" 하면 AI는 지우는 것보다 더하는 게 훨씬 쉽습니다. 새 규칙, 새 예외, 새 시트 칸, 새 테스트.
한 번 한 번은 다 말이 되거든요. 그런데 4개월 쌓이니까 22,882줄짜리 괴물이 됐습니다.
처음엔 "내가 지시를 잘못했나?" 했는데, 아니었어요. 이건 AI의 기본 버릇이었습니다. 그러면 "300줄 넘기지 마"라고 부탁하면 될까요? 아니요. 부탁은 잊어버릴 수 있으니까요.

이걸 눌러 볼 수 있게 만들어 봤습니다(발표용 시뮬레이터). '고쳐줘'를 누를 때마다 줄이 늘고, '4개월 뒤'를 누르면 진짜처럼 22,882줄이 돼요. 아무도 안 막으니까요.

② 결정: 안 고친다. 그냥 다시 짠다
재구축을 시작하면서 AI한테 이렇게 말했습니다. (요지예요)
리팩토링은 기존 방법이 문제가 많아서 하는 거다. 제대로 작동했다고 가정하지 않는다.
원칙·규칙·목표만 가져가서 완전히 뜯어고친다. 옛날 방식을 또 만드는 게 아니라,
프로그램으로 꽁꽁 막혀 있던 자리에 AI가 판단하고 일할 수 있게 날개를 준다.
실행 안전이 2만 줄일 리 없다. 정말 안 되는 것만 막고, 프로그램이 해야 하는 것만 한다.
사람도 보냈는지 잊으면 채팅창을 다시 열어 본다. 기록이랑 실시간 확인만 잘해도 된다.
시트는 확실한 결과물, 카톡은 유연한 대화. 가드레일은 최소로, 에이전트가 배우면서 진화하게 한다.가져가는 건 딱 두 개입니다.
사고 기록에서 뽑은 안전 원칙 18개 (원칙마다 "이게 어떤 사고를 막는지"를 붙였어요)
업무 목표와 규칙
옛날 동작은 하나도 안 가져갑니다. 안 가져가는 게 제일 어려웠어요. 아깝거든요 ㅠㅠ

③ 새 시스템은 이렇게 생겼습니다
문서 맨 앞에 딱 열 줄만 적었습니다.
하는 일 5개: 답한다 / 먼저 말 건다 / 시트에 적는다(적고 나서 다시 읽어 확인한 뒤에만 "적었다"고 말함) / 사람에게 넘긴다 / 배운다
코드가 막을 일 5개: 엉뚱한 방에 말하기 / 두 번 보내기 / 남이 쓴 시트 칸 덮어쓰기 / 개인정보 새기 / 승인 없이 되돌리기 어려운 일 하기
딱 이것만 막고, 나머지(말의 뜻, 지금이 어느 단계인지, 문장)는 전부 AI가 정합니다.

카톡이 하나 오면 이렇게 돌아갑니다. 문 앞에서 한 번, 문을 나가기 전에 한 번, 총 두 번 검사하는 거예요.
코드가 먼저 확인: 허락된 1:1 방 맞아? 기록이 최신이야? 이미 보냈어?
AI 선원이 대답을 정함: 답한다 / 되묻는다 / 사람에게 넘긴다 / 무시한다
코드가 또 확인: 이 일을 해도 되는 등급이야? 시트 칸 맞아? 다른 회사 AI가 봐도 괜찮대?
그제야 시트에 적고, 다시 읽어 보고, 보낸다


④ 실제 화면은 이렇게 생겼습니다
맥 카카오톡 채팅 목록이에요. 체험단 멤버와의 1:1 방이 이렇게 쌓이고, 방마다 시트의 행과 연결돼서 AI 선원이 방별로 대답합니다. 이름은 모자이크했고(프로필 사진은 작아서 그대로), 병원 이름이나 링크 같은 민감한 건 살짝 가렸어요.

그리고 방 하나를 열어 보면 이런 대화가 이어집니다. 노란 말풍선이 우리 쪽, 흰 말풍선이 체험자예요.

체험자가 예약했다고 알려 줌 → "6/24 체험했고 블로그 작성도 완료했어요" 하고 블로그 링크를 보냄
우리 쪽이 "6월 24일 방문과 블로그 작성 완료 확인했습니다. 네이버 영수증 리뷰와 구글지도 리뷰도 완료하셨는지 링크나 캡처 보내주시면 확인 진행하겠습니다"라고 다음 할 일을 안내
체험자가 후기 사진 2장을 보냄 → 우리 쪽이 "사진 2장 확인했습니다" 하고, 아직 남은 리뷰(영수증·구글지도)를 한 번 더 요청
누가 뭘 확인했고, 다음에 뭘 해 달라는지가 한 방 안에서 자연스럽게 이어지는 게 보이시나요? 이게 제가 만들고 싶은 응대의 모습입니다. (링크 미리보기의 얼굴 사진과 후기 사진은 알아볼 수 없게 흐리게 처리했어요.)
⑤ 하네스: '부탁'이랑 '차단'은 완전히 다릅니다
이번 스터디 OT에서 센서가 두 종류라고 배웠는데, 제 말로 바꾸면 이래요.
부탁형 (추론적 센서): AI가 읽고 알아서 지켜 주길 바라는 규칙. 예) CLAUDE.md
차단형 (연산적 센서): 프로그램이 직접 확인하고, 어기면 그냥 막아 버리는 장치. 예) 저장할 때 검사하는 훅, 테스트


CLAUDE.md에는 이렇게 적어 놨습니다. 여기까지는 부탁이에요.
## 8. 분량 규율
AI는 고칠 때 덧대는 쪽으로 기운다. 예산은 config/size_budget.json이 정본이고 pre-commit이 강제한다.
- 코드 파일은 300줄 이하다(구 파일은 지금보다 늘리지 않음).
- 예산 상향은 사용자 승인 뒤 SIZE_BUDGET_APPROVED=1로만 커밋한다.그리고 이 부탁을 차단으로 바꿔 주는 예산 파일이에요. 이 숫자를 넘기면 저장(커밋) 자체가 안 됩니다.
{
"docs": {
"CLAUDE.md": { "max_lines": 200, "max_chars": 6500 },
"docs/dev/rebuild/spec.md": { "max_chars": 20000 }
},
"code": { "max_lines": 300 },
"packages": { "src/nk/": { "max_lines": 10000 } }
}
오늘도 문서에 한 줄 추가했더니, 고치자마자 훅이 이렇게 말을 걸어 줬습니다.
분량 예산: CLAUDE.md 6,048/6,500자 (+124). 규칙을 더하기 전에 합치거나 뺀다.
아까 그 시뮬레이터에서 하네스를 켜 보면? 300줄을 넘기려는 순간 "커밋 차단!" 입니다. 예산을 늘리려면 제가 직접 승인해야 하고, AI는 혼자 못 올려요.

⑥ 설계 문서도 AI는 부풀립니다 (두 번째 충격)
설계를 7단계로 나눠서 이틀 만에 끝냈는데, 문서를 다 합치니 약 14만 자였습니다.
...??? 설계가 이렇게 길 리가 없는데요?
그래서 하나로 합쳐서 약 1.8만 자로 줄였고, 정해야 할 항목도 51개 → 10개로 줄였습니다. 나머지는 '근거 부록'으로 빼고, 다 쓴 설계 문서는 더 늘지 못하게 얼려 버렸어요.

⑦ 한 AI가 쓰면, 다른 AI가 검사합니다
단계마다 다른 AI한테 검사를 시켰어요. 지적이 줄어들 때까지요.
시트 설계: 지적 20건 → 반영 후 통과
기록 설계: 36건 → 16건 → 10건 (세 번 돌림)
마지막엔 Codex가 새로 감사: 큰 것 1건, 중간 5건, 작은 것 1건 → 6건 반영, 1건은 감수하기로

⑧ 옛 시스템은 멈추고, 새 코드는 텅 빈 채로 시작
새로 만드는 동안 옛 시스템은 동시에 돌리지 않고 정지했습니다. 10월 7일 00:35:15, "완전히 멈췄다"를 증명한 그 시각이 새 시스템의 출발선이에요.
그리고 새 코드는 합쳐서 1만 줄까지만 쓸 수 있습니다(옛날 9.5만 줄의 약 1/10). 옛 코드를 가져다 쓰는 것도 테스트로 막아 놨어요. 테스트 먼저, 구현은 그다음!
지금 이 순간에도 AI가 열심히 작업 중입니다. 아래는 이 글을 쓰던 저녁의 실제 커밋 로그예요. 하나 끝날 때마다 '테스트 → 검사 → 반영 → 합치기'가 반복됩니다.

결과와 배운 점
지금까지 (10/7 20시 기준)
설계 7단계 끝, 옛 시스템 퇴역 끝
구현은 AI가 지금도 작업 중! 이 글 쓰는 동안에도 뼈대랑 기록 부분이 합쳐졌어요
새 코드 1,482줄 / 예산 10,000줄, 테스트 99개 (쓰는 지금도 숫자가 바뀌고 있습니다)

배운 점 5가지
"하지 마"는 부탁이고, 훅은 차단입니다. 문서에 적어 두는 것과 진짜로 막히는 건 완전히 달라요.
하네스는 코드에만 필요한 게 아니었어요. 설계 문서가 14만 자가 된 것도 똑같은 현상이라 똑같은 장치로 막았어요.
남길 건 '동작'이 아니라 '일어나면 안 되는 결과'입니다. 구현 방식 말고 결과만 남기니까 정본이 확 짧아졌어요.
"정상"이라는 말도 정의해야 합니다. 프로그램이 켜져 있다고 정상이 아니에요. 문의·후속 관리·장부·외부 연결 네 가지가 다 새 증거로 확인될 때만 '정상'이라고 보고하게 했어요.
문서 연결도 하네스 대상이었습니다. 이건 아래에서 얘기할게요 😅
세 번째 충격: 오늘 저녁에 진짜로 터진 일
이 글을 쓰려고 AI한테 "구현 얼마나 남았어?" 하고 물었습니다.
AI 대답: "아직 시작 전입니다."
??? 어??? 지금 다른 창에서 열심히 만들고 있는데요?!
알고 보니 구현 계획 문서를 새 폴더로 옮기면서, 새 AI가 제일 먼저 읽는 CLAUDE.md 목록에 그 폴더를 안 넣은 거였습니다. AI는 자기가 본 문서만 믿으니까, 이미 시작한 일을 "시작 전"이라고 한 거죠. (그 사이 다른 세션은 진짜로 구현 중이었고요.)
바로 목록에 추가했고, "새 폴더를 만들면 목록에도 넣는다"를 체크리스트에 적었습니다. 근데 이건 아직 부탁일 뿐이에요. 자동으로 막는 장치는 없습니다. 다음 숙제예요.

아쉬운 점
설계 문서를 14만 자까지 키운 건 제 실수예요. 분량 예산을 설계 시작할 때부터 걸었어야 했어요.
하네스는 아직 우회할 수 있어요(
--no-verify). 지금은 "우회하지 않는다"는 규칙(부탁!)으로만 막고 있습니다.
앞으로의 계획 — To be continued ⛵
3주차 목표는 프로젝트 전체 완료입니다. 저는 이 프로젝트를 일주일 이상 끌고 갈 생각이 없어요.
남은 것: 구현 나머지 단계, 실제 환경에서 확인해야 하는 실험 7개, 그다음 평가 → 발송 권한을 아예 뺀 '그림자 운영' → 전환 → 먼저 연락 보내기 시작 → 완료 판정.
다만 "그림자 운영 5일 이상, 완료 판정 7일" 같은 지켜보는 기간은 코딩이 빨리 끝나도 줄이지 않기로 해서 일정이 빠듯합니다. 일주일 안에 어디까지 갈 수 있을지, 다음 글에서 이어서 보고할게요!

도움 받은 글
24기 CTO OT 강의자료 — 추론적 센서 / 연산적 센서 구분
완료라고 쓰기 전에 검사하기: 연재 상태 JSON에 9개 테스트를 붙였습니다 (완료 보고 전 검사)
AI 검수 하네스 활용법: 카카오톡 검수기 개선까지 (로미오님 발표 듣고)




차단과 진짜로 막히는 것은 다른 것이군요. 인사이트 얻어갑니다.
네넵 저도 그 부분을 실전 적용을 처음 해보았습니다! 그동안 훅이 헛발질 하는거때문에 꺼놨었거든요