ガイド:キットをプロジェクトに追加する
自分に合うコースを選びます。どちらのコースでも、いちばん簡単なのは AI ツールに任せることです。
初心者コース:AI にインストールを頼む
Cursor、Claude Code、Codex、OpenCode、Grok、Kimi で使えます。開発者もここから始められます。
やさしい説明係
あなたがするのは小さなこと 4 つ。むずかしい部分は AI がやります。
ダウンロードした 2 つのファイルを「ダウンロード」フォルダーに置く
購入後、ファイルを 2 つダウンロードします。同じ場所に並べて置きます。
minimal-vibe-coding-kit-premium-0.6.6.tgzSHA256SUMS
AI ツールでプロジェクトを開く
いつも使っているツールでプロジェクトのフォルダーを開きます。キットは AI ツールのインストールやサインインを代わりに行いません。
Claude Code
Codex
Cursor
OpenCode
Grok
Kimi
このメッセージを AI のチャットに貼り付ける
ファイルが別の場所にある場合は、パスを変えてください。
パス ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz は例です。ファイルを保存した場所に変えてください。
ファイルの正確なパスを調べる方法
- エクスプローラーを開き、ダウンロードしたファイルを選びます。
- Ctrl + Shift + C を押します。Windows 10 の場合:Shift を押しながらファイルを右クリックし、「Copy as path」を選びます。
- 例のパスの代わりに、このパスを貼り付けます。
パスは次のような形です:
C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgzWindows では、このページのコマンドの ~ を、フォルダーのフルパスに置き換えてください。
- Finder を開き、ダウンロードしたファイルを選びます。
- Option + Command + C を押します。フルパスがコピーされます。
- 例のパスの代わりに、このパスを貼り付けます。
パスは次のような形です:
/Users/<name>/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz- ファイルのあるフォルダーでターミナルを開きます。
- このコマンドを実行します。フルパスが表示されます。
realpath minimal-vibe-coding-kit-premium-0.6.6.tgz - 例のパスの代わりに、このパスを貼り付けます。
パスは次のような形です:
/home/<name>/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgzAI へのメッセージ:新規インストールMinimal Vibe Coding Kit Premium を購入しました。ファイルの場所: ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz いま開いているプロジェクトにキットをインストールしてください。1 ステップずつ進め、各ステップの結果を教えてください。 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 を実行します。結果をやさしい言葉で教えてください。
AI の質問を読んで答える
AI は 2 回止まって質問します。キットをプロジェクトにコピーする前と、プロジェクトのルールブックを保存する前です。読んでから yes と答えます。
正しい結果:Validation summary: 0 failures, 0 warnings.
すでにキットがあり、新しい版にしたい場合
新しい版をダウンロードして、このメッセージを貼り付けます。AI は変更をプレビューし、キットの古いファイルをバックアップしてから更新します。
AI へのメッセージ:更新Minimal Vibe Coding Kit Premium の新しい版をダウンロードしました。ファイルの場所: ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz いま開いているプロジェクトには、すでにキットがあります。更新してください。1 ステップずつ進め、各ステップの結果を教えてください。 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 以上が必要です。
ていねいな職人
7 つのステップ。まずプレビュー、それから書き込みます。
ダウンロードしたファイルを確認する
表示された文字列を SHA256SUMS の行と比べます。違う場合は、もう一度ダウンロードします。
パス ~/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz は例です。ファイルを保存した場所に変えてください。
ファイルの正確なパスを調べる方法
- エクスプローラーを開き、ダウンロードしたファイルを選びます。
- Ctrl + Shift + C を押します。Windows 10 の場合:Shift を押しながらファイルを右クリックし、「Copy as path」を選びます。
- 例のパスの代わりに、このパスを貼り付けます。
パスは次のような形です:
C:\Users\<name>\Downloads\minimal-vibe-coding-kit-premium-0.6.6.tgzWindows では、このページのコマンドの ~ を、フォルダーのフルパスに置き換えてください。
- Finder を開き、ダウンロードしたファイルを選びます。
- Option + Command + C を押します。フルパスがコピーされます。
- 例のパスの代わりに、このパスを貼り付けます。
パスは次のような形です:
/Users/<name>/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgz- ファイルのあるフォルダーでターミナルを開きます。
- このコマンドを実行します。フルパスが表示されます。
realpath minimal-vibe-coding-kit-premium-0.6.6.tgz - 例のパスの代わりに、このパスを貼り付けます。
パスは次のような形です:
/home/<name>/Downloads/minimal-vibe-coding-kit-premium-0.6.6.tgzコマンド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
プレビューする(まだ書き込まない)
パスを自分のプロジェクトに変えます。使う AI ツールの profile を選ぶか、all を使います。
Profile:ひとつ選ぶと、ステップ 3、4、7 のコマンドが変わります。
コマンドnode bin/mvck.js install "/path/to/project" --profile all --dry-run --json正しい結果:"status": "dry-run"
プロジェクトにインストールする
このコマンドはすぐに書き込みます。プロジェクトに CLAUDE.md や AGENTS.md がすでにある場合、キットは自分が管理するブロックだけを追加します。
コマンドnode bin/mvck.js install "/path/to/project" --profile all正しい結果:Install complete:
プロジェクトのルールブックを用意する
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 Japanese.
正しい結果:AI が backbone.yml の案を見せて、承認を待つ
確認する
プロジェクトのフォルダーで実行します。doctor は状態を報告し、validate はキットのルールを確認します。
コマンドcd "/path/to/project" node .vibekit/scripts/mvck.mjs doctor . node .vibekit/scripts/mvck.mjs validate .正しい結果:Validation summary: 0 failures, 0 warnings.
新しい版に更新する
新しい版をダウンロードして、専用のフォルダーに展開します。新しい版の 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:
エラーが出たとき
Error: Kit not detected in target
プロジェクトにまだキットがないか、パスが違います。パスを確認します。キットがない場合は install を実行します。
Error: Update source and target are the same directory
キットのフォルダー自体を更新しようとしています。コマンドを自分のプロジェクトに向けてください。
Error: Unknown profile
次の値のどれかをそのまま使います:all、claude、cursor、codex、opencode、grok、kimi。
Cannot find module .../bin/mvck.js
package フォルダーにいません。先に cd でそのフォルダーに移動します。
まだ解決しない場合は、作者にメールしてください:[email protected]。パスワードや秘密鍵は送らないでください。





