개발 기록을 재료로 AI가 쓰는 블로그 글 만들기
시리즈 Claude Code 워크플로 현재 위치 26 / 31
- git worktree로 AI 세션 여러 개를 동시에 돌리기: 브랜치 충돌과 stash 공유 사고를 피하는 운영 규칙
- AI에게 기억을 심는 법: 메모리 파일로 삽질 교훈을 세션 간에 유지하기
- 스킬로 반복 작업 자동화: 이슈 착수부터 종료까지 한 명령으로 묶은 dev-issue 사례
- 코드 그래프(graft)로 AI의 탐색 비용 줄이기: grep/read 대비 토큰 절감 체감
- AI 코드 리뷰를 규칙으로 고정하기
- 반복되는 Git 워크플로우와 브랜치 정리 자동화
- 같은 요청을 여러 저장소에 반복하는 법: 한 줄 프롬프트 + 기준 문서 하나
- 이슈 하나를 한 줄로 개발 끝내는 법 — 내가 가장 많이 쓰는 Claude Code 스킬들
- 블로그 글을 스무 번 부탁하고 나서, 스킬로 만들었다
- 마라톤 세션이 토큰을 먹는 구조: 로그로 찾고, /compact와 서브에이전트로 줄이기
- 1인 개발자가 클로드코드로 SaaS 11개 만든 기록
- 이슈 하나에 30~60분, 어디서 새고 있었나: skill-creator로 dev-issue 스킬을 만든 과정
- 도면을 AI에게 읽히려다 AI를 뺀 이야기
- 스쿼시 머지 vs 머지 커밋: 1인 개발자의 PR 전략
- "난이도가 높아서 오래 걸리는 거야?" — AIFid 개발 기록으로 따져 본 소요 시간
- 엑셀 간편장부를 웹 ERP로 옮기기 (AICassa)
- Impeccable 스킬 적용한 게시글 상세 화면 구조 개선
- CLAUDE.md로 팀 규칙을 AI에게 가르치는 법
- AI티 나는 디자인 패턴 걷어내기: overused-font 훅 오탐 처리와 접근성 대비 수정
- CI4 브랜드 에러 페이지: 설계서 한 장에서 구현까지
- Claude에 MCP로 디자인 툴 붙이기 — DesignCraft·PhotoCraft 설치부터 명함, 카툰 효과까지
- AI 실수 복구: 메인 체크아웃을 dev 상태로 되돌린 기록
- 870줄 CLAUDE.md를 116줄로 줄인 실전 리팩터링
- AI로 AI 강의안을 만들다 — 실용인문학 5·6강 준비기
- Claude Code 토큰 절감 실전: 3개월 로그 분석과 5단계 전략
- 개발 기록을 재료로 AI가 쓰는 블로그 글 만들기
- Claude Vision으로 영수증·세금계산서 자동 장부 입력 구현
- AI가 만든 실제 실수 4가지 패턴과 교훈
- GitHub 이슈·PR 기반의 월간 작업일지 자동 생성 Claude 스킬 만들기
- Fable 5.2로 스킬 5개 토큰 45% 절감하기
- 12개 SaaS가 함께 쓰는 LangGraph 서버를 설계하며 생긴 일들
시리즈 26년차 개발자 회고 현재 위치 8 / 8
2026년 10월 26일 · @martin
한 줄 요약: 글은 AI가 쓰고, 재료는 내 작업 기록에서만 가져오게 한다. 기록에 없는 내용은 AI가 스스로 "이건 지어낸 부분"이라고 밝히게 만든다.
왜 블로그를 AI에게 맡기게 됐나
지난 1년 동안 Claude Code로 솔루션 11개를 혼자 만들었다. 기획부터 서버 배포, 운영까지 전부 내 손을 거친다. 그러다 보니 매일 뭔가를 고치고, 막히고, 해결한다. 문제는 그 경험이 대화창 안에서 끝나버린다는 점이었다.
26년 동안 개발하면서 "이건 글로 남겨야지" 하고 넘긴 게 수백 건은 된다. 실제로 쓴 건 손에 꼽는다. 코드 짜는 시간과 글 쓰는 시간이 같은 자리를 놓고 싸우면, 늘 코드가 이긴다.
그래서 방향을 바꿨다. 글은 AI에게 맡기고, 나는 재료와 검수만 맡는다. 지금 미단재(jblove.net)에 올라가는 개발 글 대부분이 이 방식으로 나온다. Pagus 개발기, prune-branch 스킬, 네이버 연동, 프론트 로그 수집 파이프라인 같은 글들이다.
원칙: 쓰는 건 AI, 재료는 내 기록
AI에게 "Claude Code 활용법 블로그 글 써줘"라고 하면 인터넷 어디서나 볼 법한 글이 나온다. 틀린 말은 없는데 내 글이 아니다. 독자가 내 블로그에 오는 이유는 일반론이 아니라 내가 실제로 겪은 삽질이다.
그래서 요청할 때 항상 한 문장을 붙인다. "내 기록을 바탕으로." 이 한마디로 AI가 하는 일이 바뀐다. 웹을 뒤지기 전에 먼저 두 곳을 본다.
- 메모리 — Claude가 대화에서 정리해 둔 내 프로젝트와 환경 정보. 어떤 제품을 운영하는지, 서버가 몇 대인지, 블로그 이름이 뭔지 같은 것들이다.
- 지난 대화 — 실제로 문제를 풀었던 대화 기록. 에러 메시지, 시도했다 실패한 방법, 최종 해결책이 그대로 남아 있다.
메모리는 용어 습관까지 기억한다. 예를 들어 { status, data, message } 구조를 나는 "응답 래퍼"라고 부른다. 한번 정해두면 이후 글에서 다른 이름으로 쓰지 않는다. 25년 넘게 써 온 내 말투가 글에 그대로 남는 이유다.
작업 흐름: 여섯 단계

