Write-Saver 📝

매일 30분 글쓰기 습관을 만들고, 체계적인 피드백으로 실력을 키우는 Claude Code 에이전트입니다.

시작하기

필수 요구사항

Claude Code CLI

프로젝트 구조

모든 스킬과 커맨드가 프로젝트 내부 .claude/ 디렉토리에 포함되어 있습니다:

.claude/
├── commands/           # 슬래시 커맨드
│   ├── write.md        # /write - 글쓰기 세션
│   └── publish.md      # /publish - 블로그 게시
└── skills/             # 장르별 글쓰기 스킬
    ├── daily-journal/  # 일기/감정 기록
    ├── essay-builder/  # 에세이/칼럼
    ├── story-crafter/  # 창작/소설/시
    ├── tech-writer/    # 기술 문서/블로그
    └── copywriting/    # 광고/마케팅 문구

첫 세션 시작

cd ~/Work/write-saver
claude

Claude Code가 시작되면:

/write

스킬 구성

메인 커맨드: /write

전체 글쓰기 세션을 관리하는 코치 커맨드입니다.

기능	설명
세션 관리	워밍업 → 메인 글쓰기 → 리뷰 진행
장르 추천	요일별 장르 자동 추천
진행 추적	XP, 스트릭, 배지 관리
피드백	3단계 피드백 시스템
리포트	주간 성장 리포트 생성

장르별 스킬

스킬	용도	핵심 기능
`daily-journal`	일기/감정 기록	워밍업 질문, 감정 탐색, 공감 피드백
`essay-builder`	에세이/칼럼	구조 설계, AIDA 모델, 논리 점검
`story-crafter`	창작/소설/시	글감 프롬프트, 3막 구조, Show don't tell
`tech-writer`	기술문서/블로그	템플릿, 피라미드 원칙, 명확성 점검
`copywriting`	광고/마케팅	AIDA/PAS 공식, 강력한 동사, CTA 최적화

사용 방법

기본 명령어

# 오늘의 글쓰기 세션 시작 (요일에 맞는 장르 자동 추천)
/write

# 특정 장르로 세션 시작
/write journal    # 일기
/write essay      # 에세이
/write story      # 창작
/write tech       # 기술 글쓰기
/write copy       # 카피라이팅

# 진행 상황 확인
/write status

# 주간 리포트 생성
/write weekly

세션 흐름

┌─────────────────────────────────────────────────────────────┐
│  1️⃣  세션 시작                                              │
│      - 오늘의 장르 확인                                      │
│      - 현재 스트릭 표시                                      │
├─────────────────────────────────────────────────────────────┤
│  2️⃣  워밍업 (5분)                                           │
│      - 마음을 풀어주는 자유 글쓰기                           │
│      - 3가지 프롬프트 중 선택                                │
├─────────────────────────────────────────────────────────────┤
│  3️⃣  메인 글쓰기 (20분)                                     │
│      - 장르별 가이드라인 제공                                │
│      - 오늘의 주제/프롬프트                                  │
├─────────────────────────────────────────────────────────────┤
│  4️⃣  피드백 & 리뷰 (5분)                                    │
│      - 글 공유 → 피드백 수신                                 │
│      - 잘한 점 + 개선점 + 베스트 문장                        │
├─────────────────────────────────────────────────────────────┤
│  5️⃣  세션 완료                                              │
│      - XP 획득, 스트릭 갱신                                  │
│      - 세션 기록 저장                                        │
└─────────────────────────────────────────────────────────────┘

장르별 직접 호출

/write 커맨드의 인자로 장르를 지정하면 해당 장르 스킬이 활성화됩니다:

/write journal    # daily-journal 스킬 활성화
/write essay      # essay-builder 스킬 활성화
/write story      # story-crafter 스킬 활성화
/write tech       # tech-writer 스킬 활성화
/write copy       # copywriting 스킬 활성화

주간 플랜

기본 설정된 주간 글쓰기 플랜:

