🎙️ Claude Code를 활용한 음성메모 자동화 시스템 구축

### 문제 상황
- 달리기 중 떠오르는 아이디어를 빠르게 기록하고 싶음
- 음성 메모는 쌓이지만 정리가 안 됨 (파일 관리 어수선)
- 텍스트 변환, 카테고리 분류 등 수동 작업이 번거로움

### 목표
**"아이폰 음성 녹음 → 완성된 글까지 완전 자동화"**

추가로: 스피치 실력 향상을 위한 코칭 시스템 구축

## 💬 초기 프롬프트

> "음성메모를 자동으로 처리하는 시스템을 만들고 싶어. 내가 음성파일을 다운로드 폴더에 넣으면, 전사 파일과 수필형식의 글로 정리되었으면 좋겠어. 그리고 음성 파일은 iCloud로 자동 이동되게 해줘."

### 대화를 통한 요구사항 구체화

Claude와 대화하며 다음 사항들이 추가됨:

1. **카테고리 자동 분류** (철학, 계획, 책/영화, 일기, 기타)
2. **AI 제목 자동 생성** (yymmdd-제목 형식)
3. **스피치 분석 리포트 추가** ⭐ 핵심 요청
   - "나를 비판해도 괜찮으니, 디테일하게 엄하게 코칭해줘"
   - 발음, 필러 워드, 속도, 톤, 논리 구조 등 엄격 분석
4. **파일명 통일** (전사, 수필, 음성 모두 동일한 제목)

---

## 🛠️ 구현 과정

### 1단계: 프로젝트 정의 (Working Backwards 방식)

Claude의 `/working-backwards-pr` 스킬 활용
- Why, What, How, Success 명확히 정의
- Amazon PR/FAQ 방법론 적용
- 프로젝트 정의서 작성: `project-definition.md`

### 2단계: 기술 스택 결정

**음성 전사 API 선택**
- Whisper API vs Gemini API 비교
- → Gemini API 선택 (무료, 월 1500회 할당)
- API 키 발급 및 설정 완료

### 3단계: 스킬 개발

**`/voice-memo` 스킬 구현**
- Python 스크립트 작성 (`process_voice_memo.py`)
- Gemini 2.0 Flash 모델 활용
- 파이프라인:
  1. 음성 → 텍스트 전사 (STT)
  2. AI 제목 생성
  3. 카테고리 자동 분류
  4. 수필형 글 작성 (문학적, 니체 아모르 파티 철학)
  5. 스피치 분석 리포트 (엄격 코칭)
  6. 3개 파일 저장 + 음성 iCloud 이동

### 4단계: 자동화 스크립트

**`vm` 명령어 설정**
- Bash 스크립트 작성 (`auto-process.sh`)
- Downloads 폴더 자동 스캔
- 파일 이동 → 처리 → 결과 출력
- `.zshrc`에 alias 추가

---

## 📊 결과물

### 생성되는 파일 (하나의 음성 → 4개 파일)

```
1. 수필:       philosophical/260126-니체의_아모르파티-essay.md
2. 전사:       transcripts/260126-니체의_아모르파티-transcript.md
3. 스피치 분석: speech-analysis/260126-니체의_아모르파티-analysis.md
4. 음성 원본:   iCloud/260126-니체의_아모르파티.m4a (자동 백업)
```

### 실제 테스트 결과

**입력**: `AI 인간지능 컨퍼런스 소감.m4a` (7.3MB, 7분 20초)

**출력 예시**:

#### 1. 수필 (excerpt)
```markdown
# 인간지능 오프라인 행사, 운명과 조우하다

토요일 오후 두 시, 2026년의 인간지능 오프라인 행사장은
기대와 설렘으로 가득 찬 공기로 몽글몽글 피어올랐습니다...

- 밝고 긍정적인 톤 ✅
- 문학적 표현 ✅
- 블로그 글감으로 즉시 활용 가능 ✅
```

#### 2. 스피치 분석 (excerpt)
```markdown
**종합 점수**: 5.8/10 (개선 필요)

## 필러 워드 (4/10) 🚨
- "뭐": 11회
- "그리고": 17회
- 총 32회 (분당 4.32회)
- TED 스피커 평균(2회/분)의 2배 이상!

## Next Recording 액션 아이템
1. 필러 워드 제거 집중 훈련
2. 억양 변화 연습 (TED 강연 따라하기)
3. 스크립트 기반 논리적 구조 강화
```

