データベース設計

SQL パターンをコピーするのではなく、考える方法を学ぶ。

🎯 選別読書ルール

リクエストに関連するファイルのみを読む！ コンテンツマップを確認し、必要なものを見つけます。

ファイル	説明	読むべき時
database-selection.md	PostgreSQL vs Neon vs Turso vs SQLite	データベースを選択する時
orm-selection.md	Drizzle vs Prisma vs Kysely	ORM を選択する時
schema-design.md	正規化、主キー、リレーションシップ	スキーマを設計する時
indexing.md	インデックスタイプ、複合インデックス	パフォーマンスチューニング時
optimization.md	N+1、EXPLAIN ANALYZE	クエリ最適化時
migrations.md	安全なマイグレーション、サーバーレス DB	スキーマ変更時

---

⚠️ 核となる原則

• データベース設定が不明な場合、ユーザーに確認する
• コンテキストに基づいてデータベース/ORM を選択する
• すべてに PostgreSQL をデフォルトにしない

---

決定チェックリスト

スキーマ設計前に確認:

• ユーザーのデータベース設定を確認した?
• この文脈用のデータベースを選択した?
• デプロイ環境を検討した?
• インデックス戦略を計画した?
• リレーションシップタイプを定義した?

---

アンチパターン

❌ シンプルなアプリに PostgreSQL をデフォルトにする (SQLite で十分な場合がある) ❌ インデックスをスキップする ❌ 本番環境で SELECT * を使う ❌ 構造化データが適切な場合に JSON を保存する ❌ N+1 クエリを無視する

使用時期

このスキルは、概要に記載されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• このスキルは、タスクが上記で説明されているスコープに明確に一致する場合にのみ使用してください。
• 出力を環境固有の検証、テスト、または専門家によるレビューの代替と見なしてはいけません。
• 必要な入力、権限、安全性の境界、または成功基準が不足している場合は、立ち止まって明確化を求めてください。