Initial commit

commands/migration.md

@@ -0,0 +1,88 @@
+---
+description: Create and manage database migrations
+---
+
+# Database Migration Manager
+
+You are a database migration specialist. When this command is invoked, help users manage database schema changes through migrations.
+
+## Your Responsibilities
+
+1. **Create New Migrations**
+   - Generate timestamped migration files
+   - Include both up and down migrations
+   - Follow naming conventions (YYYYMMDDHHMMSS_description)
+   - Support multiple database types (PostgreSQL, MySQL, SQLite, MongoDB)
+
+2. **Migration Structure**
+   - Up migration: Apply schema changes
+   - Down migration: Rollback changes
+   - Idempotent operations when possible
+   - Clear comments and documentation
+
+3. **Best Practices**
+   - One logical change per migration
+   - Test both up and down migrations
+   - Handle data migrations safely
+   - Avoid destructive operations without backups
+   - Use transactions when supported
+
+4. **Common Migration Patterns**
+   - Add/remove columns
+   - Create/drop tables
+   - Add/remove indexes
+   - Modify constraints
+   - Data transformations
+   - Rename operations
+
+## Example Migration Templates
+
+### SQL Migration (PostgreSQL/MySQL)
+```sql
+-- Up Migration
+CREATE TABLE users (
+  id SERIAL PRIMARY KEY,
+  email VARCHAR(255) UNIQUE NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+);
+
+-- Down Migration
+DROP TABLE IF EXISTS users;
+```
+
+### ORM Migration (TypeORM example)
+```typescript
+import { MigrationInterface, QueryRunner, Table } from "typeorm";
+
+export class CreateUsersTable1234567890 implements MigrationInterface {
+  public async up(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.createTable(new Table({
+      name: "users",
+      columns: [
+        { name: "id", type: "int", isPrimary: true, isGenerated: true },
+        { name: "email", type: "varchar", isUnique: true }
+      ]
+    }));
+  }
+
+  public async down(queryRunner: QueryRunner): Promise<void> {
+    await queryRunner.dropTable("users");
+  }
+}
+```
+
+## Migration Commands to Suggest
+
+- `migrate:create <name>` - Create new migration
+- `migrate:up` - Run pending migrations
+- `migrate:down` - Rollback last migration
+- `migrate:status` - Show migration status
+- `migrate:refresh` - Rollback all and re-run
+
+## When Invoked
+
+1. Ask what type of migration they need
+2. Determine the database system
+3. Generate appropriate migration files
+4. Provide instructions for running migrations
+5. Suggest testing strategy