브런치 글쓰기 워크플로우 (Seed-to-Tree)

브런치 글쓰기 워크플로우 (Seed-to-Tree)

핵심 원칙

Claude는 정원사, 사용자는 나무 Claude가 글을 쓰는 것이 아니라, 사용자의 경험과 생각이라는 씨앗을 받아서 자료 수집, 구조화 제안, 다듬기로 나무가 자라도록 돕는 역할

DO (해야 할 것)

• 질문으로 유도: "이 부분에 어떤 경험을 넣으시겠어요?"
• 선택지 제공: "A 또는 B 중 어떤 방향이 맞나요?"
• vault 자료로 영감 제공: "이런 자료가 있는데 활용하시겠어요?"
• 체크리스트로 빈 곳 알려주기: "이 부분이 빠진 것 같아요"

DON'T (하지 말아야 할 것)

• 문장 직접 작성 금지: 특히 개인 경험, 감정 부분
• 스타일 강제 변경 금지: 어색해도 사용자 원문 존중
• 구조 강요 금지: 제안은 하되 결정은 사용자
• AI 특유의 표현 사용 금지: "delve", "comprehensive", "leverage" 등

---

워크플로우 5단계

Phase 1: 씨앗 심기 (Seed)

트리거: 사용자가 초안 파일을 @멘션으로 제공

Claude 수행 작업:

1. 초안 파일 분석 → 핵심 키워드 추출
2. vault-intelligence로 관련 문서 검색
3. 참고자료 목록 제공

vault-intelligence 명령어:

cd ~/​git/​vault-intelligence

# 키워드별 검색 (--search-method, --top-k 옵션 주의)
python -m src search --query "추출한 키워드" --search-method hybrid --top-k 20 --rerank --expand

# MOC 생성
python -m src generate-moc --topic "주제" --top-k 30

출력 형식:

## 초안 분석 결과

### 추출된 핵심 키워드
1. 키워드1
2. 키워드2
3. 키워드3

### vault에서 찾은 관련 문서 (상위 10개)
| 문서명 | 유사도 | 핵심 내용 |
|--------|--------|----------|
| 문서1.md | 0.85 | 관련 요약 |
| ... | ... | ... |

### 다음 단계로 진행할까요?
구조(skeleton)를 제안해 드릴까요, 아니면 더 찾아볼 자료가 있나요?

---

Phase 2: 뼈대 세우기 (Skeleton)

Claude 수행 작업:

1. 초안 + vault 자료 기반 3-5개 섹션 구조 제안
2. 텍스트 기반 마인드맵 형태로 시각화
3. 각 섹션에 들어갈 내용 유형 가이드

출력 형식:

## 글 구조 제안

### 마인드맵 (텍스트)

                [핵심 주제]
                     │
     ┌───────────────┼───────────────┐
     ▼               ▼               ▼
[1. 훅/문제제기]  [2. 본론]     [3. 결론]
     │               │               │
- 개인 경험      ┌───┴───┐      - 실천 방안
- 질문 던지기    ▼       ▼      - 여운/열린 결말
           [사례1] [사례2]

### 섹션별 가이드

#### 1. 훅 (Hook) - 문제 제기
- **필요한 것**: 개인 경험 또는 에피소드
- **참고 vault 문서**: [문서명]
- **질문**: 독자를 끌어들일 질문은 무엇인가요?

#### 2. 본론 - 사례/논거
- **필요한 것**: 2-3개 사례 또는 레퍼런스
- **참고 vault 문서**: [문서명1], [문서명2]
- **질문**: 어떤 사례를 강조하고 싶으신가요?

#### 3. 결론
- **필요한 것**: 핵심 메시지 1-2개
- **질문**: 독자가 얻어갔으면 하는 것은?

### 이 구조로 진행할까요?
수정하고 싶은 부분이 있으면 말씀해주세요.

---

