docs: update all examples and docs to use version tags instead of @main

[sfreudenthaler]

🎯 Production Best Practices Update

This PR updates all documentation and examples to emphasize using version tags instead of for production stability.

✅ Changes Made

• README.md: Updated migration checklist to emphasize using instead of
• Migration Guide: Added section explaining why version tags matter for production
• All Example Files: Updated to use instead of
• Documentation: Added warnings about production stability

🚨 Why This Matters

Using in production can cause:

• Unexpected behavior when main branch is updated
• Breaking changes affecting production workflows
• Difficulty in rollback scenarios
• Inconsistent behavior across deployments

📋 Migration Checklist Updated

The migration checklist now includes:

1. ✅ Remove references to the old pilot workflow
2. ✅ Update workflow to use orchestrator with version tags ()
3. ⚠️ Important: Always use version tags for production stability
4. ✅ Configure secret
5. ✅ Test migration with sample PR

🔗 Files Updated

• • Migration checklist and examples
• • Version tag best practices
• • Updated to
• • Updated to
• • Updated to

This ensures all teams migrating to the centralized workflows will follow production best practices from day one.