[사내AX] 🫵 사례글 안 쓰는 당신을 위한 자동화 - 더 이상 핑계 없음, Claude가 다 써줌 ㅋㅋ - 1탄

📝 한줄 요약

Claude Code와 대화만 했는데 개발 로그도 쓰여지고, 사례글도 자동으로 완성됐다.

🎯 이런 분들께 도움돼요

• 사례글 쓰라는 압박에 시달리지만 쓰기 귀찮은 AI스터디 멤버

• 시행착오 과정을 다 기억하기 어려워서 사례글 작성을 미루는 분

• AI와 협업한 과정을 체계적으로 기록하고 공유하고 싶은 분

이 프로젝트가 더 궁금하다면 👉 링크

ALT

게시물의 한국어 버전 스크린샷

ALT

한국어 앱 스크린샷

🧭 일단 설치해서 써봅시다! - 설치 방법

Mac / Linux

프로젝트 폴더 터미널에서 실행 후 클로드코드 재시작

curl -fsSL https://raw.githubusercontent.com/daht-mad/ai-post-write/main/install.sh | bash

Windows (PowerShell)

프로젝트 폴더 터미널에서 실행 후 클로드코드 재시작

iwr -useb https://raw.githubusercontent.com/daht-mad/ai-post-write/main/install.ps1 | iex

권장 워크플로우

1. Claude Code로 작업
      ↓
2. /devlog 실행 → DEVLOG.md 생성
      ↓
3. (나중에) /ai-case 실행 → AI_CASE_STUDY.md 생성
      ↓
4. 미리보기 열고 복붙 → 게시판에 업로드

😫 문제 상황

사례글 쓰기가 너무 번거로웠어요. 막상 쓰려고 하면:

1. 대화 내역 찾기부터 막막 - "분명 이런 작업을 했는데, 어디서 했더라?" 하며 스크롤 무한 탐험

2. 시행착오는 기억 안 남 - 결과만 보이고, 중간에 어떤 문제를 어떻게 해결했는지 가물가물

3. 글 구조 잡기도 일 - 템플릿은 있는데, 뭘 어떻게 채워야 할지 막막

결국 "나중에 써야지..." 하다가 안 쓰게 되고, 다른 사람들도 같은 시행착오를 반복하게 되는 악순환.

💡 시작 계기

대시보드 만든 사례글을 쓰려고 했는데, 대화 내역을 다시 찾으려니 정말 막막했어요. "Claude Code 대화 내역 저장되는 곳 없나?" 하고 물어봤더니 세션 파일이 있다는 걸 알게 됐죠.

그때 생각했어요. "이 세션 파일을 자동으로 정리하면 되겠네?"

그리고 개발 로그를 만들고 나니 또 깨달았어요. "이 과정 자체를 자동화하면 다른 사람들도 쉽게 사례글을 쓸 수 있겠다!"

🛠️ 사용한 도구

• 도구: Claude Code (VSCode Extension)

• 모델: Claude Opus 4.5

• 특이사항: Custom Commands 기능 활용

🔧 작업 과정

전체 흐름 요약

1. 세션 파일 발견 → Claude Code 대화 내역이 프로젝트별로 저장된다는 걸 알게 됨

2. /devlog 커맨드 생성 → 세션 파일을 파싱해서 개발 로그 자동 생성

3. /ai-case 커맨드 생성 → DEVLOG 기반으로 사례글 자동 작성 워크플로우 설계

4. 스토리텔링 포맷 개선 → 딱딱한 구조 대신 자연스러운 서술체로 변경

5. 맥락 누락 문제 해결 → 사용자 질문을 맥락과 함께 기록하도록 규칙 추가

상세 작업 과정

1. 세션 파일 발견 - "대화 내역이 저장된다고?"

대시보드 사례글을 쓰려고 했는데, 대화 내역을 다시 찾는 게 너무 힘들었어요. Claude한테 물어봤죠.

클로드 대화내역 저장하는 곳 있지 않아? 프로젝트별로

