올해 Claude Code 워크플로우에서 가장 큰 성과를 낸 개선점은 프롬프트나 모델이 아니었다
The biggest Claude Code workflow upgrade I made this year had nothing to do with prompts or models
핵심 요약
Claude Code 출력 형식을 마크다운 대신 독립형 HTML로 바꾸니 비기술직 이해관계자에게 전달하기 훨씬 좋아짐.
- 출력 형식 변경 — 마크다운이나 CSV 대신 독립형 HTML을 사용하여 가독성과 전달력을 높임.
- 비기술직 소통 — 요약, 표, 설명 등을 포함한 HTML 보고서가 이해관계자에게 훨씬 효과적임.
- 프레젠테이션 레이어 — AI에게 단순히 내용을 생성하는 것이 아니라 최종 결과물을 만들도록 지시함.
- 상호 보완적 활용 — 상세 분석은 마크다운, 고수준 보고는 HTML을 사용하는 방식이 효율적임.
Claude Code를 몇 달 동안 아주 많이 써왔는데, 최근에 한 워크플로우 개선 중 가장 큰 성과는 더 나은 프롬프트나 MCP 설정, 모델 변경이 아니었음.
그건 바로 Claude에게 요청하는 *최종 결과물(final artifact)*을 바꾼 거임.
오랫동안 나는 기본적으로 다음만 요청했었음:
- markdown 보고서
- csv 내보내기
- 텍스트 요약
- 로그/디버그 노트
내부적으로는 잘 돌아갔지만, 결과물이 내 저장소나 워크플로우를 벗어나는 순간, 결국 사람이 보기 좋게 모든 걸 수동으로 다시 포맷팅해야 했음.
최근에는 Claude에게 깔끔한 독립형 HTML 결과물을 생성해달라고 요청하는 방식으로 바꿨음.
거창한 React 앱이 아님. 그냥 단일 파일 HTML임:
- 깔끔한 스타일링
- 상단에 요약 정보
- 필요할 때 검색/필터링 가능한 섹션
- 펼쳐볼 수 있는 상세 블록
- 신뢰도 태그
- 실제로 도움이 되는 가벼운 상호작용
솔직히 AI가 생성한 결과물이 '초안'이 아니라 '바로 전달 가능한' 수준이라고 느낀 건 이번이 처음임.
이번 주 사례:
Claude에게 약 60개 계정에 대한 고객 건강 상태 분석을 시켰음.
기존 방식:
'마크다운 보고서 생성'
대신 이렇게 요청함:
'비기술직 이해관계자에 최적화된 깔끔한 독립형 HTML 보고서 생성'
결과물에는 다음이 포함됨:
- 요약 인사이트
- 계정 순위 표
- 쉬운 영어로 된 점수 설명
- 동료 비교
- 데이터 품질이 낮을 때의 신뢰도 지표
- 펼쳐볼 수 있는 근거 자료
흥미로운 깨달음:
Claude는 결과물 자체를 작업의 일부로 취급하면 프레젠테이션 레이어를 생성하는 데 놀라울 정도로 능숙함.
우리 중 많은 사람이 여전히 이 도구들을 이렇게 사용하고 있다고 생각함:
'콘텐츠/코드 생성'
대신 이렇게 해야 함:
'최종적으로 사용 가능한 결과물 생성'
내부 에이전트 워크플로우에서 마크다운/텍스트 위주 출력에서 벗어난 사람이 또 있는지 궁금함.
장기적으로 어떤 출력 형식이 가장 효과적이었음?
