vibestart

VibeStart CLI

CLI を使ってスタックを解決し、生成されたプロジェクトを保守します。サポートされている内容は、現在のヘルプ、機能一覧、変更計画に基づいて判断してください。テンプレートを再構築したり、プロジェクトの記録を手動で編集したりしないでください。

コンテキストを確認する

1. 対象ディレクトリと、依頼が新規作成か保守かを特定します。プロジェクトの指示を読みます。既存のプロジェクトの場合は、vibestart.jsonc（name、version、選択内容）、package.json、Git のステータスを確認します。無関係な編集内容は保持してください。
2. npx --yes vibestart-cli（または pnpm dlx vibestart-cli）を使って npm から CLI を実行します。グローバルインストールは不要です。npx --yes vibestart-cli --version でバージョンを確認します。プレビュー後に適用する場合、新しいリリースによって対象が変わらないよう、両方のコマンドでパッケージ名に @ と同じ公開済みバージョンを付けます。
3. このスキルをインストールしても、CLI、Vite+、プロジェクトの依存関係はインストールされません。必要なツールが利用できない場合は、選択したスタックを変更せず、ユーザーの許可範囲内でインストール手順に従ってください。
4. 新規作成の場合は npx --yes vibestart-cli --help、保守の場合は npx --yes vibestart-cli COMMAND --help を読みます。エージェントが実行する操作には --json を優先し、stdout と stderr を分けてください。タスクランナーのバナーを JSON として解析しないでください。

ワークフローを選ぶ

作業に取りかかる前に、該当するリファレンスを読みます。パスはユーザーのプロジェクトではなく、このスキルのディレクトリを基準とします。

ユーザーの意図	最初に行う操作	リファレンス
プロジェクトを作成する、またはレシピを使う	npx --yes vibestart-cli --list --json	プロジェクトの作成
機能を追加する	npx --yes vibestart-cli add --list --json	保守
既存のプロジェクトを診断する	npx --yes vibestart-cli doctor --offline --json	保守
生成済みプロジェクトを更新する	npx --yes vibestart-cli upgrade --dry-run --json	保守
書き込みを完了する：競合、手動変更、チェック	書き込みの JSON 結果と git diff を読む	保守

保守コマンドは生成済みプロジェクトのルートから実行するか、--cwd /actual/project/path を渡します。新規作成の場合は、位置引数で出力先ディレクトリを指定します。--cwd オプションはありません。

要求された範囲内で実行する

• 書き込み前に変更内容をプレビューします。ユーザーが操作を依頼しており、計画がその範囲内に収まっている場合は、追加の許可確認をせずに進めます。不足している製品上の選択肢や、依頼の範囲を超える重要な変更についてのみ確認します。調査またはプレビューの依頼は、計画の適用を許可するものではありません。
• 作成時はプロンプトを無効にするため、--json を使用します。メンテナンスによる書き込みには、さらに --yes が必要です。作成時に --yes を渡してはいけません。
• メンテナンスによる書き込みには、クリーンな Git ワークツリーが必要です。ワークツリーにユーザーの未コミットの作業がある場合は、書き込み前にコミットするかスタッシュするかを確認します。
• パッケージマネージャーと Hono ランタイムは別々の選択肢です。--package-manager bun は依存関係のインストール方法を選択し、--runtime bun は Hono の実行方法を選択します。どちらももう一方を変更することはなく、Vite+ のテストツールチェーンを Bun に移行することもありません。vp test を bun test に置き換えたり、CLI を Bun で実行するよう強制したりしてはいけません。
• 既存のプロジェクトでは add と upgrade を使用します。選択肢の変更にはこれらのコマンドのみを使用し、vibestart.jsonc の name と version は CLI が書き込んだ値のままにします。アップグレードでは、これらの値を基に元のテンプレートが再生成されるためです。
• 環境のインストールおよびサービスに関する制限を守ります。通常の作成およびメンテナンスによる書き込みでは、セットアップとチェックを実行します。これらを実行できない場合は、読み取り専用のプレビューを使用するか、ファイルへの書き込みが依頼範囲に含まれる場合は、インストールを明示的に延期します。--full-check はサービスやブラウザーを起動することがあります。

実際の結果を報告する

CLI のバージョン、対象プロジェクト、選択した変更、返されたステータス、実際に実行したチェック、そして競合や、移植がまだ必要な manual 変更を含む残作業を報告します。機械向けの出力では、終了コードと JSON フィールドの両方を確認します。プレビューの成功、doctor の結果、過去のスタック検証記録は、このプロジェクトのテストに合格した証拠にはなりません。終了コードがゼロでも、needs-install は未完了の操作です。

以降の作業では、プロジェクトで生成されたタスクを使用します。vp install、vp check、および package.json または vite.config.ts にあるタスクを使用してください。vp run ready は、プロジェクト全体の検証チェーンを実行します。オプションの機能がない場合は、そのタスクが存在すると決めつけてはいけません。ジェネレーターリポジトリの vp run deps update はメンテナー向けのコマンドであり、生成されたプロジェクトのアップグレードコマンドではありません。