블로그 글 작성 & 수정

모드 판단

인자($ARGUMENTS)를 보고 모드를 판단합니다:

• •새 글 작성: 주제가 주어진 경우 (예: /blog-writer Next.js 마이그레이션)
• •기존 글 수정: 파일명이 주어지거나, 대화 맥락에서 수정 요청이 있는 경우

새 글 작성 절차

1. •주제에 대해 충분히 조사 (WebSearch, WebFetch 활용)
2. •글 구조 설계 후 사용자와 논의
3. •toss.tech 스타일 가이드에 따라 초안 작성
4. •MDX(블로그용) + MD(Velog용) 두 버전 생성

기존 글 수정 절차

반드시 지켜야 할 것

1. •글 전체를 먼저 읽는다 — 부분만 보고 수정하지 않는다
2. •전체 흐름을 파악한다 — 도입→본론→마무리의 논리적 흐름
3. •톤의 일관성을 유지한다 — 수정한 부분만 톤이 다르면 안 된다
4. •수정 후 앞뒤 문맥을 확인한다 — 연결이 자연스러운지

수정 시 체크할 것

• •수정한 문장이 앞 문장과 자연스럽게 이어지는가?
• •수정한 섹션이 전체 글의 논리 흐름에 맞는가?
• •톤이 갑자기 바뀌지 않는가? (친근 → 딱딱 등)
• •같은 내용을 다른 섹션에서 이미 다루고 있진 않은가?
• •수정으로 인해 다른 섹션도 함께 바꿔야 하는 부분은 없는가?

MDX ↔ Velog 동기화

• •한쪽을 수정하면 반드시 다른 쪽도 동일하게 반영한다
• •MDX: src/content/[slug].mdx
• •Velog: src/content/velog/[slug].md

파일 규칙

MDX (블로그용)

• •경로: src/content/[slug].mdx
• •메타데이터: export const meta = { title, description, date, category }
• •이미지: import Image from 'next/image' + <Image> 컴포넌트

MD (Velog용)

• •경로: src/content/velog/[slug].md
• •메타데이터: YAML frontmatter (---)
• •이미지: ![alt](url) 마크다운 문법

스타일 가이드 핵심

상세 가이드는 writing-guide.md 참고.

작성자

• •이름: 전민오

문체

• •존댓말: ~해요, ~했어요, ~할게요 (O) / ~합니다, ~하였습니다 (X)
• •개인적 톤: "저도 이런 경험이 있었어요" 식의 1인칭
• •대화체: 독자에게 직접 말하듯 편안하게
• •질문 활용: "그렇다면 뭐가 달라졌을까요?"

구조 (필수)

## 도입 (배경)
- "안녕하세요, 전민오입니다" 로 시작
- 왜 이 주제를 다루는지
- 독자가 공감할 문제/질문

## 본론 (번호 매긴 섹션)
- 1, 2, 3... 번호 매기기
- 각 섹션에 명확한 제목
- 섹션 간 구분선 (---)
- 구체적 예시, 데이터, Before/After

## 마무리
- 핵심 메시지 재강조
- 독자에게 남기는 말

콘텐츠 원칙

• •데이터로 증명: "좋다" (X) → "10배 올랐어요" (O)
• •짧고 명확한 문장: 한 문장 = 한 아이디어
• •강력한 동사: "해결했다" (X) → "작살냈다" (O)
• •비유 활용: 복잡한 개념을 일상적인 것으로 설명
• •Before/After 비교: Winner/Loser 패턴 적극 활용
• •표(Table): 비교, 정리에 적극 사용

금기 사항

• •격식적 문어체 (본 연구에서는...)
• •추상적/모호한 표현 (효과적이다, 많이 개선)
• •전문 용어 남발 (설명 없이)
• •과장된 제목 (놀라운! 반드시!)
• •불필요한 이모지 남발

최종 체크리스트

스타일

• • 친근한 존댓말 (~해요) 일관 사용
• • 구체적 데이터/예시 포함
• • 번호 매긴 섹션으로 구조화
• • Before/After 비교 포함
• • 독자가 바로 적용 가능

품질

• • 전체 흐름이 자연스러운가?
• • 톤이 처음부터 끝까지 일관적인가?
• • 같은 내용이 중복되지 않는가?
• • 각 섹션이 독립적으로도 이해 가능한가?

파일

• • MDX 버전 작성/수정 완료
• • Velog MD 버전 동기화 완료