영문 분기보고서 Draft를 엑셀 검토표로 바꿔 주는 'SmartReviewer'를 클로드 코드로 만든 과정
2026.10.06
소개
시도하고자 했던 것과 그 이유
- 해외 사업자 10-Q/10-K 영문보고서의 PwC Draft(docx)를 국문 SmartReviewer와 같은 형식의 엑셀 검토표(시트별 분리)로 자동 변환하는 도구를 만들고자 함
- Draft가 새로 올 때마다 직전 Draft와 무엇이 바뀌었는지 비교하는 작업도 자동화하고자 함
- [영문보고서는 국문 보고서처럼 쓸 수 있는 검토 도구가 없어서, Draft마다 시트 35~50개를 손으로 옮기고 대조하는 부담이 컸음 ← 실제 이유로 고쳐 주세요]
- 회사 PC에서 설치 없이 바로 쓸 수 있도록 인터넷 연결 없이 열리는 HTML 파일 하나로 만드는 것을 목표로 함
진행 방법
사용한 도구
- Claude Code: 요구사항 정리, 설계, 코드 작 사용함
사용한 도구
- Claude Code: 요구사항 정리, 설계, 코드 작 사용함
- gatekit 플러그인: 클로드 코드가 아무렇게나 "다 됐다"고 하지 못하도록 단계와 완료 기준(게이트)을 강제하는 데 사용함
- Node.js / npm: npm run build로 결과물을 HTer.html)로 묶음
- Git: 기준점과 개선안을 커밋 단위로 나눠서 하나씩 반영하거나 되돌릴 수 있게 관리함
- Excel: 변환 결과를 실제 Excel에서 열어 수식과 서식이 제대로 동작하는지 확인함
1️⃣ 기획: 무엇을 만들지 정리 (gatekit interview)
- 클로드와 인터뷰하듯 대화하며 화면 구성, 화리해 PRD와 아키텍처 문서를 만듦
- 확정한 기능은 다음과 같음
- 회사·보고서 만들기
- Draft 올리기
- 엑셀 변환
- Draft 간 비교
- 다운로드
- 한국어·영어 화면 전환
▎ 사용한 프롬프트: [전문 붙여 넣기]
2️⃣ 작업 분해와 완료 기준 정하기 (gatekit tasks / gate)
- 기획 문서를 작업 단위로 쪼갰고, 작업마다 통과해야 할 테스트를 붙임
- 작업이 끝났는지 판단하는 완료 기준 6개를 정하고 승인함. 승인하기 전에는 빌드를 시작할 수 없도록 잠가 둠
3️⃣ 구현과 검증 (gatekit build / verify)
- 클로드가 작업을 하나씩 구현했고, 작업마다 로 넘어가게 함
- 마지막에는 코드를 짠 세션이 아닌 별도의 검증 에이전트가 완료 기준을 다시 돌려 6/6 통과를 확인함
4️⃣ 자는 동안 편의성 개선안 받기
- 자기 전에 "편의성 개선안을 만들어 두라"고 요청함
▎ 사용한 프롬프트: [전문 붙여 넣기]
- 아침에 확인해 보니 개선안 8개가 각각 별도 커밋과 별도 테스트로 만들어져 있었고, 검토 목록 문서도 함께 정리되어 있었음
┌─────┬─────────────────────────────────────────────────────────────────────────────┐
│ # │ 개선안 │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 1 │ "최신 두 개 비교" 버튼 │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 2 │ 여러 Draft를 한꺼번에 올리면 Draft 번호 순서로 추가 │
├─────┼────────────────────────────────────────────────┤
│ 3 │ 보고서 화면 어디에 끌어놓아도 Draft 올리기 │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 4 │ 결과 창을 Esc로 닫기 │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 5 │ 엑셀 총괄표에 검토 진행 표시 (Status 칸 색, "검토 완료 n / 전체" 자동 집계) │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 6 │ 인쇄 설정 (A4 가로, 너비 한 장, 쪽 번호) │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 7 │ 차이 목록에 시트별 차이 건수 요약 ( 동) │
├─────┼─────────────────────────────────────────────────────────────────────────────┤
│ 8 │ 빈 화면에 3단계 사용 방법 안내 │
└─────┴────────────────────────────────────────────────┘
- 테스트는 기존 55개에 개선안별 8개를 더해 총 63개로, 모두 통과함
📷 [캡처: 메인 화면, 변환된 엑셀 총괄표, 비교 엑셀 차이 목록, 개선안 검토 목록]
결과와 배운 점
결과
- Draft docx를 올리면 시트별 엑셀 검토표가 과도 엑셀로 내려받을 수 있게 됨
- 설치 없이 HTML 파일 하나만 열면 사용할 수 있음
- [실제로 줄어든 작업 시간이나 체감한 효과를 넣어 주세요]
배운 점과 꿀팁
- 완료 기준을 먼저 못 박아 두면 AI가 마음대로 "완료"라고 하지 못함. 테스트 통과만으로 끝내지 않고 별도 에이전트가 다시 검증하게 하니 믿을 수 있는 결과가 나옴
- AI에게 밤새 일을 맡길 때는 "하나씩 따로 커밋하고, 되돌리는 방법도 적어 두라"고 요청해야 함. 이렇게 해 두면 아침에 개선안별로 반영할지 지울지만 정하면 됨
- 기준점 커밋을 남겨 두면 개선 작업이 마음에 들지 않을 때 언제든 원래 상태로 돌아갈 수 있음
시행착오
- 한글 윈도우 인코딩 문제: 회사 PC의 기본 문자 코드(cp949) 때문에 Python으로 실행하는 gatekit 명령이 깨짐. PYTHONUTF8=1을 붙여 실행하는 방식으로 해결함
- 줄바꿈 문자(CRLF) 문제: 파일을 쓰는 방식에 그 때문에 개선안 1번은 git revert로 되돌리면 충돌이 나서, 지울 경우 손으로 되돌려야 하는 상태가 됨
- 차이가 너무 많이 나오는 문제: 서로 다른 분기의 Draft를 비교하면 차이가 1,000건을 넘어서 어디가 많이 바뀌었는지 보기 어려웠음. 이를 해결하려고 시트별 차이 건수 요약(개선안 7)을 추가함
- 실제 보고서 파일 보호: 실제 보고서와 테스 서 외부로 나가지 않도록 함
도움이 필요한 부분
- [예: 회사 보안 환경에서 HTML 도구를 팀원들에게 배포하고 업데이트하는 좋은 방법]
- [예: docx 표 구조가 Draft마다 조금씩 달라질 때 변환을 안정적으로 유지하는 방법]
앞으로의 계획
- 개선안 8개를 하나씩 직접 써 보고 반영할지 지울지 정한 뒤, 반영한 것은 기획 문서와 완료 기준에 정식으로 추가할 계획임
- [10-K 등 다른 보고서 유형에서도 검증하고,소개]