처음과 끝은 내가, 가운데 네 단계는 AI가 맡는다. 점선이 이 방식의 핵심이다. 기록에 없는 내용은 그냥 넘어가지 않고 다시 찾거나 내가 채운다.
- 주제 뽑기 — "최근 작업 내역 보고 블로그 주제 추천해줘"로 시작한다. AI는 이미 올린 글을 빼고, 바로 쓸 수 있는 것과 정리가 더 필요한 것으로 나눠서 준다. 최근에는 공개 저장소 봇 트래픽, 에디터가 CSS를 지워버린 문제, 집 우분투에 셀프호스티드 러너를 올린 이야기 등 11개가 나왔다.
- 기록 검색 — 고른 주제로 메모리와 지난 대화를 검색한다. 키워드 하나로는 잘 안 걸린다. "worktree 브랜치 정리 원격", "gh pr list merged"처럼 여러 번 좁혀 들어가야 실제 해결 과정이 나온다.
- 골격 세우기 — 본문을 쓰기 전에 섹션 제목과 각 섹션에 들어갈 내용만 먼저 잡는다. 내 글은 대체로 같은 뼈대를 쓴다. 한 줄 요약 → 단계별 본문 → 돌아보며 → 이 순서로.
- 섹션 채우기 — 한 번에 전체를 쓰지 않고 섹션 하나씩 채운다. 쓰는 도중에 방향이 틀어지면 그 섹션에서 바로 멈출 수 있다.
- 이미지 — 아키텍처나 흐름은 다이어그램으로 그리고 PNG로 뽑는다. 한글이 깨지지 않게 CJK 폰트로 렌더링하고, 블로그용으로 흰 배경에 2배 해상도로 만든다. 이 글의 그림도 같은 방식이다.
- 검수 · 게시 — AI가 표시한 "기록에 없는 부분"을 읽고, 내 실제 경험으로 바꾸거나 지운다. 그다음에 올린다.
요청은 짧게, 규칙은 분명하게
요청 문장은 길 필요가 없다. 내가 실제로 쓰는 형태는 대략 이렇다.
prune-branch 스킬이 생긴 배경 - 내 기록을 바탕으로 블로그에 올릴 글 작성해줘.
코드는
로 감싸고, 코드 안의 < > & 는 이스케이프해줘.
중요한 건 길이가 아니라 형식 규칙이다. 내 블로그 에디터는 코드 블록을형태로 받는다.
코드 안의<,>,&를 엔티티로 바꾸지 않으면 PHP 코드가 HTML로 해석돼 화면에서 사라진다.
이 규칙을 한 번 정해두니 붙여넣고 바로 올릴 수 있게 됐다.
AI가 규칙을 무작정 따르지 않는다는 점도 좋았다. prune-branch 글은 예제가 셸 스크립트와 SKILL.md였다. AI는 language-php 대신 language-bash, language-markdown을 쓰고, 왜 바꿨는지 따로 알려줬다. 지시를 지키는 것과 맞게 쓰는 것이 부딪힐 때, 말없이 고르지 않고 물어보는 쪽이 낫다.
기록이 없을 때가 진짜 시험이다
가장 위험한 순간은 기록이 없는데 글은 써야 할 때다. AI는 빈칸을 그럴듯한 내용으로 채우는 데 능하다. 1인칭으로 "이렇게 해결했다"고 쓰면 독자는 그게 내 경험인 줄 안다.
실제로 두 번 그런 상황이 있었다.
- 네이버 연동 글 — 소셜 로그인, 쇼핑 검색 API, 서치어드바이저 인증 세 가지를 다루려 했다. 그런데 과거 대화를 아무리 뒤져도 이 작업 기록이 거의 없었다. AI는 공식 문서와 뉴스를 찾아서 글을 쓰되, 끝에 세 가지를 나눠서 밝혔다. 출처로 확인한 내용, 내 기록에서 온 내용, 경험담처럼 쓰였지만 일반 지식인 내용. 쇼핑 API 종료 날짜는 원문을 못 열었으니 게시 전에 직접 확인하라는 말도 붙였다.
- AI 메모리 파일 글 — ".env 값에는 따옴표", "error_log를 믿지 마라" 두 교훈을 다루는 글이었다. 이 두 건도 기록에서 찾지 못했다. AI는 예시로 만든 장면 세 군데를 콕 집어서, 내 실제 경험으로 바꿔 달라고 했다.
나는 이걸 규칙으로 굳혔다. 기록에서 온 것과 AI가 구성한 것을 반드시 나눠서 알려줄 것. 이 표시가 있으니 검수가 빨라진다. 전체를 의심하며 읽을 필요 없이, 표시된 부분만 보면 된다.
돌아보며
- 글의 가치는 재료에서 나온다. AI의 문장력은 이미 충분하다. 차이를 만드는 건 그 안에 내 에러 메시지, 내 실패, 내 결정이 들어 있느냐다.
- 기록이 쌓일수록 글이 쉬워진다. 대화에서 문제를 풀 때마다 그게 다음 글의 재료가 된다. 따로 메모할 필요가 없다는 게 가장 큰 변화였다.
- 구분 표시가 검수 시간을 줄인다. "이 부분은 지어냈다"는 표시 하나로, 의심하며 읽던 시간이 확인만 하는 시간으로 바뀐다.
- 형식 규칙은 한 번만 정하면 된다. 코드 블록 형태, 용어, 글 뼈대를 정해두면 매번 설명하지 않아도 된다.
- 쓰는 일을 넘겨도 판단은 내 몫이다. 무엇을 쓸지, 무엇을 지울지, 올릴지 말지는 여전히 내가 정한다. 26년 동안 쌓은 건 코드보다 이 판단이다.
이 순서로 해보세요
- 평소 문제를 AI와 대화하며 푼다. 에러 메시지와 시도한 방법을 대화에 그대로 남긴다.
- AI의 메모리 기능과 지난 대화 검색 기능을 켠다.
- 블로그 형식 규칙을 정한다. 코드 블록 태그, 이스케이프, 자주 쓰는 용어, 글 뼈대.
- "최근 작업 보고 블로그 주제 추천해줘"로 후보를 받는다. 이미 쓴 글은 빼달라고 한다.
- 주제를 골라 "내 기록을 바탕으로 글 작성해줘"라고 요청한다.
- 기록에서 온 내용과 AI가 구성한 내용을 나눠서 표시해 달라고 한다.
- 흐름이나 구조는 다이어그램 PNG로 받는다.
- 표시된 부분을 내 경험으로 바꾸거나 지운 뒤 게시한다.
글 쓰는 시간이 없어서 기록을 못 남기던 26년이었다. 이제는 일하는 과정이 곧 글의 재료다.

댓글 1
블로그 글 써달라는 것도 계속 반복이 되니 스킬을 만들었다. /blog-post