docs: add comprehensive refactoring plan for provisioned container module

- Add detailed analysis of src/e2e/provisioned_container.rs
- Document 20 key improvement areas across 5 categories
- Include architecture patterns, error handling, and observability improvements
- Provide 5-phase implementation strategy with priorities
- Add concrete code examples and success metrics
- Follow markdown linting standards for documentation quality

Author: josecelano