プロンプトガイド

依頼とレビューの粒度

• 作業単位でこまめに依頼、レビュー、コミットする。
• こまめにコミットすることですぐに巻き戻せる。

依頼の粒度が大きい場合、プランモードを使用する

「プロフィール編集機能作って」などはそこそこ粒度が大きく、実装アプローチも多肢にわたるため、まずはプランモードを使用して実装アプローチの精度を高める。

逆に、「プロフィール用のテーブルを以下の内容で作って」など粒度が細かく、指示も明確である場合はプランモードを使用せずに直接実装を依頼する。

AI生成のレビュー時に気をつけること

ありがちなアンチパターンをまとめます。

• データ取得目的でサーバーアクションを使用してしまう
  • 正: データ取得はデータアクセスレイヤーで行う（/data）
• 文字列のZod検証で trim が抜けている
  • 正: .trim() を使用してスペースの登録を回避する
• 型を同ファイルに定義してしまう
  • 正: 型は /types に定義する
  • 絶対にそこでしか使わないことが明確である場合、同ファイルに定義しても良い

自分で書いた方が早い場面

複雑なレイアウト、UIは正解の判断に視覚的、体験的観点が必要になるため、プロンプトだけで答えに辿り着くのが難しい場合がある。この場合自分で書いた方が早い。