개발 기록 2026-11-02 13~19시: 기술 아티클 연속 발행, 학습 일지 자동 발행 전환, 크몽 전자책 링크 연결

오후 13시부터 19시까지 블로그 작업을 정리한다. 기술 아티클 발행, 메뉴와 화면 수정, 크몽 전자책 링크 연결, 학습 일지 자동 발행 방식 변경이 주 작업이었다. 이벤트 소싱 예제와 AI 스킬 설치도 이 시간대에 함께 진행했다.

외부 가이드 사이트 분석 글 연속 발행

/blog-tech-article 스킬에 가이드 사이트 주소를 넣어 분석 글을 차례로 발행했다. 발행 뒤에는 공개 확인 스크립트로 페이지 200 응답, /articles 목록 노출, 이미지 2개를 확인했다.

• Claude Code 프롬프트 라이브러리: 카드 52개를 직접 셌다. 단계별로는 발견 7, 디자인 6, 구축 22, 배포 5, 운영 12개였다.
• ChatGPT 직무 가이드: 프롬프트 20개를 4개 분야에 5개씩 나눠 정리했다. 공통 구조는 "할 일 / 맥락 / 출력 형식" 세 문장이었다. 앞 글과 비교표를 넣고 링크했다.
• Gemini 작성 가이드: 주소의 첫 페이지에는 공통 설명만 있었다. 실제 예시는 직무별 하위 페이지 11개에 있어서 모두 받아 셌다. 세부 직무 29개, 사용 사례 79개, 프롬프트 173개였다.
• Microsoft Copilot 프롬프트 갤러리: 카드 129개를 모두 셌고, 페이지의 총수와 맞았다. Copilot Chat이 119개, Copilot Cowork가 10개였다. 여러 단계로 된 다단계 프롬프트는 12개, 합계 50단계였다.
• 분산 시스템 6편: CAP/PACELC, Saga 패턴, 분산 락 비교, Exactly-Once, Event Sourcing과 CQRS, Lamport/Vector Clock을 한 번에 발행했다. 각 글에 다이어그램을 넣었고, 6편 모두 공개 확인을 통과했다.

기술 아티클 이미지 추가 커밋은 13:25부터 18:00 사이에 5건 올라갔다. 히어로 이미지는 Antigravity로 생성을 요청했다. 생성된 파일을 실제로 저장했는지는 기록에 없다.

블로그 화면 수정

방문자 카운터, 새 글 말풍선, 메뉴 정리 (13:29)
방문자 카운터와 새 글 말풍선 코드를 커밋 1cdf8a8로 올렸다. 커밋 전에 npm run verify를 돌려 타입 검사 0 에러, 테스트 34개 통과, 빌드 성공을 확인했다. 기존 경고 7개는 그대로 남아 있다. 원격 저장소가 없어서 push는 하지 않았고, 같은 코드가 운영에 이미 올라가 있어 재배포도 하지 않았다.

메뉴 순서 변경 (18:03)
'글' 메뉴 순서를 전체 글 → 공지사항 → 기술 아티클 → AI 뉴스 → 트렌드로 바꿨다. 공지사항 한 줄만 위로 옮겼다. 커밋 dff2b2c 후 배포는 첫 시도에 성공했다. 운영 HTML에서 메뉴 순서를 확인했고, 브라우저 화면은 직접 열어 보지 않았다.

크몽 전자책 7권 링크 연결

크몽에서 전자책 7권이 모두 승인되어 "출시 예정" 표시를 없앴다. src/lib/books.ts에서 7권의 pending 값을 지웠다. 홈, /books, 좌우 여백 배너 세 곳에서 가격이 보이고, 누르면 판매자 프로필이 아니라 상품 페이지로 간다.

로그인하지 않은 상태에서 7개 상품 페이지가 모두 HTTP 200으로 열리는지 확인했다. 그 뒤 커밋 c518798을 올리고 프로덕션에 배포했다. 배포 후 /books에서 전자책 8권 전부가 크몽 상품 페이지로 연결되는 것을 확인했다. 나중에 새 전자책을 올릴 때를 대비해 pending 기능은 코드에 남겨 두었다.

학습 일지 자동 발행 방식 변경

학습 일지 자동 정리 글은 그동안 초안으로 저장되어 직접 들어가 발행해야 했다. 이제 바로 공개로 발행하도록 바꿨다.

• publish-drafts.mjs가 '초안 저장' 대신 '저장' 버튼을 누른다.
• 알림과 오류 문구를 "글 N편 발행 완료" 형식으로 고쳤다. CLAUDE.md 설명도 함께 바꿨다.
• 커밋 1a0e343에 세 파일만 넣었다.

이어서 실행 시각을 하루 4번으로 늘렸다. 00시, 09시, 13시, 19시다. 맥의 launchd plist에 시각을 추가하고 다시 등록했다. 이 파일은 저장소 밖에 있어서 커밋에는 들어가지 않는다. 글 제목은 오전·오후 대신 시간대 형식으로 바꿨다. 예를 들면 개발 기록 2026-11-02 19~24시: …처럼 쓴다. 커밋은 3a0e2e0이다.

