소개 — 시도하고자 했던 것과 그 이유
리포트 자동화 시스템 (Data Insight Report Automation)
사업팀에 근무하며 B2B 대상 데이터 리포트를 만들 때 반복적으로 겪던 두 가지 병목이 있었음:
데이터가 바뀌면 처음부터: 중간에 수치가 수정되면 분석 결론, 인사이트 문구, 차트 순서까지 연쇄적으로 바뀌어야 하는데, Claude 에게 "3페이지 두 번째 단락 수 정해줘" 식으로 장표별로 하나씩 요청해야 했음
포맷 일관성 없음: 디자인 톤이나 리포트 구조를 한 번에 적용하는 게 안 됨
이걸 해결하려면 컨텍스트를 누적해서 흘려주는 파이프라인이 필요하다고 판단했고,
처음에는 1) 제안서, 2) 리포트(콜드메일 첨부, 타겟 광고, 홈페이지 게시) 두 가지를 모두 포함하려 했다가 조언을 받아 리포트 3종에 집중하기로 했음
진행 방법
사용 도구: Claude Code (claude-sonnet-4-6), Python + Streamlit, Anthropic API
핵심 설계 원칙: 내가 판단해야 하는 부분 vs. 자동화해도 되는 부분을 명확히 분리하고자 함
사용한 프롬프트 전문
Datatech 기업에서 데이터 인사이트 리포트 만드는 작업을 자동화하는 시스템을 만들려고 해.
고객사의 요청사항 또는 우리의 리포트 활용 목적에 따라 데이터를 분석하고, 그 결과를 리포트로 만드는 작업이야.
우리 회사에서는 이 업무를 처음 해봐서, 양식을 참고했으면 하는 문서와 내용 및 분석 구성을 참고하길 바라는 샘플을 전달할 거야. best 샘플 reference 파일을 주요 part별로 분리해서 각 part/chapter별로 각각 파일을 따로 만들고 pdf 문서로 변환해서 너에게 참고하도록 제공할 거야.
우리 회사에서 리포트를 작성하는 best workflow를 구축해보면
먼저 활용 목적에 따라 분기한다:
1. 콜드메일 발송 시 첨부 파일 (타겟 명확도 낮음)
2. 리멤버 타겟 광고 집행 시 도달 콘텐츠 (산업/직급 명확)
3. 홈페이지 내 인사이트 리포트 공지 (타겟 매우 랜덤)
그 다음 순차적으로 아래 작업을 진행한다:
1. 타겟 산업/기업 입력
2. 사내 논의 내용 입력 (영업팀 피드백, 미팅 노트)
3. 외부 Deep Research 수행 결과 제공: 자사 및 경쟁사 분석, 산업 분석, 벤치마킹 분석
4. 데이터 분석 범위 제시 (어떤 범위 내에서 데이터 분석을 할지 정의)
이 순서대로 작업이 순차적으로 이루어지면서 각 단계의 output들이 다음 단계의 작업에 누적으로 반영되고 연결되면서 최종 리포트가 만들어질 거야.
그 과정에서 회사 자료도 입력되고, 기존 reference 파일도 이 workflow에 따라서 각 단계별로 각각의 파일로 저장되어서 너에게 제공될 거야.
이러한 리포트를 작성하는 자동화 시스템을 어떠한 구조로 설계하고 구축하면 좋을지에 대해서 좋은 방안과 계획을 수립해서 나에게 제안해줘. 내가 보고 같이 다듬으면서 최종 승인하면 그 때 구축을 시작하자.
이후, 과정을 좀 더 구조화하고 입력값/판단 부분을 프로세스화 함
앞단 기획 (Stage 0–4.5) → 내가 목적/타겟/방향을 결정하는 구간
데이터 분석 (Stage 5) → 데이터를 기획에 맞게 분석·시각화
리포트화 (Stage 6–7) → 분석 결과를 기획 방향에 맞는 문서로 조립
flowchart TD
subgraph 기획["앞단 기획 (내 판단이 필요한 구간)"]
S0["Stage 0\n채널 · 시각 · 독자 선택\n📝 내가 입력"]
S1["Stage 1\n타겟 프로파일\n🤖 AI 초안 → 내가 확정"]
S2["Stage 2\n내부 논의 / 아는 것 입력\n📝 내가 입력"]
S3["Stage 3\n외부 리서치 합성\n🤖 AI 초안 → 내가 확정"]
S35["Stage 3.5\n핵심 메시지 방향\n🤖 AI 제안 → 내가 확정"]
S4["Stage 4\n분석 축 선택 + 데이터 파일 지정\n🤖 AI 제안 → 내가 선택"]
S45["Stage 4.5\n레퍼런스 PDF 업로드\n🤖 AI가 스타일 추출"]
end
subgraph 분석["데이터 분석 (Stage 5)"]
S5a["5a: 데이터 파악\nAI가 분석 항목 제안"]
S5b["5b: 분석 항목 선택\n내가 체크박스로 선택"]
S5c["5c: 차트 설계\n내가 X축·Y축·차트유형 지정"]
S5d["5d: 인사이트 확정\n차트 생성 + AI 해석 → 내가 수정·확정"]
end
subgraph 리포트["리포트화"]
S6["Stage 6\n목차 구조 확정\n🤖 AI 초안 → 내가 확정"]
S7["Stage 7\n섹션별 본문 생성\n🤖 AI 자동 생성 → PDF 출력"]
end
DATA[("Excel 파일\n/data 폴더")]
REF[("레퍼런스 PDF\n/references 폴더")]
OUT["최종 PDF 리포트\n다운로드"]
S0 --> S1 --> S2 --> S3 --> S35 --> S4 --> S45
S45 --> S5a
DATA --> S5a
REF --> S45
S5a --> S5b --> S5c --> S5d
S5d --> S6 --> S7 --> OUT결과와 배운 점
잘 된 부분
context.json에 모든 단계 결과가 쌓여서, 데이터 바뀌면 Stage 5부터만 재실행하면 됨AI가 제안하고 내가 확정하는 구조가 각 단계에 명확히 구현됨
잘 안 된 부분
현재 클로드 코드 내에서 작동하도록 해두었는데, 차트 유형·축을 선택할 때 실제 데이터가 어떻게 보일지 미리 볼 수 있는 창구가 없음. 생성해봐야 결과를 확인할 수 있어서 반복 수정이 필요함(?)
레퍼런스를 내용과 양식을 참고할 것을 넣어줬는데 PDF에서 스타일을 추출하지만, 실제 차트의 색상·폰트에는 적용되지 않는 것 같음
10단계 파이프라인이 실제 작업 방식과 어느 때는 기획과 데이터 확인을 섞어가며 진행해야 할 경우와 맞지 않는 것 같음
1을 목표로 잡고, 이후 10을 구현 하는 방향으로 접근하자(아직도 여전히 부족한 부분,,,,)
시행착오
Claude Code가 중간에 웹앱 방향으로 만들어가서, 일단 Streamlit으로 Claude Code 안에서 볼 수 있게 범위를 좁혔음
리포트 3가지를 동시에 만들려다가 한 채널에 집중해서 프로세스를 먼저 만드는 방향으로 수정
도움이 필요한 부분
이것이 최종적으로 웹서비스에서 단계별로 요청이 있으면 제가 답변/데이터 엑셀파일/자료를 입력하는 곳이 있어야 하는 것 같은데 이게 어떻게 구현이 되는건지, 그 부분이 상상이 안됩니다.