📝 한줄 요약
"제목에 사례글 넣어줘" 한 마디에 AI는 파일 내부 H1을 수정했고, 사용자는 파일명을 원했다.
🎯 이런 분께 도움이 될 수 있어요
AI에게 지시할 때 왜 구체적으로 말해야 하는지 궁금한 분
Claude Code를 처음 써보는 분
AI 실수 사례와 재발방지를 시도해 보고 싶은 분
📖 무슨 일이 있었나
상황
파일:
AI_CASE_STUDY.md요청: "제목에 '사례글' 들어가게 해줘"
❯ d:\02_claude\20-created\24-jwko-aiworks-ansang\1202_daily-worklog-automation\output\AI_CASE_STUDY.md
제목에 "사례글" 들어가게 해줘.AI의 행동
파일 내부 H1 제목을 수정했다.
변경 전: # 클로드 코드와 인터뷰 시도 (업무 일지 작성을 위한)
변경 후: # [사례글] 클로드 코드와 인터뷰 시도 (업무 일지 작성을 위한)사용자의 의도
파일명을 바꾸는 것이었다.
❯ 어디에 저장한거야? 수정후의 제목 내가 보려면 어떻게 하면돼?원하던 결과: AI_CASE_STUDY.md → 사례글_AI_CASE_STUDY.md🔍 왜 이런 일이 생겼나
"제목"이라는 단어가 두 가지로 해석 가능했다.
해석
의미
문서 제목
파일 내부 # H1
파일 제목
파일명 (.md 앞부분)
AI는 둘 중 하나를 골라 바로 실행했다. 확인을 먼저 하지 않았다.
💬 그 외에 오간 대화들
수정 후 사용자가 물었다:
"어디에 저장한 거야?" → 같은 파일을 수정한다는 개념이 낯설었던 것
"수정 후 내용 보려면?" → VS Code 새로고침 방법을 몰랐던 것
"IDE가 뭐야?" → 용어 자체가 생소했던 것
"한국어 명령어는?" → VS Code UI 언어가 한국어였던 것
"영어로 바꾸는 법은?" → 설정 변경 방법이 필요했던 것
AI가 당연하게 쓴 단어(IDE, Revert File)가 사용자에게는 낯선 단어였다.
❯ d:\02_claude\20-created\24-jwko-aiworks-ansang\1202_daily-worklog-automation\output\AI_CASE_STUDY.md
파일명에 "사례글" 이라는 단어 추가하라고 했는데 체크해봐. 안되어 있다면 원인 및 재발방지대책은? ✅ 배운 것
AI 입장에서
모호한 단어(제목, 파일, 저장 등)는 실행 전에 확인해야 한다
기술 용어를 설명 없이 쓰면 안 된다
"어디에 저장했냐"는 질문이 나왔다면, 처음부터 저장 위치를 먼저 알려줬어야 했다
사용자 입장에서
AI에게 지시할 때 "파일명에" vs "파일 안 제목에"처럼 구체적으로 말하면 오류가 줄어든다
모르는 단어가 나오면 바로 물어봐도 된다 — 그게 더 빠르다
🔁 재발방지대책
"제목", "이름", "저장" 등 맥락에 따라 달라지는 단어가 포함된 지시는 실행 전에 "파일명인가요, 내용인가요?" 확인 먼저 드린다.
🏃♂️ 배운 점
AI에게 원하는 결과물을 얻으려면, "결"만 던지는 게 아니라 기/승/전을 준비해서 자동 또는 반자동으로 전달할 수 있는 구조를 갖춰야 한다는 걸 봅니다.
그 준비 작업 자체에 에너지가 들어갑니다. 매번 시행착오에 에너지를 쓸 것인가, 준비물을 제대로 다듬는 데 에너지를 쓸 것인가. 상호 보완하면서 가야겠습니다~