2.9 - Migration Guide v3.x → v4.0.0

[isaaceliape]

High Priority Documentation Task

Complete migration guide for users upgrading to v4.0.0.

Content

Breaking Changes

• Error handling (throw vs exit)
• New modular structure
• Logging system
• Node version requirements

Migration Steps

• Backup instructions
• Upgrade command
• Hook migration
• Config migration
• Rollback instructions

Troubleshooting

• Common errors
• Solutions
• When to rollback

Examples

• Before/after code examples
• Hook migration examples
• Config examples

Formats

• docs/migration/v4.md
• README section
• CHANGELOG detailed
• Video tutorial (optional)

Acceptance Criteria

• Guide clear and complete
• Examples tested
• PT/EN translations

Estimated

1 day

---

Phase: 02 - Stability
Priority: High
Sprint: 3