MVCK Premium

가이드: 키트를 프로젝트에 넣기

나에게 맞는 길을 골라요. 두 길 모두, 가장 쉬운 방법은 AI 도구에 맡기는 거예요.

코딩 입문자

명령어를 입력하지 않아요. AI에게 메시지 하나를 붙여 넣고, 예 또는 아니요로 답해요.

입문자 길

개발자

명령을 직접 실행해요. 단계마다 복사할 명령과 비교할 결과가 있어요.

개발자 길

입문자 길: AI에게 설치 맡기기

Cursor, Claude Code, Codex, OpenCode, Grok, Kimi에서 쓸 수 있어요. 개발자도 여기서 시작해도 좋아요.

쉬운 말 선생

작은 일 4가지만 하면 돼요. 어려운 부분은 AI가 해요.

  1. 내려받은 파일 2개를 다운로드 폴더에 두기

    구매한 뒤 파일 2개를 내려받아요. 두 파일을 같은 곳에 두세요.

    minimal-vibe-coding-kit-premium-0.6.6.tgzSHA256SUMS

  2. AI 도구에서 프로젝트 열기

    쓰고 있는 도구로 프로젝트 폴더를 열어요. 키트는 AI 도구를 대신 설치하거나 로그인해 주지 않아요.

    • Claude Code
    • Codex
    • Cursor
    • OpenCode
    • Grok
    • Kimi

  3. 이 메시지를 AI 채팅에 붙여 넣기

    파일이 다른 곳에 있으면 경로를 바꿔요.

    경로 ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz은 예시예요. 파일을 저장한 위치로 바꿔 주세요.

    파일의 정확한 경로를 알아내는 방법

    1. 파일 탐색기를 열고 내려받은 파일을 선택해요.
    2. Ctrl + Shift + C를 눌러요. Windows 10에서는 Shift를 누른 채 파일을 오른쪽 클릭하고 "Copy as path"를 골라요.
    3. 예시 경로 자리에 이 경로를 붙여 넣어요.

    경로는 이런 모양이에요:

    C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgz

    Windows에서는 이 페이지 명령의 ~ 대신 폴더의 전체 경로를 써요.

    AI에게 보낼 메시지: 새로 설치

    Minimal Vibe Coding Kit Premium을 구매했습니다. 파일 위치: ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz 지금 열려 있는 프로젝트에 키트를 설치해 주세요. 한 단계씩 진행하고 각 단계의 결과를 알려 주세요. 1. 파일의 SHA-256을 계산합니다. 같은 폴더의 SHA256SUMS와 비교합니다. 다르면 멈춥니다. 2. ~/tools/mvck-0.6.6에 압축을 풉니다. 프로젝트 안에는 풀지 않습니다. 3. 압축을 푼 package 폴더로 이동합니다. 미리보기를 실행합니다: node bin/mvck.js install "<이 프로젝트의 경로>" --profile all --dry-run --json 이 명령이 무엇을 추가하는지 알려 주세요. 4. 제가 yes라고 답할 때까지 기다립니다. 그다음 --dry-run --json 없이 다시 실행합니다. 5. .vibekit/init/FIRST_TIME_INIT.md를 읽고 프로젝트를 초기화합니다. 제안하는 backbone.yml을 보여 주세요. 제가 승인한 뒤에 기록합니다. 6. 프로젝트에서 키트의 doctor와 validate를 실행합니다. 결과를 쉬운 말로 알려 주세요.

  4. AI의 질문을 읽고 답하기

    AI는 두 번 멈춰서 물어봐요. 키트를 프로젝트에 복사하기 전, 그리고 프로젝트 규칙집을 저장하기 전이에요. 읽고 yes라고 답해요.

    올바른 결과:Validation summary: 0 failures, 0 warnings.

  5. 키트가 이미 있고 새 버전으로 올리고 싶다면

    새 버전을 내려받고 이 메시지를 붙여 넣어요. AI가 변경 내용을 미리 보고, 키트의 이전 파일을 백업한 뒤 업데이트해요.

    AI에게 보낼 메시지: 업데이트

    Minimal Vibe Coding Kit Premium의 새 버전을 내려받았습니다. 파일 위치: ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz 지금 열려 있는 프로젝트에는 이미 키트가 있습니다. 업데이트해 주세요. 한 단계씩 진행하고 각 단계의 결과를 알려 주세요. 1. 파일의 SHA-256을 계산합니다. SHA256SUMS와 비교합니다. 다르면 멈춥니다. 2. ~/tools/mvck-0.6.6에 압축을 풉니다. 프로젝트와 따로 둡니다. 3. 새 버전의 package 폴더로 이동합니다. 미리보기를 실행합니다: node bin/mvck.js update "<이 프로젝트의 경로>" --profile all --dry-run --json fromVersion, toVersion, 그리고 바뀌는 파일 수를 알려 주세요. 4. 제가 yes라고 답할 때까지 기다립니다. 그다음 --dry-run --json 없이 다시 실행합니다. 5. 프로젝트에서 git status를 실행합니다. 어떤 파일이 바뀌었는지, 백업이 어디에 있는지 알려 주세요. 6. 키트의 doctor와 validate를 실행합니다. 결과를 알려 주세요.

