비개발자용 시작

이 가이드는 풀타임 개발자가 아닌 분을 위한 안내입니다. 본인 컴퓨터에서 /start로 책 정체성을 잡고, 한 챕터씩 쓰고, 연속성을 유지하며 책 한 권을 끝까지 가는 자리까지 한 단계씩 따라가게 짜여 있습니다. 도중에 막히면 troubleshooting을 옆 탭에 켜두고 같은 증상을 찾아 보면 됩니다.

어떤 분을 염두에 두고 썼나

이 base를 집어 드는 분 중에는 풀타임 개발자가 아닌 경우가 적지 않습니다. 그래서 톤이 손을 잡듯 잡혀 있습니다. 다만 가정하는 학습 수준이 하나 있습니다.

터미널을 한 번이라도 열어 봤고, AI와 작업해 본 경험이 있다는 가정입니다. 명령을 한 줄씩 풀어 적기는 하지만, “터미널이 뭔지”, “git이 뭔지”를 처음부터 풀어 주지는 않습니다. 그 자리는 옆 탭에 무료 학습 자료(YouTube의 git/터미널 입문, Anthropic의 Claude Code 빠른 시작)를 두고 봐 주시면 됩니다.

다음 세 가지를 가정합니다.

• 터미널과 git의 이름과 대략의 쓰임은 알고 있습니다. 그 위에서 명령을 한 줄씩 풀어 적습니다.
• 첫 실행에는 외부 서비스 연결이 거의 없습니다. book-studio는 API 키 없이도 책을 쓸 수 있는 제품이라, 진입 문턱이 다른 base보다 낮습니다. 외부 검색이나 삽화가 필요할 때만 그 자리에서 따로 안내합니다.
• 글은 AI가 씁니다. 이 가이드에서는 Claude Code를 씁니다. 어떤 책을 쓰고 싶은지만 알면 됩니다.

이미 익숙한 부분이 있다면 그 단계는 훑고 넘어가도 됩니다.

단계 안내

단계	무엇을 하나	대략 시간
1 prerequisites	git, markdown 뷰어, Claude Code 설치	처음이면 20~40분
2 clone-and-install	base 받기	5~10분
3 first-run	/start로 책 정체성 잡고 Tier 1 진입	20~40분
4 write-first-chapter	Tier 2 아웃라인과 Tier 3 첫 챕터 쓰기	30분~1시간
5 continuity	연속성이 어떻게 유지되는지 이해	10분
6 multiple-books	여러 권을 동시에 굴리기	10분
7 automated-safety-net	챕터별 게이트와 훅이 챙겨주는 자리 이해	10분
8 when-ai-gets-stuck	AI 워크플로 자체가 막힌 자리 풀기	필요할 때만
9 troubleshooting	자주 막히는 자리 모음	필요할 때만
10 finishing	챕터를 최종 합본으로 모으기	한 권 끝낼 때
11 staying-up-to-date (선택)	base 업데이트를 내 작업에 가져오기	한 사이클당 10~30분

이미 AI 집필 도구가 익숙한 분이라면 전문가용 매뉴얼이 더 짧은 호흡으로 같은 base를 풉니다.

막혔을 때

가장 먼저 볼 자리는 troubleshooting입니다. 거기에도 같은 증상이 없으면 에러 메시지를 그대로 복사해 Claude Code에 붙여 넣고 “이거 어떻게 고쳐?”라고 물어 보세요.

그래도 풀리지 않으면 GitHub 이슈를 열거나 팀 Slack에 올립니다. 어디서 막혔는지, 에러 전체, 환경 정보(운영체제)를 같이 적습니다.

처음 한 번이 가장 느립니다. 환경이 한 번 잡히면 다음 책을 쓸 때는 1단계를 통째로 건너뛰게 됩니다.

매뉴얼은 어디까지, base는 어디부터

이 단계 표가 다루는 자리는 base가 자동으로 챙겨주는 자리, 즉 챕터별 AI-smell 게이트, 연속성 인덱스, 멀티북 격리, 4-Tier 흐름 같은 차별점입니다. 매뉴얼 본문은 무료로 풀려 있고, 옆 탭에 두고 따라가시면 됩니다.

실제 base 코드와 .claude/ 풀셋(에이전트, 스킬, 훅)은 라이선스 + 업데이트 채널 형태로 곧 풀립니다. 가격과 결제 채널이 정해지면 이 페이지와 랜딩에 같이 안내합니다.