블로그 스킬과 콘텐츠 지식베이스 만들기
2026.10.15

목표
1주차에 키워드 분석기와 글감 대시보드를 만들었지만, 글 한 편을 쓰는 방법은 매번 대화로 다시 설명해야 했어요. 자료도 여러 폴더에 흩어져 있었어요. 2주차 교안 두 개를 기준으로 두 가지를 했어요.
블로그 글 한 편을 만드는 순서를 스킬로 저장하고, 블로그 기준 문서(기획서)를 보완하기
콘텐츠 지식베이스 폴더를 정비하고, 키워드 분석부터 다음 글까지 이어지는 워크플로우 설계하기
사용한 도구
도구 | 역할 |
|---|---|
Claude Code | 스킬 작성, 기획서 보완, 캔버스 인터뷰, 폴더 설계 검증 |
Codex | 폴더 이전 구현, 캔버스와 스킬 연결 보완, 워크플로우 그림 |
키워드 분석기 · 글감 대시보드 | 1주차에 만든 도구. 그대로 두고 새 구조에 연결 |
진행한 일
1. 블로그 작성 스킬 만들기 · 기획서 보완
기준: 이안님 「내 블로그 제작 스킬 만들기」, 조셉님 「콘텐츠 브랜드 캔버스」
첫 글로 순서를 확인했어요.
교안의 순서(글감 전달 → 블로그 기준 → 자료 확인 → 목차·본문 → 문체 교정 → 이미지 → 미리보기)대로 01편을 직접 끝까지 만들었어요.
그 순서를 스킬로 저장했어요.
13단계 글쓰기 스킬(saltdown-post)을 만들고, 글마다 폴더 하나에 브리프·출처·이미지 계획·원고·미리보기·진행 기록을 남기게 했어요. 목차 확인과 발행 직전, 두 번 멈춰 사용자에게 확인받아요.
어떤 AI든 같은 절차를 쓰게 했어요.
스킬과 공통 지침을 프로젝트 폴더에 두어 Claude, Codex 모두 같은 파일을 읽어요.
캔버스 인터뷰로 기준을 좁혔어요.
조셉님 캔버스 01~10을 AI 인터뷰로 채우고, 그 결과를 기획서에 넣었어요.
캔버스 칸을 스킬 단계에 연결했어요.
칸마다 반영 위치를 정해, 브리프·목차·제목·점검·발행 기록 단계에서 쓰이게 했어요.
[이전보다 좋아진 점 5가지]
글 한 편의 절차가 고정됐어요
전: 매번 대화로 순서를 설명 → 후: "02편 진행"만 말하면 13단계와 글별 폴더대로 진행, 멈춤 2번
AI 검색에 인용되기 좋은 본문 규칙이 생겼어요
전: 규칙 없음 → 후: 질문형 소제목 바로 아래 답(AEO), 적용 조건·예외(GEO), 수치 옆 기준일·단위와 출처 링크
독자와 차별점이 좁혀졌어요
전: "저염 식단이 필요한 사람 전체" → 후: 인기 음식·제품 앞에서 맛과 성분을 걱정하는 혈압·신장·콜레스테롤 관리자와 가족. 차별점 맨 앞 "내돈내산으로 먹어 보고, 재 보고 알려줘요"
질문마다 답하는 형식이 정해졌어요
전: 글마다 형식을 새로 고민 → 후: 내돈내산 후기+성분표, 실측 리포트, 레시피, 외식 리뷰, 체크리스트+성분 지식, 실패담+대체 방안. 실측은 측정 조건을 설명할 수 있을 때만
제목·태그를 검색량으로 골라요
전: 감으로 → 후: 띄어쓰기 없는 짧은 단어로 검색광고 월 검색수를 조회해 후보를 만들고, 결정은 사용자
2. 콘텐츠 지식베이스 정비 · 워크플로우 설계
기준: 조셉님 「콘텐츠 워크플로우」 (0 수집함 · 1 재료 · 2 규칙 · 3 발행 · 9 보관)
원본 구조를 내 시스템과 비교했어요.
Codex와 교안 구조를 지금의 분석기·대시보드·글 폴더에 맞게 바꾼 설계안을 만들었어요.설계안을 실제 코드로 검증했어요.
Claude에게 "이거 검증해봐"라고 맡겨, 경로를 쓰는 코드·문서와 깨질 수 있는 기능을 확인하고 결정할 것 8개를 하나씩 정했어요.백업 후 이전했어요.
기존 글 폴더와 기획서·가이드를 새 구조로 옮기고, 대시보드 테스트 40개 통과를 확인했어요.워크플로우를 그림으로 정리했어요.
키워드 분석부터 다음 글 반영까지를 한 장으로 그렸어요.
폴더 AS-IS vs TO-BE
AS-IS 폴더 구조
blog/
├─ branding/ 기획서 · 브랜딩 자료
├─ guides/ 신상보호 가이드 · 염도계 환산법
├─ drafts/ 글 폴더 (재료와 작업물이 함께)
│ ├─ 01_하루나트륨권장량/
│ │ └─ brief · sources · images · post · preview · progress · history
│ ├─ 02_나트륨배출물/
│ └─ …
├─ research/archive/ 옛 리서치
├─ writing-dashboard/ 글감 대시보드 (dashboard.db)
├─ keyword-analyzer → 키워드 분석기 바로가기 (keywords.db · 날짜별 보고서)
├─ skills/ 글쓰기 스킬
└─ worklog/ 작업 기록TO-BE 폴더 구조
contents/
├─ INDEX.md 실제 데이터 위치와 운영 규칙
├─ 0_수집함/
│ ├─ 현장_기록/ 확인 전 사진·수치·메모
│ ├─ 발행_반응/ D+1·7·14·30 반응
│ └─ 질문_검색어_후보/
├─ 1_재료/ 경험 · 방법 · 질문 · 근거 · 미디어
├─ 2_규칙/ 기획서 · 브랜드 캔버스 · 가이드 · 잘_된_패턴
├─ 3_발행/
│ ├─ 블로그/NN_키워드/ brief · sources · images · post · preview · progress
│ ├─ 인스타그램/
│ └─ 유튜브/
└─ 9_보관/ 중단_콘텐츠 · 이전_원고 · 옛_리서치워크플로우

