[Claude Code] 내가 만든 문서인데 설명이 막혔다 — AI와 일할 때 꼭 거쳐야 할 단계
2026.04.18
📝 한줄 요약
소상공인 홈페이지 제작 워크플로우를 만들고, AI에게 "처음 보는 사람에게 설명해줘"라고 했더니 — 내가 미처 발견하지 못했던 구멍 7개가 드러났다.
바쁘시면 이것만 읽어도 돼요:
AI로 워크플로우를 만들었지만 설명서를 쓰는 순간 막히는 부분이 생겼다
설명이 막히는 곳 = 아직 덜 만들어진 곳이었다
줄임말과 전문용어는 다른 AI, 다른 사람에게 다르게 해석된다
해설서를 쓰는 과정 자체가 맥락 보존 장치가 됐다
핵심 팁: AI한테 "이걸 처음 보는 사람에게 설명해줘"라고 시키는 것만으로 내 작업의 구멍이 보인다
🎯 이런 분들께 도움돼요
AI로 뭔가 만들었는데 나중에 다시 보니 내가 뭘 만든 건지 모르겠는 분
프롬프트나 워크플로우를 팀원이나 다른 AI에게 넘겼더니 결과가 달라진 경험이 있는 분
😫 문제 상황 (Before)
소상공인 홈페이지를 제작해주는 서비스를 만들고 있었다.
단순히 홈페이지를 만들어주는 게 아니라 — 글로벌 리서치부터 시작해서, 업체 분석, 전문가 관점 평가, 최종 기획서 생성까지 8단계를 자동으로 진행하는 워크플로우였다. 꽤 촘촘하게 만들었다고 생각했다.
문서 안에는 CRO, AEO, STIC, Core Web Vitals 같은 전문 용어들이 들어가 있었다. 내가 쓴 말이니까 당연히 다 안다고 생각했다. 설명할 수 있다고 생각했다.
🛠️ 사용한 도구
도구: Claude Code
모델: Claude Sonnet 4.6
특이사항: Notion MCP 연동으로 로컬 + 노션 동시 저장
🔧 작업 과정
워크플로우를 만들었다 — 그런데 설명이 막혔다
8단계짜리 워크플로우를 완성한 뒤, 이걸 처음 보는 사람도 이해할 수 있게 설명서를 써보기로 했다.
위 MD 파일을, 일반 사람들이 이해할 수 있도록 일타강사 스타일로 — 각 용어가 포함된 프로세스가 왜 그런 구성으로 만들어졌는지 설명할 수 있는 MD 파일로 하나 만들어 주셨으면 해요.
그런데 이상한 일이 생겼다.
내가 만든 문서인데, 설명을 쓰려니 막히는 부분이 있었다.
막혔던 순간 1 — GA4가 어디에 저장되는가
워크플로우에는 GA4 설치 단계가 있었다. 당연히 안다고 생각하고 넘어갔던 부분이었다.
그런데 설명서를 쓰다 보니 이 질문이 나왔다.
GA4와 커스텀 이벤트를 설치했을 때, 데이터는 어디에 저장되나요?
순간 멈췄다. 내 계정? 고객 계정? 워크플로우 어디에도 이게 없었다.
나는 사업적 접근을 하는 건데, 어떻게 하는 게 좋을까?
사업적으로 생각해보니 답은 명확했다. 고객 계정에 GA4를 만들고, 나는 편집자 권한을 받는 구조. 계약이 끝나도 데이터는 고객 것으로 남는 게 맞다. 장기적으로 신뢰 자산이 된다.
설명하려다 보니 원칙이 나왔다. 바로 워크플로우에 추가했다.
막혔던 순간 2 — SEO/AEO 전문가가 있는데 내용이 없다
전문가 패널에 "SEO/AEO 전문가"가 있었다. 근데 정작 워크플로우 어디에도 SEO와 AEO가 뭔지, 왜 이게 필요한지 설명이 없었다.
하나 더 추가했으면 하는 게 있는데, AEO와 SEO가 우리 서비스에 포함되어 있는데 이 부분에 대한 언급이 없는 것 같아.
게다가 한국 소상공인 고객들은 거의 반드시 이런 질문을 한다.
"네이버 상위 노출은 어떻게 되나요?"
AI 설계가 구글의 SEO 설계를 기반으로 만들어졌다는 이야기를 들은 적 있어.
우리나라는 소비자 행동 패턴상 다른 외국과 달리 네이버에서 검색이 이루어지는데,
이 부분이 우리 웹페이지 구성에 포함되어 있었는지도 다시 검토해 줘.우리
설명서를 쓰려니 자연스럽게 이어졌다.
AI 검색은 구글 SEO 기반으로 설계됐다
네이버도 AI 검색(Cue:)으로 전환 중이다
AEO 설계 하나로 구글과 네이버를 동시에 커버할 수 있다
고객이 물어보기 전에 설명서에 미리 답을 써두면 신뢰가 생긴다
설명 하나를 제대로 쓰려다가 워크플로우 구멍 여러 개를 메웠다.
해설서가 "맥락 보존 장치"가 됐다
그런데 이 과정에서 더 중요한 걸 발견했다.
워크플로우 안에는 줄임말과 전문용어가 많다. CRO, AEO, STIC, UTM... 만든 사람인 나에게는 당연한 언어다. 하지만 이 파일을 다른 사람에게 넘기거나, 다른 AI 모델에게 넘기면?
같은 단어라도 다르게 해석될 수 있다.
해설서를 쓰는 과정은 단순히 설명을 추가하는 작업이 아니었다. 왜 이렇게 만들었는지, 어떤 문제를 발견해서 어떻게 고쳤는지의 맥락이 그대로 담기게 됐다.
이제 이 파일을 누구에게 넘겨도 — 사람이든 AI든 — 같은 이해로 이어갈 수 있게 됐다.
✅ 결과 (After)
Before vs After
항목 | Before | After |
|---|---|---|
워크플로우 완성도 | 8단계 구성, 빈 구멍 있음 | 빈 구멍 7개 발견·보완 완료 |
GA4 계정 원칙 | 없음 | 고객 계정 + 편집자 권한 명시 |
SEO/AEO 설명 | 전문가 역할만 있고 내용 없음 | AEO로 구글+네이버 동시 커버 구조 확정 |
파일 전달성 | 만든 사람만 이해 가능 | 누구에게 넘겨도 동일 실행 가능 |
고객 결과물 | 기획서 파일만 | 기획서 + 고객 공유용 노션 설명서 |
내용 이해도·구체성 | 전문용어 나열 | 맥락과 이유가 담긴 완성된 언어 |
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
"처음 보는 사람에게 설명해줘"라는 요청 하나로 충분하다 내가 직접 읽어봐도 몰랐던 구멍이, 설명서를 쓰는 순간 드러난다. 별도로 검토할 필요가 없다.
설명이 막히는 곳이 신호다 설명하려는데 막힌다면 — 내가 애매하게 알고 있다는 뜻이다. 그 지점이 보완해야 할 곳이다.
해설서가 맥락 보존 장치가 된다 줄임말과 전문용어만 있는 파일은 만든 사람만 이해한다. 해설서를 함께 만들면 다른 AI, 다른 사람에게 넘겨도 같은 퀄리티로 이어진다.
이렇게 하면 안 돼요
만들었으니까 안다고 넘어가지 마세요 직접 만든 워크플로우도 설명하려면 막히는 부분이 생긴다. 안다는 것과 설명할 수 있다는 건 다르다.
전문용어를 설명 없이 쓰지 마세요 AI가 알아서 이해할 것 같지만, 같은 단어가 맥락에 따라 다르게 해석된다. 줄임말 하나가 전혀 다른 방향으로 실행될 수 있다.
🌍 다른 업무에 적용한다면?
반복 업무 자동화를 만든 사람: 프로세스 문서가 있다면 AI에게 설명서를 써달라고 해보세요. 자신도 몰랐던 빈 구멍이 보인다.
팀에서 AI 프롬프트를 공유하는 사람: 프롬프트에 해설을 붙이면 팀원마다 다르게 해석하는 문제를 줄일 수 있다.
AI로 기획 문서를 만드는 사람: 완성된 문서를 "비전문가 언어로 설명해줘"라고 한 번 더 돌려보면 논리 구멍이 드러난다.
🚀 앞으로의 계획
AI MARKET 소상공인 홈페이지 워크플로우 STEP 2 이후 실제 진행
이 해설서를 부트캠프 교육 자료로 활용하는 방안 검토
워크플로우 해설서 작성 → 검증 → 보완의 사이클을 다른 워크플로우에도 적용
📋 재사용 가능한 프롬프트
프롬프트 1: 내 워크플로우/문서의 구멍 찾기
[내 문서]를 일반사람들이 이해할 수 있는 일타강사 스타일로, 용어들이 왜 그런 구성으로 만들어졌는지 설명할 수 있는 해설 문서를 만들어줘. 설명하다가 막히거나 내용이 없는 부분은 "이 부분은 보완이 필요합니다"라고 표시해줘. [내 문서]는 본인 것으로 교체하세요
프롬프트 2: 줄임말·전문용어 점검
이 문서 안에 있는 줄임말과 전문용어를 모두 찾아서 용어 해설집을 따로 만들어줘.