---

## 🚀 사용법

```bash
# 1. 아이폰에서 음성 녹음
# 2. AirDrop으로 Mac에 전송
# 3. 터미널에서:

vm

# 끝! 3-5분 후 모든 파일 자동 생성
```

---

## 💡 핵심 인사이트

### 1. Claude와의 대화형 개발의 힘

**단순 요청 → 대화를 통한 구체화**
- 처음엔 "전사 + 정리" 수준의 요청
- 대화 과정에서 "스피치 코칭" 아이디어 추가
- **"나를 엄하게 비판해도 괜찮아"** → 차별화 포인트

### 2. Working Backwards의 효과

- 구현 전 Why/What/How/Success 명확히 정의
- 중간에 길 잃지 않고 집중 가능
- 프로젝트 정의서가 향후 유지보수 가이드 역할

### 3. 음성 메모 → 스피치 트레이닝 도구

**의외의 발견:**
- 단순 기록 도구 → 자기계발 도구로 진화
- 매 녹음마다 구체적 피드백 (필러 횟수, wpm 등)
- 3개월 후 성장 추적 가능 (월간 리포트 예정)

---

## 🎯 기대 효과

### 단기 (1개월)
- ✅ 떠오르는 아이디어 100% 캡처
- ✅ 하루 1-3회 자연스럽게 사용
- ✅ 블로그 글감 축적

### 중기 (3개월)
- 📈 필러 워드 50% 감소 (데이터 기반 측정)
- ✍️ 블로그 글 5편 이상 발행
- 🎤 스피치 점수 5.8/10 → 7.5/10

### 장기 (6개월~)
- 🌱 지속적 자기 성찰 습관
- 📚 수필 모음집 발행 수준의 콘텐츠
- 💪 대중 발표 능력 향상

---

## 📈 확장 가능성

### 1. 월간 스피치 리포트 자동 생성
- 월별 개선 추세 분석
- 베스트 스피치 선정
- 다음 달 목표 설정

### 2. 블로그 자동 발행 연동
- 수필 → 블로그 초안 자동 업로드
- 카테고리별 시리즈화

### 3. 다중 언어 지원
- 영어 녹음 → 영어 수필 + 스피치 분석
- 언어별 학습 효과

---

## 💻 기술 스택

- **Claude Code**: 프로젝트 설계 및 코드 생성
- **Gemini 2.0 Flash API**: 음성 전사 + AI 처리
- **Python 3.14**: 메인 처리 로직
- **Bash**: 자동화 스크립트
- **iCloud**: 음성 원본 백업

## 📝 배운 점

### Claude 활용 팁

1. **구체적으로 요청하기**
   - "정리해줘" ❌
   - "수필 형식으로, 니체 아모르 파티 철학 반영해서" ✅

2. **대화로 깊이 파기**
   - 첫 요청에서 완벽을 기대하지 말 것
   - "추가로..." "그리고..." 로 계속 구체화

3. **비판 허용하기**
   - "나를 엄하게 비판해도 괜찮아"
   - → 훨씬 유용한 피드백 획득

### 프로젝트 진행 팁

1. **Working Backwards 먼저**
   - 코딩 전 Why/What/How 명확히
   - 시간 아끼는 지름길

2. **무료 API 최대한 활용**
   - Gemini: 월 1500회 무료
   - 개인 프로젝트는 충분

3. **자동화는 필수**
   - `vm` 한 번에 모든 처리
   - 마찰 최소화 → 지속 사용

---

## 🔗 프로젝트 구조

```
10-projects/13-voice-memo/
├── philosophical/              # 철학적 사유 수필
├── plans/                      # 미래 계획
├── media-notes/                # 책/영화 후기
├── diary/                      # 일기
├── misc/                       # 기타
├── transcripts/                # 전사 원본
├── speech-analysis/            # 스피치 분석
│   └── monthly-report/         # 월간 리포트 (예정)
├── scripts/                    # 자동화 스크립트
│   ├── auto-process.sh        # vm 명령
│   └── process_voice_memo.py  # 메인 처리
└── project-definition.md       # 프로젝트 정의서
```

---

## 🎬 마치며

**"순간의 생각을 놓치지 않고, 성장까지 추적하는 시스템"**

Claude Code를 활용하면 2시간 만에 이런 시스템을 구축할 수 있습니다.

핵심은:
1. 명확한 문제 정의
2. Claude와의 구체적 대화
3. 실행 가능한 자동화