구현하면서 검토한 것
자동 수집 키워드 데이터 DB는 재료 폴더로 옮기지 않고 위치만 연결했어요
교안 프롬프트는 "키워드 레이더의 질문 후보와 검색량 → 1 재료(질문)"로 넣게 되어 있어요. 이 블로그는 키워드 분석기와 글감 대시보드가 이 데이터를 이미 DB로 관리하고 있었어요. 키워드 분석기는 매일 아침 자동으로 돌고, macOS 보안 때문에 바탕화면 밖 폴더에 있어야 자동 실행돼요. 글감 대시보드는 분석기 DB를 직접 읽어요. DB를 옮기면 자동 수집과 대시보드가 멈추고, 복사하면 같은 데이터가 두 곳에서 달라져요. 그래서 DB는 제자리에 두고 INDEX.md에 위치만 적었어요.
글 폴더(drafts/)를 옮기기 전에, 글 폴더와 연결된 대시보드 코드를 먼저 확인했어요
글감 대시보드는 채택한 글감의 글 폴더를 만들고, 그 폴더의 진행 기록(progress.md)을 읽어 '작성 중'을 '발행 완료'로 바꿔요. 그래서
drafts/를3_발행/블로그/로 옮기면 대시보드가 깨질 수 있었어요. 코드를 열어 보니 글 폴더 위치는 설정 한 곳에서만 정해서, 설정만 바꾸면 됐어요. 대신 Codex 설계안의 '발행 후 남길 파일'은 brief·sources·최종 원고·발행 주소·날짜·이미지였고, 대시보드가 발행 완료를 판정하는 progress.md가 빠져 있었어요. 설계안은 발행 뒤 파일 정리까지 검토하고 있어서, 그대로 정리했다면 대시보드가 발행 여부를 모르고 "폴더를 찾지 못했어요"를 띄웠을 거예요. 그래서 progress.md를 보존 목록에 넣었어요.
발행이 끝난 글에도 진행 기록(progress.md)을 남겨요
발행이 끝난 글 폴더에서 어떤 파일을 남기고 어떤 파일을 지울지 검토하다 나온 결정이에요. progress.md는 글 한 편의 작업 체크리스트예요. 글쓰기 13단계마다 끝났는지(✅)를 표시하고, 마지막 발행 단계에 발행 시각과 네이버 주소를 적어요. 최종 원고인 post.md가 있는데도 이 파일을 지우지 않은 이유는 두 프로그램이 이 파일을 읽기 때문이에요. 글감 대시보드는 발행 단계의 ✅와 주소를 보고 글감 상태를 '작성 중'에서 '발행 완료'로 바꿔요. 반응 수집기는 여기 적힌 발행 시각으로 D+1·7·14·30 날짜를 계산해요. post.md는 글 내용만 담고 있어서 이 역할을 대신할 수 없어요. post.md에도 주소가 있지만, 발행 완료(✅)와 시각이 정해진 자리에 있는 건 progress.md뿐이에요.
배운 점
이미 만든 시스템이 있으면 교안이나 레퍼런스 프롬프트를 그대로 따르지 않고 맞게 바꿔 적용해요
문제: 교안이나 레퍼런스 프롬프트의 구조가 이미 만든 구조·시스템과 맞지 않는데 그대로 따르면, 이미 돌아가는 시스템이 깨질 수 있어요.
해결: 교안이나 레퍼런스 구조를 적용하기 전에 "이 데이터는 지금 어느 프로그램이 관리하나"를 먼저 정리해요. 프로그램이 관리하는 것은 제자리에 두고 위치만 연결해요.
AI끼리 만든 설계는 다른 AI가 코드로 검증하게 해요
문제: 설계안만 보면 그럴듯해도, 실제 프로그램이 읽는 파일을 놓칠 수 있어요.
(이번에 놓친 것: 발행 후 보존 목록의 progress.md 누락, 설계안 상태 7단계와 DB 상태(4개) 불일치 포함 6건)해결: "설계안이 옮기거나 지우거나 바꾸는 것마다, 그걸 읽고 쓰는 프로그램이 있는지 코드에서 하나씩 찾아줘"라고 요청해요.
이후 계획
자동화로 작성한 블로그의 반응 확인
키워드레이더 대시보드 서버 상시 띄우기
GEO·AEO 스킬 강화
인스타그램 분석 추가, 쇼츠 발행
참고 문서
이안님 · 내 블로그 제작 스킬 만들기 (GPTERS 24기 콘텐츠 발행 자동화 2주차)
조셉님 · 2주차 보조교안 「콘텐츠 브랜드 캔버스」「콘텐츠 워크플로우」
로그인하고 댓글을 남겨 주세요
oatmeal님, 안녕하세요.
조셉입니다. ^^
교안 구조를 적용하기 전에 "이 데이터는 지금 어느 프로그램이 관리하나"를 먼저 정리하신 대목에서 고개가 끄덕여졌습니다.
제가 드린 콘텐츠 워크플로우를 그대로 옮기지 않고, 매일 도는 분석기의 DB는 제자리에 둔 채 위치만 연결하셨습니다. 어떤 틀이든 이미 돌아가는 현장에 맞춰 얹을 때 제 몫을 한다고 저는 봅니다. 본인만의 구조와 스타일로 개발을 하는 것이 정답입니다.
발행 완료 판정에 쓰이는 progress.md를 보존 목록에 넣으신 장면에서 그 생각이 더 굳어졌습니다.
캔버스 인터뷰로 독자를 혈압·신장·콜레스테롤 관리자와 가족까지 좁히고, 실측은 측정 조건을 설명할 수 있을 때만 쓰게 하신 판단도 좋았습니다.
이만큼 좁힌 독자라면 반응을 읽는 눈도 달라져야 할 것 같습니다. 10편 발행 뒤 패턴을 볼 때 조회수가 높은 글과 관리하는 가족이 실제로 찾아와 머문 글이 다를 수 있으니, 어떤 숫자나 댓글을 그 신호로 삼으실지 궁금합니다.
직접 먹어 보고 재 본 기록이 쌓여 독자의 식탁을 돕는 블로그가 되어 가는 과정을 계속 지켜보겠습니다.
수고하셨습니다.




