mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
bce31d52a8
- Core configuration files (CLAUDE.md, RULES.md, PERSONAS.md, MCP.md) - 17 slash commands for specialized workflows - 25 shared YAML resources for advanced configurations - Installation script for global deployment - 9 cognitive personas for specialized thinking modes - MCP integration patterns for intelligent tool usage - Token economy and ultracompressed mode support 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
81 lines
3.3 KiB
Markdown
81 lines
3.3 KiB
Markdown
## Legend
|
|
| Symbol | Meaning | | Abbrev | Meaning |
|
|
|--------|---------|---|--------|---------|
|
|
| → | leads to | | DB | database |
|
|
| & | and/with | | perf | performance |
|
|
| w/ | with | | arch | architecture |
|
|
|
|
Execute immediately. Add --plan flag if user wants to see plan first.
|
|
|
|
Execute comprehensive DB or code migration based on specs in $ARGUMENTS.
|
|
|
|
Thinking flags (optional):
|
|
- --think→multi-system migration coordination
|
|
- --think-hard→complex data transformation & rollback planning
|
|
- --ultrathink→enterprise-scale migration w/ zero-downtime requirements
|
|
|
|
Examples:
|
|
- `/user:migrate --dry-run --think` - Migration preview w/ impact analysis
|
|
- `/user:migrate --think-hard` - Complex migration w/ comprehensive safety planning
|
|
- `/user:migrate --rollback --ultrathink` - Critical rollback w/ full system analysis
|
|
|
|
Migration types:
|
|
|
|
Schema migrations:
|
|
- Create, alter, or drop tables | Add or modify indexes→perf
|
|
- Update constraints & relationships | Manage DB versioning
|
|
|
|
Data migrations:
|
|
- Transform existing data→new format | Backfill missing or derived data
|
|
- Clean up obsolete or orphaned records | Ensure data integrity throughout
|
|
|
|
Code migrations:
|
|
- Refactor→new patterns or arch
|
|
- Update to new framework versions
|
|
- Migrate between different technologies
|
|
- Modernize legacy code
|
|
|
|
Follow the safe migration workflow:
|
|
1. Plan - Design migration strategy and rollback plan
|
|
2. Backup - Create full backup of affected data/code
|
|
3. Test - Run migration in test environment first
|
|
4. Execute - Apply migration with transaction support
|
|
5. Verify - Validate migration success and data integrity
|
|
|
|
When --dry-run flag is present:
|
|
- Preview all changes without executing
|
|
- Show affected records/files count
|
|
- Estimate migration duration
|
|
- Identify potential issues
|
|
|
|
When --rollback flag is present:
|
|
- Revert to pre-migration state
|
|
- Use transaction rollback when possible
|
|
- Restore from backup if needed
|
|
- Verify system stability
|
|
|
|
## Safety Measures & Best Practices
|
|
|
|
Safety measures:
|
|
- Use database transactions for atomicity
|
|
- Calculate checksums for data validation
|
|
- Implement idempotent migrations
|
|
- Test rollback procedure before execution
|
|
- Monitor system during migration
|
|
|
|
Research requirements for migration:
|
|
- Database patterns → C7 documentation for database-specific migration patterns
|
|
- Framework migrations → Must verify with official migration guides and best practices
|
|
- Data transformation → Research ETL patterns and data integrity verification methods
|
|
- Zero-downtime patterns → WebSearch for platform-specific blue-green migration strategies
|
|
- Never migrate without tested rollback - always verify migration patterns
|
|
- All migration scripts must cite sources: // Source: [migration guide reference]
|
|
|
|
Report Output:
|
|
- Migration logs: `.claudedocs/reports/migration-<timestamp>.md`
|
|
- Data integrity reports: `.claudedocs/metrics/data-validation-<timestamp>.md`
|
|
- Rollback procedures: `.claudedocs/summaries/rollback-plan-<timestamp>.md`
|
|
- Ensure directory exists: `mkdir -p .claudedocs/reports/ .claudedocs/metrics/ .claudedocs/summaries/`
|
|
- Include report location in output: "📄 Migration report saved to: [path]"
|
|
|
|
Deliverables: Migration script with rollback capability, execution report with statistics, backup confirmation, data integrity verification, and rollback procedure documentation. |