ARTICLE 22 min

빌드킷 다운로드 + 셀프 리뷰 — PLAN의 모든 자료를 ZIP 한 묶음으로

이 레슨이 끝나면

  • "빌드 스텝 분해 = PLAN 결과를 작은 작업 단위(티켓)로 자동 분해"라는 한 줄 정의를 안다
  • vuild.kr PLAN 8단계에서 빌드 스텝을 생성하고, ZIP 형태로 본인 PC에 다운받았다
  • 다운받은 ZIP 안에 무엇이 들어 있는지(CLAUDE.md / .claude/ / docs/ / db/seeds/ 등) 안다
  • 셀프 루브릭 5문항으로 본인 PLAN 완성도를 진단했고, 부족한 곳이 있으면 어디로 돌아갈지 안다
  • Ch.4(BUILD)에 진입할 준비가 됐다

PLAN의 마지막 칸 — 왜 빌드킷 다운로드?

지금까지 vuild.kr 대시보드에서 만든 자료(PRD / 기능 명세 / 블루프린트 / 디자인 토큰 / 유저 플로우 / 와이어프레임)는 전부 vuild.kr 서버에만 있어요. 본인 PC에는 아무것도 없는 상태. Ch.4(BUILD)부터는 본인 PC에서 진짜 코드를 작성해요. 그러려면 그 모든 자료를 PC로 옮겨야 해요. PLAN 8단계 = "PLAN 결과를 본인 PC로 옮기는 다리"예요.

단순 ZIP 다운로드가 아니에요. 옮길 때 두 가지 자동 작업이 일어나요.

  • 빌드 스텝 분해 — PLAN 결과를 작은 작업 단위(티켓)로 자동 분해. 예: "회원가입 화면 만들기" / "DB 모델 User 만들기" / "책 등록 폼 만들기" 같은 티켓 30~50개
  • CLAUDE.md 자동 포함 — Claude Code가 본인 프로젝트를 알게 해주는 가이드 파일. PRD / 디자인 토큰 / 기능 우선순위 등이 정리돼 있어서 본인이 따로 설명 안 해도 AI가 컨텍스트 알고 있음
🎨 생성 (Codex CLI) — "빌드킷 ZIP = PLAN을 PC로 옮기는 다리" 다이어그램. 좌(vuild.kr 서버: 6개 자료 박스) → 화살표 → ZIP 박스 → 본인 PC.
PLAN의 모든 자료가 한 ZIP에 모여 본인 PC로 가요.

옆 탭에 PLAN 8단계 열기

옆 탭 주소

https://vuild.kr/projects/[본인프로젝트번호]/plan/build_steps

페이지 가운데에 "빌드 스텝 준비 시작" 버튼이 있어요. 그걸 한 번 누르면 자동 분해가 시작돼요. 보통 1~3분 정도 걸려요(PLAN 자료가 많을수록 더 오래). 진행 상태가 화면 위에서 실시간 업데이트.

📷 캡쳐 — build_steps index 화면. "빌드 스텝 준비 시작" 큰 버튼 + 우측 진행 상태 영역.
📷 캡쳐 — 빌드 스텝 준비 진행 중 화면. 진행 바 + "PRD 분해 / 모델 정리 / 페이지 분해 / CLAUDE.md 생성" 단계 표시.
차 한 잔. 1~3분이면 끝.

분해된 빌드 스텝 검토 (선택)

분해가 끝나면 빌드 스텝(티켓) 리스트가 화면에 떠요. 보통 30~50개 티켓이 카테고리별(회원가입 / DB / 핵심 기능 / 디자인 적용 등)로 묶여 있어요. 본인이 일일이 다 검토할 필요는 없어요. 한 번 위에서 아래로 스크롤하면서 누락된 게 없는지 훑는 정도면 충분해요.

📷 캡쳐 — 빌드 스텝 리스트 풀화면. 카테고리별 30~50개 티켓 그리드.

⭐ 빌드킷 ZIP 다운로드

빌드 스텝이 준비됐으면 페이지 상단 또는 하단에 "빌드킷 다운로드" 버튼이 활성화돼요. 그 버튼을 한 번 누르면 본인 PC 다운로드 폴더에 vuild-buildkit-[프로젝트명].zip 파일이 받아져요. 파일 크기는 보통 100KB~5MB 정도(본인 PLAN 자료 양에 따라).