Claude가 ~/.claude/projects/{프로젝트경로}/*.jsonl 경로를 알려줬어요. 프로젝트별로 세션 파일이 저장된다는 걸 그때 처음 알았습니다.

"이걸 파싱하면 자동으로 개발 로그를 만들 수 있겠다!" 싶었어요. 대화 내역 찾느라 시간 낭비할 필요가 없어지는 거죠.

2. /devlog 커맨드 만들기 - "커맨드 하나로 워크플로우 정의"

세션 파일을 발견하고 나서, .claude/commands/devlog.md 커맨드를 만들었어요.

세션 파일을 파싱해서 DEVLOG.md 형식으로 자동 정리해줘

놀라웠던 건, .md 파일 하나로 복잡한 워크플로우를 정의할 수 있다는 거였어요. 코드 없이도 "세션 파일 읽고 → 파싱하고 → 포맷 맞춰서 → DEVLOG.md에 작성" 전체 프로세스를 명령할 수 있었습니다.

Claude가 커맨드 파일과 Python 예시 스크립트까지 작성해줬어요.

ALT

보라색 배경의 한국어 앱 스크린샷

3. /ai-case 커맨드 설계 - "DEVLOG → 사례글 파이프라인 완성"

DEVLOG를 만들고 나니, 이걸 기반으로 사례글까지 자동으로 쓰면 되겠다 싶었어요.

이 템플릿 기반으로 작성하기 전에 이 커맨드가 트리거되면

1. 먼저 devlog파일을 읽고 파악한 다음

2. 이 템플릿에 맞게 게시글을 쓰기 위해 너가 더 알아야 하는 맥락을 한 번에 하나씩 사용자에게 질문을 해줘

3. 충분히 파악했다고 생각하면 md 파일로 작성해주고

4. 최종 피드백 받아서 최종 수정하는 것까지 프로세스를 만들자

단순 템플릿이 아니라, 질문 → 맥락 파악 → 초안 → 피드백 전체 워크플로우를 커맨드로 정의했어요.

Claude가 8가지 핵심 질문 리스트까지 만들어줬습니다. 마치 인터뷰하듯이 글을 쓰는 구조가 됐죠.

ALT

보라색 배경의 한국어 앱 스크린샷

4. 스토리텔링 포맷으로 개선 - "너무 딱딱해!"

처음 만든 ai-case 템플릿이 "상황 - 요청 - 결과" 구조로 너무 딱딱했어요.

근데 너무 상황, 요청, 한일 이렇게 딱딱 구분되면 너무 읽기 어렵고 딱딱해. 스토리텔링으로 풀어야돼

Claude가 바로 자연스러운 서술체로 바꿔줬어요. 각 작업이 하나의 에피소드처럼 읽히도록 포맷을 변경해줬습니다.

결과: 읽는 사람 입장에서 훨씬 편하게 읽히는 글이 됐어요.

5. 막혔던 순간과 해결

문제 1: 포맷을 Claude가 마음대로 바꿔버림

DEVLOG 커맨드를 실행했더니 Claude가 기존 포맷을 무시하고 자기 스타일로 작성했어요.

해결: "지금 포맷이 딱 좋거든?" 하고 직접적으로 피드백. 기존 DEVLOG.md를 예시로 보여주며 "이 포맷 그대로 유지해" 라고 명확히 지시했습니다.

문제 2: 사용자 질문을 너무 많이 빠뜨림

DEVLOG를 보니까 제가 했던 질문 중 많은 부분이 누락됐어요. "근데 일부만 되고 다 안채워지는데 이유가 뭐야?" 같은 중요한 후속 질문들이 빠졌죠.

해결: 커맨드에 "사용자 요청 정리 규칙" 섹션 추가. 짧은 질문도 맥락과 함께 기록하도록 명시했습니다.

예시: [Airtable 필드 자동 업데이트 중] 근데 일부만 되고 다 안채워지는데 이유가 뭐야?

덧) 제목 추천 로직도 추가!

✅ 결과

Before vs After

결과물

• .claude/commands/devlog.md - 개발 로그 자동 생성 커맨드

• .claude/commands/ai-case.md - AI 활용 사례 게시글 자동 작성 커맨드

• DEVLOG.md - 실제 생성된 개발 로그 (33개 작업 기록)

• 지금 읽고 계신 이 사례글도 /ai-case 커맨드로 작성됐습니다!

임팩트:

• 사례글 쓰는 데 걸리는 시간 대폭 감소 (대화 내역 찾는 시간 → 0)

• 시행착오 과정이 자동으로 기록되니까 빠뜨리지 않음

• 글 구조 고민 없이 질문에 답하다 보면 글이 완성됨

💬 이 과정에서 배운 AI 활용 팁

효과적이었던 것

1. 솔직한 피드백이 최고 - "지금 포맷이 딱 좋거든?" 처럼 솔직하게 말하면 바로 고쳐준다

2. 커맨드로 워크플로우 정의 - .md 파일 하나로 복잡한 프로세스를 코드 없이 정의 가능

3. 한 번 만든 자동화는 계속 개선하기 - 실제로 써보고 불편한 점을 계속 피드백하며 다듬어야 진짜 쓸모있어짐

이렇게 하면 안 돼요

1. 막연하게 "잘 만들어줘" - 구체적으로 어떤 포맷, 어떤 프로세스를 원하는지 명확히 설명해야 함

2. 처음 만든 결과물에 만족 - 실제로 써보고 개선해야 진짜 쓸모있는 도구가 됨

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

이 경험을 다른 상황에도 적용할 수 있을 것 같아요:

• 회의록 자동 생성 - 회의 녹음 → 텍스트 변환 → 커맨드로 요약 및 액션 아이템 추출

• 버그 리포트 자동 작성 - 에러 로그 → 커맨드로 재현 단계 및 해결 방법 정리

• 주간 업무 보고서 자동화 - 작업 기록 → 커맨드로 주간 요약 및 성과 정리

핵심은 "반복되는 문서 작업을 커맨드화" 하는 것이에요.

🚀 앞으로의 계획

이미지 첨부 위치를 자동으로 추천해주는 기능을 추가하고 싶어요. 사례글에서 "이 섹션에는 이런 스크린샷이 들어가면 좋겠어요" 하고 알려주면 더 완성도 높은 글이 될 것 같거든요.

📋 재사용 가능한 프롬프트

프롬프트 1: Custom Command 만들기

[작업 이름]을 위한 커맨드를 만들어줘.

입력: [어떤 파일이나 데이터] 처리 과정: [어떤 단계들] 출력: [어떤 형식으로]

.claude/commands/[커맨드명].md 파일로 작성해줘.

프롬프트 2: AI 피드백 요청

지금 [결과물]이 [어떤 점]이 마음에 안 들어. [이렇게] 바꿔줄 수 있어?

Tip: 구체적으로 무엇이 마음에 안 드는지, 어떻게 바꾸고 싶은지 명확히 말하세요!