이제 검토 단계 없이 바로 공개되므로, 자동으로 쓴 글에 잘못된 내용이 있으면 그대로 올라간다. 실제 자동 실행은 아직 돌려 보지 않았다.

블로그 정리 글의 API 키 가림 규칙

extract.py에서 블로그 글에 섞인 API 키를 가리는 규칙을 고쳤다. 중간에 점(.)이 들어간 sk- 키도 가리게 했다. 이를 확인하는 테스트도 test_extract.py에 추가했다. 두 파일은 아직 커밋하지 않았다.

커밋을 시도했을 때 자동 권한 검사가 명령을 자격 증명 유출로 판단해 막았다. 테스트 문자열의 가짜 키 모양 값 때문으로 보인다. 테스트도 같은 명령 안에 있어서 실행되지 않았다. 우회하지 않았고, 사용자가 직접 실행할 수 있는 명령을 안내했다.

이벤트 소싱 학습용 예제

이벤트 소싱을 7살 아이에게 설명하는 비유를 먼저 만들었다. 저금통에 잔액 대신 넣고 빼는 사건을 일기처럼 한 줄씩 적는 방식이다. 어른용으로는 일반 CRUD와 이벤트 소싱을 표로 비교했다.

이어서 같은 입금·출금 흐름을 Spring Boot 4.1.1 예제로 구현했다. 상태를 바로 갱신하는 패키지와 사건을 쌓고 재생하는 패키지를 나눴다. 작업 중 기록에서 핵심 통합 테스트는 통과했다. 잔액 일치, 과거 버전 재생, 잘못된 출금 거절, 이벤트 버전 중복 방지를 확인했다. 서버를 띄운 뒤 화면 요청 흐름도 점검했다. 최종 요약은 입력에서 잘려 있어서, 화면 점검 결과는 기록에 없다.

AI 스킬 설치와 포트폴리오 랜딩 제작

Codex로 MotionSites 관련 스킬을 찾아 설치했다.

• 처음 찾은 TheSatyam-Singh/motionsites.ai는 디자인 프롬프트 모음이었다. 그래서 motionsites-prompts라는 독립 스킬을 만들었다. 공식 스킬이 아니고, 실제 웹 제작에서 동작하는지는 시험하지 않았다.
• 이후 공식 저장소 Motionsites-AI/claude-skill을 받아 motionsites-web-builder 스킬을 설치했다.
• 공식 MCP 서버는 유료 Unlimited 요금제에 포함되어 있어서 설치하지 않았다.

설치한 motionsites-web-builder로 개인 포트폴리오 랜딩 페이지를 만들었다. 데스크톱과 모바일 화면을 확인했고, 모바일 가로 넘침도 점검했다. "전체 프로젝트 보기"는 기존 Project Atlas로 연결된다. 파일을 브라우저에서 직접 열면 모듈이 제한될 수 있다.

edu-videos 워크스페이스 정리

Codex로 교육 영상 작업 폴더를 리뷰했다. 독립된 영상 프로젝트 13개가 있었고, 각각 SPEC.md와 최종 MP4를 가지고 있었다. 타임라인 길이와 최종 MP4 길이를 비교했다. 리뷰 결과 전체는 입력에서 잘려 있다.

최상위 AGENTS.md를 새로 만들었다. 작업 구조, 프로젝트별 지침 확인 순서, 제작·검증 기준을 담았다. 각 영상 폴더에 있던 AGENTS.md는 그대로 두었다.

처음에 .claude/agents/ 숨김 폴더를 놓쳐서 에이전트 구성을 잘못 설명했다. 다시 확인해 정정했다. 영상 제작용 에이전트는 10개가 정의되어 있었다. topic-video-youtube 스킬은 자료조사, 스토리보드, 썸네일, 렌더링, 유튜브 업로드 순서로 작업하도록 되어 있다.

남은 것

• 학습 일지 자동 발행의 첫 실행 결과를 확인해야 한다. 로그는 ~/.claude/blog-digest/logs/에 있다. 맥이 잠자기 중일 때 빠진 시간대가 어떻게 처리되는지도 확인되지 않았다.
• extract.py와 test_extract.py의 키 가림 수정은 아직 커밋하지 않았다. 사용자가 직접 커밋해야 한다.
• 커밋 c518798의 출처가 기록에서 맞지 않는다. 18:30 응답은 이 세션에서 만든 커밋이라고 했고, 18:43 응답은 다른 세션의 커밋이라고 했다. 실제 작성자를 확인해야 한다.
• src/lib/site.ts와 .env.example에 있는 https://my-blog.vercel.app이 404를 반환한다. 기본 사이트 URL로 쓰이는 곳이 있는지 확인하지 않았다.
• Antigravity로 요청한 히어로 이미지가 실제로 저장되었는지 기록에 없다.
• MotionSites 스킬로 만든 포트폴리오는 실제 웹 제작 작업으로 검증하지 않았다.
• edu-videos 리뷰의 최종 결과는 입력에서 잘렸다.