Introduce a comprehensive migration guide outlining the changes from `dir_spec` v0.4.x to v0.5.0. Details include breaking changes, updated API usage, complete migration examples, automated migration scripts, and benefits of the new design. Documentation and examples have been updated for consistency with the module-level function API.