Back to Skills
antigravityCreative & Media

database-design

Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.

Documentation

Database Design

Learn to THINK, not copy SQL patterns.

šŸŽÆ Selective Reading Rule

Read ONLY files relevant to the request! Check the content map, find what you need.

FileDescriptionWhen to Read
database-selection.mdPostgreSQL vs Neon vs Turso vs SQLiteChoosing database
orm-selection.mdDrizzle vs Prisma vs KyselyChoosing ORM
schema-design.mdNormalization, PKs, relationshipsDesigning schema
indexing.mdIndex types, composite indexesPerformance tuning
optimization.mdN+1, EXPLAIN ANALYZEQuery optimization
migrations.mdSafe migrations, serverless DBsSchema changes

āš ļø Core Principle

  • ASK user for database preferences when unclear
  • Choose database/ORM based on CONTEXT
  • Don't default to PostgreSQL for everything

Decision Checklist

Before designing schema:

  • Asked user about database preference?
  • Chosen database for THIS context?
  • Considered deployment environment?
  • Planned index strategy?
  • Defined relationship types?

Anti-Patterns

āŒ Default to PostgreSQL for simple apps (SQLite may suffice) āŒ Skip indexing āŒ Use SELECT * in production āŒ Store JSON when structured data is better āŒ Ignore N+1 queries