본문으로 건너뛰기

영문 분기보고서 Draft를 엑셀 검토표로 바꿔 주는 'SmartReviewer'를 클로드 코드로 만든 과정

소개

시도하고자 했던 것과 그 이유

- 해외 사업자 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 등 다른 보고서 유형에서도 검증하고,소개]

함께 이야기해요 0

로그인하고 댓글을 남겨 주세요

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기