본문으로 건너뛰기

[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 활용 팁

효과적이었던 것

  1. "처음 보는 사람에게 설명해줘"라는 요청 하나로 충분하다 내가 직접 읽어봐도 몰랐던 구멍이, 설명서를 쓰는 순간 드러난다. 별도로 검토할 필요가 없다.

  2. 설명이 막히는 곳이 신호다 설명하려는데 막힌다면 — 내가 애매하게 알고 있다는 뜻이다. 그 지점이 보완해야 할 곳이다.

  3. 해설서가 맥락 보존 장치가 된다 줄임말과 전문용어만 있는 파일은 만든 사람만 이해한다. 해설서를 함께 만들면 다른 AI, 다른 사람에게 넘겨도 같은 퀄리티로 이어진다.

이렇게 하면 안 돼요

  1. 만들었으니까 안다고 넘어가지 마세요 직접 만든 워크플로우도 설명하려면 막히는 부분이 생긴다. 안다는 것과 설명할 수 있다는 건 다르다.

  2. 전문용어를 설명 없이 쓰지 마세요 AI가 알아서 이해할 것 같지만, 같은 단어가 맥락에 따라 다르게 해석된다. 줄임말 하나가 전혀 다른 방향으로 실행될 수 있다.


🌍 다른 업무에 적용한다면?

  • 반복 업무 자동화를 만든 사람: 프로세스 문서가 있다면 AI에게 설명서를 써달라고 해보세요. 자신도 몰랐던 빈 구멍이 보인다.

  • 팀에서 AI 프롬프트를 공유하는 사람: 프롬프트에 해설을 붙이면 팀원마다 다르게 해석하는 문제를 줄일 수 있다.

  • AI로 기획 문서를 만드는 사람: 완성된 문서를 "비전문가 언어로 설명해줘"라고 한 번 더 돌려보면 논리 구멍이 드러난다.


🚀 앞으로의 계획

  • AI MARKET 소상공인 홈페이지 워크플로우 STEP 2 이후 실제 진행

  • 이 해설서를 부트캠프 교육 자료로 활용하는 방안 검토

  • 워크플로우 해설서 작성 → 검증 → 보완의 사이클을 다른 워크플로우에도 적용


📋 재사용 가능한 프롬프트

프롬프트 1: 내 워크플로우/문서의 구멍 찾기

[내 문서]를 일반사람들이 이해할 수 있는 일타강사 스타일로, 용어들이 왜 그런 구성으로 만들어졌는지 설명할 수 있는 해설 문서를 만들어줘. 설명하다가 막히거나 내용이 없는 부분은 "이 부분은 보완이 필요합니다"라고 표시해줘. [내 문서]는 본인 것으로 교체하세요

프롬프트 2: 줄임말·전문용어 점검

이 문서 안에 있는 줄임말과 전문용어를 모두 찾아서 용어 해설집을 따로 만들어줘.

함께 이야기해요 0

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

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

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

이런 사례도 있어요

사례 전체 보기