📷 캡쳐 — "빌드킷 다운로드" 버튼 + 다운로드 진행 알림 + 다운로드 폴더에 ZIP 파일 받아진 화면.
한 번 누르면 본인 PC에 ZIP이 떨어져요.

ZIP 안에 뭐가 들어 있나?

ZIP을 압축 풀면 다음과 같은 폴더 구조가 나와요. 지금 당장 다 이해할 필요 없어요. Ch.4-1(빌드킷 압축 풀기 + 폴더 구조)에서 한 번 더 자세히 다뤄요. 지금은 이름만 익혀 두세요. 

vuild-buildkit-[프로젝트명]/
├── CLAUDE.md           ← Claude Code가 읽는 프로젝트 가이드 (가장 중요)
├── .claude/
│   ├── agents/         ← AI 에이전트 정의 (디자이너 / 개발자 / 리뷰어 등)
│   ├── commands/       ← Claude 슬래시 명령 (/setup /backlog 등)
│   └── skills/         ← 본인 SaaS에 특화된 스킬
├── docs/
│   ├── prd.md          ← PRD 본문
│   ├── feature-specs.md ← 기능 명세
│   ├── blueprint.md    ← 블루프린트
│   ├── design-system.md ← 디자인 토큰
│   ├── user-flows.md   ← 유저 플로우
│   └── wireframes.md   ← 와이어프레임
├── db/
│   └── seeds/          ← 초기 데이터 시드
└── README.md           ← Ch.4 진행 가이드

가장 중요한 건 CLAUDE.md예요. 이 파일이 있어야 Claude Code(Ch.4-2에서 깖)가 본인 프로젝트의 컨텍스트를 알아요. 본인이 매번 "내 서비스는 독서 노트 앱이고…" 설명 안 해도 AI가 알아서 안내해줘요.

🎨 생성 (Codex CLI) — 빌드킷 ZIP 폴더 구조 트리 다이어그램. 강조: CLAUDE.md (가장 위, 큰 폰트), .claude/, docs/, db/.
CLAUDE.md가 가장 중요해요. 나머지는 보조.

⭐ 셀프 루브릭 — PLAN 완성도 자가 진단 5문항

ZIP을 받았으면 마지막으로 본인의 PLAN 단계를 자가 진단할 시간이에요. 아래 5문항에 1~5점(1=전혀 / 3=보통 / 5=완벽)으로 점수 매겨 보세요. 종이나 메모장에 적으세요.

# 문항 3점 미만이면 어디로
1 PRD 한 줄 정의를 친구에게 한 문장으로 설명할 수 있다 PLAN 2 (스펙 편집) — 한 줄 정의 다듬기
2 Must 기능이 5개 이하다 PLAN 3 (기능 명세) — 일부를 Should/Could로
3 블루프린트의 모델 / 관계가 본인 의도와 같다 PLAN 4 (블루프린트) — AI Coach에 수정 요청
4 디자인 토큰 (색·폰트·여백) 한 가지 톤이 잡혔다 PLAN 5 (디자인 시스템) — 외부 사례 한 번 더 둘러보기
5 신규 가입 → 첫 결과 플로우가 5단계 안에 끝난다 PLAN 6 (유저 플로우) — 단계 줄이기

5문항 합계 점수에 따라 다음 액션이 달라져요.

  • 20~25점 — 매우 잘 됨. Ch.4(BUILD)로 바로 진입.
  • 15~19점 — 양호. 3점 미만 문항만 한 번 보강하고 Ch.4로.
  • 10~14점 — 부족. 2~3개 PLAN 단계로 돌아가서 다듬은 후 다시 빌드킷 다운로드.
  • 10점 미만 — 위험. PLAN 1단계부터 다시 검토 권장. 또는 VALUE까지 돌아가야 할 수도.
🎨 생성 (Codex CLI) — 셀프 루브릭 5문항 카드 + 점수별 다음 액션 분기 다이어그램.
점수가 어떻든 다음 단계는 명확해요.

PLAN을 마치면서 — 한 줄 회고

