database-design

データベース設計

SQLのパターンをコピーするのではなく、考え方を学びましょう。

🎯 選択的に読むためのルール

リクエストに関連するファイルだけを読んでください！ コンテンツマップを確認し、必要なものを見つけてください。

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

---

⚠️ 基本原則

• 不明な点があれば、ユーザーにデータベースの希望を尋ねます
• コンテキストに基づいてデータベース／ORMを選びます
• すべてにPostgreSQLをデフォルトで選ばないでください

---

判断チェックリスト

スキーマを設計する前に：

• ユーザーにデータベースの希望を尋ねましたか？
• このコンテキストに適したデータベースを選びましたか？
• デプロイ環境を考慮しましたか？
• インデックス戦略を計画しましたか？
• リレーションシップの種類を定義しましたか？

---

アンチパターン

❌ 単純なアプリでデフォルトとしてPostgreSQLを選ぶ（SQLiteで十分な場合があります） ❌ インデックスを省略する ❌ 本番環境でSELECT *を使う ❌ 構造化データのほうが適しているのにJSONを保存する ❌ N+1クエリを無視する

使用するタイミング

データベースモデルの選択、スキーマのリレーションシップとインデックスの確認、または付属のアドバイザリーツールを使った提案スキーマの評価に使用します。

スキーマヘルパー

scripts/schema_validator.pyは読み取り専用のヒューリスティックなインベントリであり、PrismaやDrizzleのパーサーではありません。スキーマが見つからない場合、未対応の形式の場合、またはヒューリスティックな結果しか得られない場合は、passed: falseおよびanalysis_complete: falseを返してゼロ以外の終了コードで終了します。構文と型のチェックにはプロジェクト固有のORMバリデーターを使用し、マイグレーションと制約の意味は別途確認してください。

制限事項

• タスクが上記の範囲に明確に合致する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中断して確認を求めてください。