oatmeal님, 글 한 편을 만드는 순서를 스킬로 남기는 일과 기존 분석기·대시보드의 연결을 지키는 일을 함께 다루셨네요. 캔버스의 각 항목을 브리프와 목차, 점검 단계에 연결한 덕분에 기획서가 실제 글쓰기에서 어디에 쓰이는지도 보였습니다.
특히 폴더를 옮기기 전에 그 경로를 읽는 코드를 확인하고, 자동 수집 DB는 제자리에 둔 판단이 구체적이었습니다. 보기 좋은 폴더 구조를 적용할 때 기존 프로그램의 역할까지 확인해야 한다는 점을 실제 사례로 보여 주셨네요. 백업과 이전 후 테스트 결과도 함께 남겨 주셨고요.
progress.md가 최종 원고와 다른 역할을 한다는 설명이 가장 기억에 남습니다. 대시보드의 발행 상태와 반응 수집 날짜가 그 파일에 연결되어 있으니 보존 목록의 작은 누락도 운영에 영향을 주겠어요. 다른 AI에게 설계안의 변경 항목마다 실제 호출자를 찾아보게 한 요청은 재사용할 만합니다.
다음 글에서는 새 구조에서 글감 선택부터 원고 작성, 발행 기록과 반응 확인까지 한 편이 이어지는 모습을 보여 주시면 좋겠습니다. 절차가 13단계인 만큼 반복할 때 도움이 된 단계와 손이 많이 간 단계도 구분해 보면 스킬을 다듬기 쉬울 듯해요. 이번에 지킨 연결들이 다음 글을 만드는 수고를 얼마나 줄이는지 궁금합니다.