요일	장르	설명
월	📔 일기	주말 회고, 한 주 시작 마음가짐
화	💻 기술 글쓰기	배운 것 정리, 튜토리얼 작성
수	📝 에세이	의견문, 칼럼, 서평
목	✨ 창작	짧은 소설, 시, 장면 묘사
금	🎯 자유 선택	원하는 장르로 자유롭게
토	🔄 다듬기	이번 주 글 수정/퇴고
일	📊 회고	주간 리포트, 다음 주 계획

플랜 변경하기

progress.json의 weekly_plans 섹션을 수정하세요:

"weekly_plans": {
  "monday": "journal",
  "tuesday": "tech",
  "wednesday": "essay",
  "thursday": "story",
  "friday": "free",
  "saturday": "review",
  "sunday": "retrospective"
}

진행 추적 시스템

XP 시스템

활동	XP
세션 완료	+50 XP
100자당 보너스	+1 XP
새 장르 도전 (주간)	+20 XP
연속 스트릭	+10 XP × 일수
피드백 반영 후 수정	+30 XP

배지 시스템

배지	조건
🌱 첫 발걸음	첫 글쓰기 완료
🔥 불꽃 시작	3일 연속 달성
⚡ 일주일의 기적	7일 연속 달성
🌟 한 달의 여정	30일 연속 달성
📚 다재다능	5가지 장르 모두 경험
✍️ 천 자의 벽	1,000자 이상 글 작성
📖 만 자의 산	10,000자 이상 글 작성
🎯 피드백 마스터	피드백 반영 10회

진행 상황 확인

/write status

출력 예시:

📊 현재 진행 상황
━━━━━━━━━━━━━━━━━━━━━━
🔥 스트릭: 7일 연속
⭐ 총 XP: 1,250 XP
📚 총 글 수: 15편
✍️ 총 글자 수: 12,500자

🏆 획득한 배지
🌱 첫 발걸음 | 🔥 불꽃 시작 | ⚡ 일주일의 기적

피드백 시스템

3단계 피드백

단계	내용
Level 1: 즉시 피드백	맞춤법, 문법, 어색한 표현
Level 2: 구조 피드백	논리 흐름, 단락 구성, 연결
Level 3: 스타일 피드백	문체, 어조, 개성 있는 표현

피드백 스타일 선택

세션 리뷰 시 원하는 스타일을 선택할 수 있습니다:

1️⃣ 전체 피드백 - 구조 + 문체 + 개선점 종합
2️⃣ 격려 중심 - 잘한 점과 가능성에 집중
3️⃣ 교정 중심 - 문법, 맞춤법, 표현 교정

기본 피드백 스타일 변경

progress.json의 settings.feedback_style 수정:

"settings": {
  "feedback_style": "balanced"  // encouraging, balanced, critical
}

블로그 게시

Write-Saver에서 작성한 글을 GitHub Pages 블로그에 게시할 수 있습니다.

블로그 설정

1. GitHub Pages 저장소 생성

# 블로그 저장소 생성 (username.github.io)
cd ~/Work
git clone https://github.com/username/username.github.io.git

