첫 실행

이 단계의 목표는 세팅입니다. /start가 환경을 검증하고, 어느 트랙을 쓸지 묻고, 채널 정체성을 잡습니다. 아직 영상을 만들지 않습니다. 트랙과 채널이 정해지는 자리까지입니다.

1) base 폴더에서 Claude Code 실행

clone-and-install에서 cd my-channel까지 했다면 같은 자리에서 실행합니다.

claude

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

2) 한 줄로 시작

/start

또는 자연어로 프로젝트 시작, “처음 만들어”. 어느 쪽이든 start 라우터를 트리거합니다.

3) 환경 검증

/start가 환경을 read-only로 확인합니다. 공통 도구(ffmpeg, OPENAI_API_KEY)를 먼저 보고, 사용자가 고른 트랙에 맞는 도구만 추가로 검증합니다.

항목	트랙	없으면
ffmpeg	공통	설치 안내
OPENAI_API_KEY	공통	환경변수 설정 안내
codex CLI	생성형	설치 안내. 없으면 생성형 진입 막힘
yt-dlp	리믹스	설치 안내
whisper-cli	리믹스(선택)	없으면 Whisper API로 폴백

외부 도구는 자동으로 깔지 않습니다. 누락된 건 안내만 하고 설치는 사용자가 직접 합니다(또는 명시 승인 후).

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

base를 git clone으로 받았다면 /start가 origin URL을 검사해 한 번 물어봅니다. Template로 본인 저장소를 만들어 받았다면 자동으로 건너뜁니다.

5) 트랙 선택

/start가 어느 트랙을 쓸지 묻습니다. 생성형만, 리믹스만, 둘 다 중에 고릅니다. 이 선택에 따라 다음 단계가 갈립니다. 생성형이면 first-generative-video, 리믹스면 first-remix-video로 갑니다.

6) 채널 정체성

/start가 채널 정체성을 잡습니다. 플랫폼(TikTok, Reels, Shorts), 언어, 월간 편수, IP나 캐릭터 같은 자리입니다. 답은 _workspace/channel.json과 .claude/state/channel.json에 박힙니다. 다음 세션부터는 이 파일을 읽어 같은 채널 정체성 위에서 작업합니다.

이 단계가 끝나면 이렇게 됩니다: 환경이 검증되고, 트랙이 정해지고, channel.json에 채널 정체성이 박힙니다. 아직 영상은 없습니다. 그게 정상입니다.

세팅이 끝났으면 본인 트랙에 맞는 자리로 갑니다. 생성형이면 first-generative-video, 리믹스면 first-remix-video입니다.