vibe-coding

バイブコーディング

バイブコーディングとは、あなたが方向を定め、エージェントがリリースを支援することです。最初からすべてを極める必要はありません。必要なのは、短いサイクル、正直な検証、そして必要なときに適切な小さなコンテキストです。これはどのプロジェクトにも当てはまります。

習慣

1. 細分化して、リリース可能な最小の変更にします。次のステップが明確になるよう、機能を1つ、失敗パターンを1つ、画面を1つなどに絞ります。
2. 適切なリファレンスを確認しながら実装します。プロジェクトのスキル、フレームワークのドキュメント、公式 API ページなどを参照します。チャットに場当たり的なルールを大量に書き込むのは避けましょう。
3. 完了とする前に検証します。テスト、スクリプト、リンター、またはユーザーが再現できる手順を実行します。何も実行していない場合は、何を実行すべきかを伝えます。
4. 反復します。ユーザーから明示的に依頼されていない限り、認証、UI、データを一度に混ぜた巨大な差分は避けます。

スキルと長いプロンプト

• 毎回同じ長い指示を貼り付けるより、短いドメインスキル（または公式ドキュメントへのリンク）を優先します。
• エージェントがライブラリの API を繰り返し推測する場合は、トレーニングデータをもとに即興で答えさせるのではなく、最新のドキュメント（または専用のスキル）を確認します。

エコシステム：レイヤーを分ける

• アプリと UX（フレームワーク、コンポーネント、アクセシビリティ、デザイン、ルーティング）：そのレイヤーに適したスキルやドキュメントを使います。参照できる例として、skills.sh やチームが提供しているものがあります。
• データと API（データベース、HTTP クライアント、モデル／音声／翻訳プロバイダー）：その製品の公式リファレンス、またはプロバイダー専用のスキルを使います。UI スキルにある HTTP リクエストの例を、実際の仕様に照らし合わせずに実際のクライアントへコピーしてはいけません。
• モデル、音声、翻訳、またはビジョンの機能：ほかの API と同様に扱います。一般的なチャットの推測より、ベンダーのドキュメントやプロバイダーのスキルを優先します。

注意点

問題	対応方法
古い API や、実在しない API	最新のプロジェクトドキュメントまたはプロバイダーのドキュメントを開き、記憶だけを頼りにしないでください。
あるスキルの例が別のレイヤーに持ち込まれる	React スキルの fetch スニペットが、そのままモデル API に使えるとは限りません。適切な仕様と照らし合わせてください。
あらゆるリクエストに長文を貼り付ける	スキル、ドキュメントへのリンク、または数項目の箇条書きに絞り、ライブラリが変わったら更新します。
「一気に全部」リファクタリング	分割し、検証し、繰り返します。