# 또는 blog-template 사용
cp -r ~/Work/write-saver/blog-template/* ~/Work/username.github.io/

2. progress.json에 블로그 정보 설정

"blog": {
  "enabled": true,
  "repo_path": "~/Work/username.github.io",
  "username": "username",
  "default_author": "작성자 이름"
}

게시 명령어

/publish              # 최근 글 목록에서 선택하여 게시
/publish today        # 오늘 작성한 글 게시
/publish draft        # 초안으로 저장 (게시 안 함)
/publish list         # 게시된 글 목록 확인

게시 플로우

┌─────────────────────────────────────────────────────────────┐
│  1️⃣  글 선택                                                │
│      - 최근 작성한 글 목록에서 선택                          │
├─────────────────────────────────────────────────────────────┤
│  2️⃣  메타데이터 확인                                        │
│      - 제목, 카테고리, 태그, 설명 확인/수정                  │
├─────────────────────────────────────────────────────────────┤
│  3️⃣  변환 및 게시                                           │
│      - Jekyll 포맷으로 변환                                  │
│      - 블로그 저장소에 commit & push                         │
├─────────────────────────────────────────────────────────────┤
│  4️⃣  완료                                                   │
│      - 게시 URL 확인                                         │
│      - GitHub Actions 빌드 후 1-2분 내 반영                  │
└─────────────────────────────────────────────────────────────┘

장르별 카테고리 매핑

Write-Saver 장르	블로그 카테고리
journal	일상
essay	에세이
story	창작
tech	기술
copy	마케팅

블로그 템플릿

blog-template/ 디렉토리에 Jekyll 기반 블로그 템플릿이 포함되어 있습니다:

blog-template/
├── _config.yml          # Jekyll 설정
├── _posts/              # 게시된 글
├── _drafts/             # 초안
├── index.md             # 홈페이지
├── about.md             # 소개 페이지
├── Gemfile              # Ruby 의존성
└── assets/images/       # 이미지

설정 커스터마이징

progress.json 구조

{
  "user": {
    "started_at": "2025-12-31",
    "total_xp": 0,
    "current_streak": 0,
    "longest_streak": 0,
    "total_sessions": 0,
    "total_words": 0
  },
  "badges": [],
  "genre_stats": {
    "journal": { "count": 0, "total_words": 0 },
    "essay": { "count": 0, "total_words": 0 },
    "story": { "count": 0, "total_words": 0 },
    "tech": { "count": 0, "total_words": 0 },
    "copy": { "count": 0, "total_words": 0 }
  },
  "settings": {
    "daily_reminder": null,
    "preferred_session_length": 30,
    "feedback_style": "balanced"
  }
}

세션 시간 변경

기본 30분에서 변경하려면:

"settings": {
  "preferred_session_length": 20  // 20분으로 변경
}

데이터 저장 위치

~/Work/write-saver/
├── progress.json       # 진행 상황 (XP, 스트릭, 배지)
├── sessions/           # 일일 세션 기록
│   ├── 2025-12-31.md
│   ├── 2025-01-01.md
│   └── ...
└── weekly/             # 주간 리포트
    ├── 2025-W01.md
    └── ...

팁 & 트릭

효과적인 글쓰기 습관

고정 시간 확보: 매일 같은 시간에 글쓰기 (아침 기상 후 or 취침 전)
워밍업 스킵 금지: 5분 워밍업이 메인 글쓰기 품질을 높입니다
완벽 강박 버리기: 초고는 나쁠수록 좋습니다. 수정은 나중에!
스트릭 유지: 바쁜 날엔 짧게라도 쓰세요 (100자도 OK)

슬럼프 탈출

장르를 바꿔보세요
워밍업 프롬프트로만 5분 쓰기
이전에 쓴 글 다시 읽기
/write story로 부담 없는 창작하기

문의 & 기여

문제가 있거나 개선 아이디어가 있다면 이슈를 등록해주세요.

"매일 30분, 1년이면 182시간. 당신의 글쓰기 실력은 반드시 달라집니다." ✍️

Name		Name	Last commit message	Last commit date
Latest commit History 12 Commits
.claude		.claude
blog-template		blog-template
sessions		sessions
weekly		weekly
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
README.md		README.md
progress.json		progress.json

Folders and files

Latest commit

History

Repository files navigation

Write-Saver 📝

목차

시작하기

필수 요구사항

프로젝트 구조

첫 세션 시작

스킬 구성

메인 커맨드: /write

장르별 스킬

사용 방법

기본 명령어

세션 흐름

장르별 직접 호출

주간 플랜

플랜 변경하기

진행 추적 시스템

XP 시스템

배지 시스템

진행 상황 확인

피드백 시스템

3단계 피드백

피드백 스타일 선택

기본 피드백 스타일 변경

블로그 게시

블로그 설정

1. GitHub Pages 저장소 생성

2. progress.json에 블로그 정보 설정

게시 명령어

게시 플로우

장르별 카테고리 매핑

블로그 템플릿

설정 커스터마이징

progress.json 구조

세션 시간 변경

데이터 저장 위치

팁 & 트릭

효과적인 글쓰기 습관

슬럼프 탈출

문의 & 기여

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages