첫 실행

이 단계의 목표는 글쓰기가 아니라 환경 설정입니다. /start가 환경을 검증하고, 블로그 정체성을 정하고, Blogger 연결 준비를 마치는 데까지입니다. /start는 글을 쓰지 않습니다. 글쓰기는 다음 단계에서 자연어로 시작합니다.

1) base 폴더에서 Claude Code 실행

clone-and-install에서 cd my-blog까지 했다면 같은 터미널에서 실행합니다.

claude

Claude Code 프롬프트가 뜨면 CLAUDE.md와 자동화 규칙을 조용히 읽어 들입니다. 화면에 출력이 별로 안 보일 수 있는데 정상입니다.

2) 한 줄로 시작

프롬프트에 다음을 입력합니다.

/start

또는 자연어로 프로젝트 시작이라고 입력합니다. 어느 쪽이든 start 라우터를 실행합니다. /start는 환경 설정 전용이라, 환경과 정체성과 연결만 정하고 글쓰기로 넘어가지 않습니다.

3) Phase 1: 환경 검증

/start가 가장 먼저 환경을 읽기 전용으로 확인합니다. Python과 발행 스크립트 의존성, OAuth 자격증명 파일, 블로그 ID가 있는지를 봅니다.

항목	없으면
python3	설치를 안내합니다. prerequisites의 Python 항목을 보세요
scripts/credentials.json	Google Cloud 콘솔에서 OAuth 클라이언트를 발급하도록 안내합니다
scripts/token.json	첫 발행 때 자동으로 생성되므로 지금은 없어도 정상입니다
BLOG_ID_KO, BLOG_ID_EN	.env에 적는 방법을 안내합니다

검증 결과는 .claude/state/env-check.json에 저장됩니다. 자격증명이 아직 없어도 이 단계는 진행됩니다. 발행 연결은 publish에서 마무리하면 되고, 지금은 무엇이 갖춰졌고 무엇이 비었는지를 확인하는 단계입니다.

4) git 이력 분리는 clone으로 받은 분만

base를 git clone으로 받았다면 /start가 origin URL을 검사해 한 번 물어봅니다. base의 커밋 이력 위에 본인 작업이 쌓이기 전에 이력을 끊을지 묻는 것입니다. Template로 본인 저장소를 만들어 받았다면 이 질문은 자동으로 건너뜁니다.

처음이라면 분리에 동의하는 편이 좋습니다. 결정은 .claude/state/git-separation.json에 저장되어 다음부터는 다시 묻지 않습니다.

5) Phase 2: 블로그 정체성

/start가 블로그 정체성을 묻습니다. 어떤 주제(niche)를 다루는지, 어떤 언어로 운영하는지, 수익 모델이 무엇인지, 글의 페르소나와 문체가 어떤지를 정합니다. 답은 .claude/product-marketing-context.md에 기록됩니다.

이 문서가 중요한 이유는 모든 집필과 마케팅 스킬이 여기를 참조하기 때문입니다. fork 직후에는 자리 표시 값만 들어 있으므로, 이 문서를 채워야 다음 단계의 글쓰기가 본인 블로그 문체로 나옵니다.

이 단계가 끝나면 이렇게 됩니다: .claude/state/env-check.json에 환경 상태가 기록되고, .claude/product-marketing-context.md에 블로그 정체성이 채워집니다. 아직 글은 한 편도 없습니다. 그게 정상입니다.

6) Blogger 도메인 연결은 나중에 해도 됩니다

/start는 Blogger 도메인 연결과 이미지 호스팅 저장소 연결까지 안내합니다. 다만 base는 외부 GitHub 저장소를 자동으로 만들지 않습니다. 이미지 호스팅 저장소가 필요하면 본인이 직접 만든 URL을 제공해야 하고, 그것도 사용자가 승인한 뒤에만 연결됩니다. 첫 글을 쓰기 전에 꼭 끝낼 필요는 없으니, 발행이 가까워지는 publish 단계에서 마무리해도 됩니다.

다음

환경 설정이 끝났으면 write-first-post로 갑니다. 이제 글을 씁니다.