개발자 길: 명령을 직접 실행하기

macOS, Node 22, 키트 0.6.6에서 테스트했어요. 키트에는 Node 18 이상이 필요해요.

꼼꼼한 장인

일곱 단계예요. 먼저 미리 보고, 그다음에 기록해요.

  1. 내려받은 파일 확인하기

    출력된 문자열을 SHA256SUMS의 줄과 비교해요. 다르면 다시 내려받아요.

    경로 ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz은 예시예요. 파일을 저장한 위치로 바꿔 주세요.

    파일의 정확한 경로를 알아내는 방법

    1. 파일 탐색기를 열고 내려받은 파일을 선택해요.
    2. Ctrl + Shift + C를 눌러요. Windows 10에서는 Shift를 누른 채 파일을 오른쪽 클릭하고 "Copy as path"를 골라요.
    3. 예시 경로 자리에 이 경로를 붙여 넣어요.

    경로는 이런 모양이에요:

    C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgz

    Windows에서는 이 페이지 명령의 ~ 대신 폴더의 전체 경로를 써요.

    명령
    cd ~/Downloads
node -e "console.log(require('node:crypto').createHash('sha256').update(require('node:fs').readFileSync(process.argv[1])).digest('hex'))" minimal-vibe-coding-kit-premium-0.6.6.tgz
cat SHA256SUMS

    올바른 결과:64자 문자열 두 개가 같음

  2. 별도 폴더에 압축 풀기

    키트를 프로젝트와 따로 두세요. package 폴더에 bin/mvck.js가 있어요.

    명령
    mkdir -p ~/tools/mvck-0.6.6
tar -xzf minimal-vibe-coding-kit-premium-0.6.6.tgz -C ~/tools/mvck-0.6.6
cd ~/tools/mvck-0.6.6/package
node bin/mvck.js --help

    올바른 결과:Minimal Vibe Coding Kit Premium

  3. 미리 보기, 아직 기록하지 않기

    경로를 내 프로젝트로 바꿔요. 쓰는 AI 도구의 profile을 고르거나 all을 써요.

    Profile:

    하나를 고르면 3, 4, 7단계의 명령이 함께 바뀌어요.

    명령
    node bin/mvck.js install "/path/to/project" --profile all --dry-run --json

    올바른 결과:"status": "dry-run"

  4. 프로젝트에 설치하기

    이 명령은 바로 기록해요. 프로젝트에 CLAUDE.md나 AGENTS.md가 이미 있으면, 키트는 자신이 관리하는 블록만 추가해요.

    명령
    node bin/mvck.js install "/path/to/project" --profile all

    올바른 결과:Install complete:

  5. 프로젝트 규칙집 만들기

    AI 도구에서 프로젝트를 열고 이 메시지를 채팅에 붙여 넣어요. AI가 프로젝트를 읽고 backbone.yml을 제안한 뒤, 승인을 기다려요.

    AI에게 보낼 메시지

    Read .vibekit/init/FIRST_TIME_INIT.md and initialize this project with the kit. Print the requirements you will check. Propose a diff for backbone.yml. Wait for my approval before you write. Summarize in Korean.

    올바른 결과:AI가 backbone.yml 제안을 보여 주고 승인을 기다림

  6. 확인하기

    프로젝트 폴더에서 실행해요. doctor는 상태를 알려 주고, validate는 키트 규칙을 확인해요.

    명령
    cd "/path/to/project"
node .vibekit/scripts/mvck.mjs doctor .
node .vibekit/scripts/mvck.mjs validate .

    올바른 결과:Validation summary: 0 failures, 0 warnings.

  7. 새 버전으로 업데이트하기

    새 버전을 내려받아 별도 폴더에 압축을 풀어요. 새 버전의 package 폴더에서 실행해요. 바뀐 키트 파일은 .vibekit/update-backup/에 백업돼요.

    명령
    node bin/mvck.js update "/path/to/project" --profile all --dry-run --json
node bin/mvck.js update "/path/to/project" --profile all

    올바른 결과:Update complete:

오류가 났을 때

아직 막혀 있나요? 작성자에게 이메일을 보내요: [email protected]. 비밀번호나 비밀 키는 보내지 마세요.

아직 키트가 없나요?

판매 중인 버전: v0.6.6. 새로워진 점은 변경 기록에서 볼 수 있어요.

키트 받기변경 기록 보기