バイブビルド は何をしますか？
エージェントが自律的に実行する完全なビルドワークフロー。ユーザーは製品上の意思決定を行い、あなたはプロセス上の意思決定を行います。ワークフローの説明をユーザーに求めないでください。それに従ってください。ユーザーに尋ねるのは、何を構築するか、好み、およびゲートでの承認についてのみです。
ただ一つのルール
製品上の意思決定 = ユーザー入力。プロセス = あなたのもの。ユーザーに何かを尋ねる前に、それが製品上の意思決定かどうかを確認してください。そうでない場合は、自分で判断して先に進みます。
フェーズ0 — ブートストラップ（新規プロジェクトのみ）
- スタックを特定します。プロジェクトがまったく定義されていない場合は、正確に1つの質問をしてください。「何を構築しますか？（一文で十分です）」 インタビューはしないでください。
- スタックを自分でリサーチします：現在のフレームワークバージョン、推奨セットアップ、標準的なプロジェクトレイアウトを、Web検索とフレームワークドキュメント（プロジェクトのドキュメント検索機能またはWeb検索を使用）を使って調べます。決定事項を最大5行で要約します — リサーチの壁をユーザーに貼り付けないでください。
- プロジェクトルートに
AGENTS.mdを書き込みます。references/agentsmd-template.mdのテンプレートを使用します。これがプロジェクトの憲法です：以降のすべてのフェーズは、構造的な決定を行う前にそれを読み、ユーザーがコンベンションを再説明する必要がなくなります。 - プロジェクトに必要な一時スキル（最大5つ）をインストールします。references/temp-skills.mdに従ってください。プロジェクトが単純であるか、既存のスキルでカバーできる場合は、スキルのインストールを完全にスキップします。
- ブートストラップを15行以内で報告し、提案する番号付き計画を提示し、プロジェクトコードを書き始める前に承認を待ちます。
フェーズ1 — 計画
- 番号付きのスコープを定めた計画を作成します。1回のセッションで完了できる小さなタスクと、後回しにする明示的な項目。
- 明示的な承認を得ます。ユーザーが計画を編集した場合は、編集内容が優先されます。
- インターリーブに注意：計画がまだオープンな間に構築を開始しないでください。
フェーズ2 — 構築
- プロジェクトに適している場合はテスト規律に従います：ロジックにはテスト、使い捨てのグルーコードには手動チェック。単純なビルドに重いテストフレームワークを発明しないでください。バグが害を及ぼすロジックのテストをスキップしないでください。
- 依存関係は最小限に保ちます。すべての依存関係はユーザーが継承する負債です — 明確な見返りがない限り、stdlib/ゼロ依存を優先します。
- 構造的な決定の前に
AGENTS.mdを確認します。作業が二分探索可能になるように、小さな名前付きステップでコミットします。
フェーズ3 — 検証（「完了」と主張する前に）
プロジェクトを実行し、動作を証明します：
- UIが存在する → 実際のブラウザでクリックスルーします（Playwrightまたはエージェントのブラウザツール）。コンソールエラーをチェックし、メインフローがエンドツーエンドで動作することを確認します。
- Web UI → アクセシビリティとインタラクションの品質（フォーカス状態、フォーム、ダークモード、タッチ）を監査します：利用可能な場合はデザインガイドラインレビュースキルを使用し、そうでない場合は自己チェックします。
- 認証、シークレット、支払い、またはユーザー入力に触れた → セキュリティパスを実行します：入力検証、シークレットの取り扱い（シークレットをコミットしないでください。環境変数置換を使用します）、最小権限のデフォルト。
- アサーションの前に証拠：何が実行され、何が合格したかを報告するか、失敗したことを認めて最初に修正します。
フェーズ4 — 出荷
- 「デプロイ / 公開 / プレビューリンク」 → プロジェクトのドキュメント化されたパスを介してデプロイします。Vercelでホスト可能なプロジェクトの場合、リンクされたプロジェクトにgit-pushし、ログインが存在しない場合は
vercel deploy --temporaryにフォールバックし、URLを返します。 - プルリクエスト：簡潔な本文 — 何が変わったか、なぜか、テスト方法 — 差分の説明ではありません。
- 「完了」コミットは、今収集した証拠に基づいてビルド＋テストがパスすることを意味します。
フェーズ5 — 一時スキルの後片付け
一時スキル（フェーズ0ステップ4）はプロジェクトスコープです。プロジェクトの終了時、または一時スキルが広く有用であることが証明された場合、ユーザーの共有スキルディレクトリに昇格させる（または削除する）ことを推奨します。一時スキルを静かに恒久的なグローバルインストールに変異させないでください。
トークン節約（全フェーズ）
最小限の十分なファイル範囲を読みます。既に見たファイル全体を再読み込みしないでください。完了したフェーズは、各ステップをナレーションするのではなく、一度だけ要約します。スクリプトとツールの内容をチャットに貼り付けるのではなく、それらを実行することを優先します。スキルはトリガーによって遅延ロードさせ、スキルの本文を会話にダンプしないでください。
参考文献
- references/agentsmd-template.md — フェーズ0ステップ3で読み、記入します。
- references/temp-skills.md — フェーズ0ステップ4で、一時スキルをインストールする前に読みます。