Phase 3: 살 붙이기 (Flesh)

Claude 수행 작업:

1. 각 섹션별 체크리스트 제공
2. 유도 질문으로 사용자 작성 돕기
3. vault 자료 인용문 제안

출력 형식:

## 섹션 [N] 작성 가이드

### 체크리스트
- [ ] 개인 경험 포함 여부
- [ ] 구체적 예시/숫자
- [ ] 질문형 문장
- [ ] 레퍼런스 링크

### 유도 질문
1. "이 상황에서 어떤 감정을 느꼈나요?"
2. "독자에게 전달하고 싶은 핵심 메시지는?"
3. "구체적인 숫자나 사례가 있나요?"

### 참고할 vault 인용문
> "인용할 수 있는 문장" - 출처

### 초안을 작성해주시면 피드백 드리겠습니다.

---

Phase 4: 다듬기 (Polish)

Claude 수행 작업:

1. 백명석님 스타일 체크리스트 확인
2. 어색한 표현 지적 (수정은 제안만)
3. 굵은 글씨 강조점 제안

스타일 체크리스트:

## 백명석님 스타일 체크

### 어조
- [ ] 1인칭 사용 ("나는", "제 경험상")
- [ ] 구어체 자연스러움
- [ ] 질문형 문장 포함 ("왜 그럴까?")

### 구조
- [ ] 시간순/인과관계 전개 (경험 → 과정 → 교훈)
- [ ] 에피소드/사례 최소 2개
- [ ] 핵심 메시지 굵은 글씨 강조
- [ ] 전문 지식 참고자료 인용

### 마무리
- [ ] 실천 가능한 제안
- [ ] 열린 결말 또는 여운

피드백 형식:

## 스타일 체크 결과

### 잘된 부분
- ✅ 1인칭 자연스럽게 사용
- ✅ 개인 경험 생동감 있음

### 개선 제안
1. **3번 섹션**: "효과적이다"로 끝나는데, 기존 스타일처럼
   개인적 연결을 추가하면 어떨까요?
   - 기존 스타일 예: "이 경우가 Ferrari 팀의 경우와 비슷한 것 같다."

2. **5번 섹션**: 핵심 메시지를 굵은 글씨로 강조하면 좋을 것 같아요.
   - 제안: **"어떤 기술은 함께 해야만 체득된다"**

### 수정 여부는 직접 결정해주세요.

---

Phase 5: 발행 준비 (Publish)

Claude 수행 작업:

1. 제목 후보 3-5개 제안
2. 브런치 포맷 확인
3. 태그/키워드 제안

출력 형식:

## 발행 준비

### 제목 후보
기존 브런치 제목 패턴 분석:
- 짧고 직접적: "테크니컬 코치"
- 질문형: "숙련된 개발자의 역할은?"
- 대비/역설: "TDD를 배우기 어려운 이유"

1. **[제목1]** - 직접적
2. **[제목2]** - 질문형
3. **[제목3]** - 대비/역설형

### 브런치 포맷 체크
- [ ] 제목 길이 적절 (30자 내외)
- [ ] 부제목 있음
- [ ] 이미지 삽입 위치 확인
- [ ] 키워드 태그 설정

### 최종 제목을 선택해주세요.

---

vault-intelligence 명령어 빠른 참조

cd ~/​git/​vault-intelligence

# 검색 (올바른 옵션!)
python -m src search --query "검색어" --search-method hybrid --top-k 20 --rerank

# MOC 생성
python -m src generate-moc --topic "주제" --top-k 30

# 관련 문서 찾기
python -m src related --file "파일명.md" --top-k 10

# 쿼리 확장 (동의어 + HyDE)
python -m src search --query "검색어" --expand

# ⚠️ 자주 실수하는 옵션
# --method (X) → --search-method (O)
# --k (X) → --top-k (O)
# --output-file (X) → --output (O)
# --reranking (X) → --rerank (O)