Day 5: 주간 회고 & 블로그 작성
AI Tools Mastery Curriculum — Week 1, Day 5 소요 시간: 40분 | 작성 중심
핵심 배운 점
- Before/Action/After 형식으로 체험 정리
- 블로그 톤은 “가르치기”가 아니라 “함께 배운 것 나누기”
- 가장 임팩트 큰 2
3가지에 집중 (2,0003,000단어)
① 1주차 학습 내용 정리
5일간 배운 것 한눈에 보기
Day 1: CLAUDE.md ──────── "프로젝트의 기억"
Day 2: 체이닝 & Plan Mode ── "대화형 협업"
Day 3: 서브 에이전트 & 컨텍스트 ── "위임과 정리"
Day 4: Skills & Hooks ────── "자동화된 지식과 규칙"
Day 5: 회고 & 블로그 ────── "배운 것을 자기 것으로"
핵심 개념 관계도
이번 주에 배운 것들은 독립적이 아니라 서로 연결되어 있다:
┌─ CLAUDE.md ──────────────────────────────────┐
│ 항상 로드 / 150줄 이내 / HOW 50% │
│ │
│ ┌─ Skills ───────────────┐ │
│ │ 필요시 로드 │ │
│ │ description이 트리거 │ │
│ │ references/로 분리 │ │
│ └────────────────────────┘ │
│ │
│ ┌─ 체이닝 ──────────────────────────┐ │
│ │ 분석 → 설계 → 구현 → 검증 │ │
│ │ Plan Mode = 시스템 레벨 읽기전용 │ │
│ │ plan.md = 세션 넘나드는 기억 │ │
│ └───────────────────────────────────┘ │
│ │
│ ┌─ 서브 에이전트 ───────┐ ┌─ Hooks ───────┐│
│ │ 컨텍스트 격리 │ │ 이벤트 자동화 ││
│ │ 병렬 처리 (최대 10) │ │ 0=허용 2=차단 ││
│ │ /compact /clear 관리 │ │ 프롬프트=제안 ││
│ └───────────────────────┘ │ 훅=보장 ││
│ └────────────────┘│
└───────────────────────────────────────────────┘
Day별 핵심 한 줄 요약
| Day | 핵심 한 줄 |
|---|---|
| Day 1 | CLAUDE.md는 매뉴얼이 아니라 “Claude가 틀리는 것을 교정하는 노트” |
| Day 2 | 복잡한 작업은 한 번에 시키지 말고 단계별로 나눠서 중간 검증 |
| Day 3 | 탐색은 서브 에이전트에 위임하고 메인 컨텍스트는 깨끗하게 유지 |
| Day 4 | 반복하는 지식은 Skills로, 반복하는 행동은 Hooks로 자동화 |
자기 점검 체크리스트
## Week 1 자기 점검
### CLAUDE.md
- [ ] 실무 프로젝트에 CLAUDE.md를 작성했다
- [ ] WHAT/WHY/HOW 구조를 따르고 HOW에 비중을 뒀다
- [ ] 150줄 이내로 유지하고 있다
- [ ] 적용 전/후 응답 품질 차이를 확인했다
### 체이닝 & Plan Mode
- [ ] 동일 태스크를 단일 vs 체이닝으로 비교해봤다
- [ ] 역할 분리(분석→설계→구현→검증) 패턴을 1회 이상 사용했다
- [ ] Plan Mode(Shift+Tab×2)를 사용해봤다
- [ ] plan.md에 작업 계획을 저장해봤다
### 서브 에이전트 & 컨텍스트
- [ ] 서브 에이전트로 코드베이스 탐색을 해봤다
- [ ] /compact를 수동으로 실행해봤다 (50%에서)
- [ ] /clear로 새 작업을 시작해봤다
- [ ] /stats로 토큰 사용량을 확인해봤다
### Skills & Hooks
- [ ] 커스텀 스킬 1개를 직접 만들었다
- [ ] 스킬이 자동으로 트리거되는 것을 확인했다
- [ ] Hook을 1개 이상 설정했다 (포맷팅 or 명령 차단)
- [ ] .claude/ 폴더를 GitHub에 공유했다② 실무 적용 사례 문서화
블로그를 쓰기 전에, 이번 주에 실제로 적용한 사례를 정리한다. “배웠다”와 “적용했다”는 다르다. 블로그 독자에게 와닿는 건 후자다.
사례 정리 템플릿
각 Day에서 실제로 해본 것 중 가장 인상적인 것을 1개씩 골라 정리한다:
## 적용 사례 #1: CLAUDE.md로 응답 품질 개선
### 상황 (Before)
- Claude Code에 "테스트를 작성해줘"라고 요청
- LocalDateTime을 사용하고, @SpringBootTest로 전체 컨텍스트 로딩
- 프로젝트 컨벤션과 다른 코드가 생성됨
### 적용 (Action)
- CLAUDE.md에 코딩 컨벤션 3가지를 추가
- OffsetDateTime 사용
- @WebMvcTest 사용
- WebClient maxConnections=10
### 결과 (After)
- 동일 프롬프트로 재실행 시 컨벤션을 모두 준수
- 수동 수정 필요 포인트: 5개 → 1개로 감소
- 스크린샷: [Before] [After]## 적용 사례 #2: 체이닝으로 리팩토링 품질 향상
### 상황 (Before)
- 단일 프롬프트로 "리팩토링해줘"
- Claude가 분석 없이 바로 코드 작성, 기존 패턴 무시
### 적용 (Action)
- 4단계 체이닝: 분석 → 계획 → 구현 → 테스트
- 2단계에서 계획을 확인하고 방향 수정
### 결과 (After)
- 2단계에서 숨겨진 의존 관계를 발견
- 단일 프롬프트였으면 놓쳤을 부분을 사전에 포착
- 최종 코드 품질: 4/5 (단일 프롬프트 시 2/5)## 적용 사례 #3: 서브 에이전트로 코드베이스 분석
### 상황 (Before)
- 새 프로젝트(또는 오랜만에 보는 모듈) 파악에 1-2시간 소요
- 메인 대화에서 직접 탐색하면 컨텍스트가 금방 차서 후속 작업 어려움
### 적용 (Action)
- 3개 서브 에이전트 병렬 투입 (API / 서비스 / 데이터 레이어)
- 각 서브 에이전트가 분석 결과를 파일로 저장
- 메인에서 통합 문서 생성
### 결과 (After)
- 분석 시간: 1-2시간 → 15분
- 메인 컨텍스트: 깨끗하게 유지되어 후속 작업 바로 가능
- analysis/ 폴더의 문서를 팀에도 공유 가능사례가 잘 안 떠오를 때
아직 실무에 적용을 많이 못 했더라도 괜찮다. Day 1~4에서 연습으로 해본 것도 사례가 된다.
중요한 건 Before/Action/After 구조로 정리하는 것이다. 독자가 “나도 이런 상황인데, 이렇게 하면 되는구나”라고 느끼게 만드는 게 핵심이다.
③ 블로그 초안 작성 및 발행
블로그 구조 추천
# 클로드 코드 제대로 쓰기 — 5일간의 변화
## 도입: 나는 Claude Code를 얼마나 비효율적으로 쓰고 있었나
- 단일 프롬프트에 모든 걸 때려넣던 시절
- "이거 왜 내가 원하는 대로 안 나오지?" 의 반복
## 1. CLAUDE.md — 가장 임팩트 큰 한 가지
- WHAT/WHY/HOW 프레임워크
- 150줄 규칙과 그 이유
- Before/After 비교 (스크린샷)
## 2. 프롬프트 체이닝 — "한 번에 시키지 마라"
- 단일 vs 체이닝 비교 실험 결과
- 역할 분리 패턴 (분석→설계→구현→검증)
- Plan Mode로 분석에 집중하기
## 3. 서브 에이전트 — "비서를 보내라"
- 컨텍스트 격리가 왜 중요한지
- 병렬 탐색으로 대규모 코드베이스 분석
- /clear, /compact 습관 들이기
## 4. Skills & Hooks — "자동화의 시작"
- Skills: 반복하는 지식의 패키지화
- Hooks: 프롬프트는 제안, 훅은 보장
- .claude/ 폴더를 팀에 공유하기
## 마무리: 1주일 전의 나에게 해주고 싶은 말
- 가장 체감이 컸던 것
- 다음 주 계획 (AI 도구 생태계 확장)블로그 작성 팁
첫째, “가르치려 하지 말고 과정을 보여줘라.”
❌ "CLAUDE.md는 Claude Code가 세션 시작 시 읽는 파일입니다."
(공식 문서를 읽는 느낌)
✅ "처음엔 CLAUDE.md 없이 써봤다. 같은 프롬프트를 날렸는데
LocalDateTime을 쓰길래 '아 또...' 싶었다.
CLAUDE.md에 딱 3줄 추가하고 다시 해봤더니..."
(체험을 공유하는 느낌)
둘째, 스크린샷은 힘이 세다.
Before/After 스크린샷이 있으면 글의 설득력이 완전히 달라진다. Day 1에서 비교 실험했던 스크린샷을 반드시 포함한다.
셋째, 코드 블록은 실행 가능하게.
독자가 복사해서 바로 사용할 수 있는 코드를 포함한다:
- CLAUDE.md 템플릿
- 프롬프트 체이닝 예시
- SKILL.md 예시
- Hook 설정 JSON
넷째, 분량은 읽는 시간 5~7분을 목표로.
기술 블로그 독자의 평균 집중 시간을 고려하면 2,0003,000단어가 적당하다.
이번 주 배운 내용을 전부 쓰려고 하면 너무 길어지니, **가장 임팩트 큰 23가지에 집중**한다.
Claude를 활용한 블로그 작성 워크플로우
Claude Code 자체를 활용해서 블로그를 효율적으로 쓸 수 있다:
# Step 1: Plan Mode로 블로그 구조 잡기
[Plan Mode]
> 이번 주 Claude Code 학습 내용을 기술 블로그로 쓰려고 해.
독자는 Claude Code를 기본적으로 쓸 줄 아는 백엔드 개발자야.
5~7분 읽을 분량으로 구조를 잡아줘.
가장 임팩트 큰 내용 3가지를 중심으로.
# Step 2: 섹션별 초안 작성
[Normal Mode]
> 위 구조에서 1번 섹션(CLAUDE.md)의 초안을 작성해줘.
Before/After 비교를 중심으로, 경험을 공유하는 톤으로.
# Step 3: 전체 통합 및 퇴고
> 전체 초안을 이어붙이고, 도입부와 마무리를 추가해줘.
톤을 "가르치는 느낌"에서 "같이 배운 것을 나누는 느낌"으로 조정해줘.발행 전 체크리스트
## 블로그 발행 전 체크리스트
### 내용
- [ ] 실무 프로젝트 코드나 회사명이 노출되지 않았는가
- [ ] 예시가 일반적인 도메인(LMS 등)으로 대체되었는가
- [ ] Before/After 비교가 1개 이상 포함되어 있는가
- [ ] 독자가 복사해서 바로 쓸 수 있는 코드 블록이 있는가
### 구조
- [ ] 도입부가 3문장 이내에 "왜 읽어야 하는지"를 알려주는가
- [ ] 각 섹션의 핵심이 소제목만 봐도 파악되는가
- [ ] 마무리에 다음 액션(다음 주 예고 등)이 있는가
### 형식
- [ ] 읽는 시간이 5~7분(2,000~3,000단어)인가
- [ ] 스크린샷이 적절한 크기와 화질인가
- [ ] 코드 블록에 언어 표시(```java, ```bash 등)가 되어 있는가
- [ ] 외부 링크(참고 리소스)가 정상 동작하는가실습 과제
과제 1: 자기 점검 (5분)
체크리스트를 보고 이번 주 학습 완료도를 점검한다. 미완료 항목이 있다면 블로그 작성 전에 빠르게 보충한다.
과제 2: 사례 정리 (10분)
Before/Action/After 형식으로 최소 2개 사례를 정리한다. 스크린샷이 있으면 최고, 없으면 코드 비교로 대체한다.
과제 3: 블로그 초안 작성 (25분)
위 구조를 참고해서 블로그 초안을 작성한다. 완벽하지 않아도 된다. 초안을 쓰고 나서 Claude에게 퇴고를 부탁할 수 있다.
오늘의 핵심 정리
| 포인트 | 설명 |
|---|---|
| 정리의 가치 | 배운 것을 구조화해야 자기 것이 됨 |
| 사례 문서화 | Before/Action/After 형식으로 체험을 정리 |
| 블로그 톤 | ”가르치기”가 아니라 “함께 배운 것 나누기” |
| 핵심 집중 | 4일치 전부 쓰지 말고 가장 임팩트 큰 2~3가지 |
| 실용적 코드 | 독자가 복사해서 바로 쓸 수 있는 코드 블록 필수 |
| 보안 체크 | 실무 코드/회사명 노출 여부 반드시 확인 |
참고 리소스
- 기술 블로그 작성: How to Write a Technical Blog Post — 구조화 가이드
- Claude Code 활용 블로그 예시: Mastering the Vibe
- Anthropic 공식: Claude Code Best Practices