mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
219ff3905a
Major streamlining achievement: - Eliminate 2,733 lines of duplicate content across commands - Reduce individual command files by ~70% (130-150 → 35-60 lines) - Leverage existing shared/*.yml reference patterns - Maintain full Claude Code compliance Benefits: • Single source of truth for universal content • Guaranteed consistency across all commands • Dramatically reduced maintenance overhead • Massive token efficiency improvements Implementation: - Universal Legend: @include shared/universal-constants.yml#Universal Legend - Universal Flags: @include shared/flag-inheritance.yml#Universal_Always - Command patterns: References to appropriate shared/*.yml files - Template system: Enhanced command-patterns.yml 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
146 lines
2.7 KiB
Markdown
146 lines
2.7 KiB
Markdown
# /migrate - Execute database and code migrations
|
|
|
|
## Legend
|
|
@include shared/universal-constants.yml#Universal_Legend
|
|
|
|
## Purpose
|
|
Execute comprehensive database or code migrations based on specifications in $ARGUMENTS with safety checks and rollback capabilities.
|
|
|
|
## Syntax
|
|
`/migrate [flags] [migration-spec]`
|
|
|
|
@include shared/flag-inheritance.yml#Universal_Always
|
|
|
|
## Core Flags
|
|
|
|
--type flag:
|
|
- database: SQL schema migrations
|
|
- code: Codebase refactoring
|
|
- api: API version migration
|
|
- data: Data transformation
|
|
- full: Complete system migration
|
|
|
|
--direction flag:
|
|
- up: Apply migrations forward
|
|
- down: Rollback migrations
|
|
- status: Check migration state
|
|
- validate: Test without applying
|
|
|
|
--target flag:
|
|
- latest: All pending migrations
|
|
- version: Specific version
|
|
- step: Number of migrations
|
|
- timestamp: Up to date/time
|
|
|
|
## Migration Types
|
|
|
|
Database Migrations:
|
|
- Schema changes (add/drop tables)
|
|
- Column modifications
|
|
- Index optimization
|
|
- Constraint updates
|
|
- Data transformations
|
|
|
|
Code Migrations:
|
|
- API version updates
|
|
- Framework upgrades
|
|
- Dependency updates
|
|
- Structure refactoring
|
|
- Pattern modernization
|
|
|
|
Data Migrations:
|
|
- Format conversions
|
|
- Bulk transformations
|
|
- ETL operations
|
|
- Cleanup operations
|
|
- Normalization
|
|
|
|
## Safety Features
|
|
|
|
Pre-Migration:
|
|
- Backup current state
|
|
- Validate migration files
|
|
- Check dependencies
|
|
- Test in transaction
|
|
- Estimate impact
|
|
|
|
During Migration:
|
|
- Transaction wrapping
|
|
- Progress tracking
|
|
- Error handling
|
|
- Partial rollback
|
|
- Health checks
|
|
|
|
Post-Migration:
|
|
- Verify integrity
|
|
- Update documentation
|
|
- Clear caches
|
|
- Run tests
|
|
- Monitor performance
|
|
|
|
## Migration Workflow
|
|
|
|
1. Analysis Phase:
|
|
- Scan current state
|
|
- Identify changes needed
|
|
- Generate migration plan
|
|
- Estimate risks
|
|
|
|
2. Preparation Phase:
|
|
- Create backups
|
|
- Prepare rollback plan
|
|
- Set up monitoring
|
|
- Notify stakeholders
|
|
|
|
3. Execution Phase:
|
|
- Run migrations
|
|
- Track progress
|
|
- Handle errors
|
|
- Apply fixes
|
|
|
|
4. Validation Phase:
|
|
- Verify success
|
|
- Run test suite
|
|
- Check performance
|
|
- Update docs
|
|
|
|
## Best Practices
|
|
|
|
Safety:
|
|
- Always backup first
|
|
- Test in staging
|
|
- Use transactions
|
|
- Plan rollbacks
|
|
- Monitor closely
|
|
|
|
Performance:
|
|
- Batch operations
|
|
- Off-peak execution
|
|
- Index management
|
|
- Query optimization
|
|
- Resource limits
|
|
|
|
## Examples
|
|
|
|
```bash
|
|
# Database migration to latest
|
|
/migrate --type database --direction up
|
|
|
|
# Rollback last 2 migrations
|
|
/migrate --type database --direction down --step 2
|
|
|
|
# Code migration with validation
|
|
/migrate --type code --validate --think
|
|
|
|
# Full system migration plan
|
|
/migrate --type full --plan --ultrathink
|
|
```
|
|
|
|
## Deliverables
|
|
|
|
- Migration scripts
|
|
- Rollback procedures
|
|
- Execution logs
|
|
- Validation reports
|
|
- Updated documentation
|
|
- Performance metrics |