Ch.3 PLAN 8 lesson을 다 통과하셨다면 이미 비개발자 1인 빌더의 90%보다 앞에 있어요. 많은 사람이 PLAN 단계를 건너뛰고 바로 코드부터 만지다가 흔들려요. PLAN의 결과를 손에 쥐고 BUILD로 가는 것과 그렇지 않은 건 천양지차예요.

종이나 메모장에 한 줄씩 적어 보세요(아무에게도 안 보여줘도 OK).

  • PLAN 8단계를 거치면서 가장 의외였던 한 가지는?
  • 가장 시간이 오래 걸린 단계는? 왜 그랬다고 생각하나?
  • Ch.4 BUILD에 들어가기 전에 한 번 더 다듬고 싶은 PLAN 단계 1개는?
  • 30일 후 손에 쥐고 싶은 결과물 한 줄로 다시 적기

막히는 지점 — 미리 답

  • "빌드 스텝 준비가 5분 넘게 안 끝나요" → 페이지 새로고침 후 다시. 그래도 안 되면 PLAN 1~7 중 어느 단계가 미완인지 사이드바 ✓ 표시 확인.
  • "ZIP이 다운로드 안 돼요" → 브라우저 팝업 차단 해제 / 다른 브라우저(Chrome/Edge/Safari)로 시도.
  • "ZIP은 받았는데 압축이 안 풀려요" → 파일 깨졌을 수 있어요. vuild.kr에서 다시 다운로드. Mac은 더블클릭, Windows는 우클릭 → "압축 풀기".
  • "CLAUDE.md를 열어 보니 영어가 섞여 있어요" → 정상이에요. Claude Code가 영어 키워드를 더 잘 알아들어서 일부러 영어 섹션이 들어 있어요. 본인이 안 건드려도 OK.
  • "셀프 루브릭에서 점수가 너무 낮게 나와요" → 좋은 신호예요. 부족한 곳을 알았다는 뜻. 그 단계로 돌아가서 30분만 더 다듬으세요.

완료 체크리스트 (Ch.3 PLAN 졸업 기준)

  • ☐ 빌드 스텝 준비를 1번 실행했고, 30~50개 티켓이 화면에 떴다
  • ☐ 빌드킷 ZIP을 본인 PC 다운로드 폴더에 받았다
  • ☐ ZIP을 압축 풀어서 CLAUDE.md / .claude/ / docs/ 폴더가 있는 걸 봤다
  • ☐ 셀프 루브릭 5문항에 점수를 매겼고, 합계가 15점 이상이다 (또는 부족한 곳을 보강함)
  • ☐ Ch.4(BUILD)에 진입할 마음의 준비가 됐다

Ch.3 졸업 — 무엇이 바뀌었나

  • 본인 SaaS의 PRD / 기능 명세 / 블루프린트 / 디자인 토큰 / 유저 플로우 / 와이어프레임이 한 묶음으로 정리됐다
  • 그 모든 자료가 본인 PC 빌드킷 ZIP에 들어 있다
  • CLAUDE.md 덕분에 Claude Code가 본인 프로젝트 컨텍스트를 즉시 안다
  • "무엇을 어떻게 만들지" 두 가지 큰 질문이 정리됐다 — 이제 "어떻게 짓느냐"만 남았다

다음 단계 → Ch.4 BUILD (본인 PC에서 진짜 코딩)

드디어 본인 PC에서 실제 코드를 작성하는 단계예요. 13 lesson으로 구성돼요. 먼저 Ch.4-1에서 방금 받은 빌드킷 ZIP을 압축 풀고, Ch.4-2에서 Antigravity + Claude Code를 깔아요. 그 후 /setup /dashboard /backlog 명령어로 빌드킷 안의 티켓을 하나씩 실행해 나가요. 7~10일 걸리는 가장 긴 chapter지만, 매일 한 lesson씩만 통과하면 손에 진짜 도는 SaaS가 잡혀요. 잠깐 휴식하고, 충분한 시간이 잡힐 때 Ch.4를 시작하세요.

옆 탭에 PLAN 8단계(다운로드) 열기

로그인 후 본인 프로젝트로 진행할 수 있습니다.

로그인