## Summary

<!-- Provide a brief description of the changes in this PR -->

## Type of Change

<!-- Please check the one that applies to this PR using "x" -->

- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
- [ ] ✨ New feature (non-breaking change which adds functionality)
- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] 📚 Documentation update
- [ ] 🧹 Code refactoring (no functional changes)
- [ ] ⚡ Performance improvement
- [ ] 🔧 Build/CI changes
- [ ] 🧪 Test changes

## Related Issue

<!-- If this PR addresses an issue, link it here -->
Fixes #(issue)

## Changes Made

<!-- List the specific changes made in this PR -->

- 
- 
- 

## Testing

<!-- Describe the tests you ran to verify your changes -->

- [ ] Unit tests pass (`pytest tests/unit/`)
- [ ] Integration tests pass (`pytest tests/integration/`)
- [ ] End-to-end tests pass (`pytest tests/e2e/`)
- [ ] Performance tests pass (if applicable)
- [ ] Manual testing completed

### Test Evidence

<!-- Include test results, screenshots, or other evidence -->

## Performance Impact

<!-- Check all that apply -->

- [ ] No performance impact expected
- [ ] Performance improvement expected
- [ ] Performance degradation possible (please explain below)
- [ ] Performance impact unknown (requires benchmarking)

<!-- If performance impact expected, provide details -->

## Breaking Changes

<!-- If this is a breaking change, describe what breaks and how to migrate -->

## Checklist

<!-- Please check all that apply using "x" -->

### Code Quality

- [ ] Code follows the project's style guidelines
- [ ] Self-review of code completed
- [ ] Code is properly documented
- [ ] Comments added for complex logic
- [ ] No debugging code or print statements left in

### Testing

- [ ] New tests added for new functionality
- [ ] Existing tests updated as needed
- [ ] All tests pass locally
- [ ] Code coverage maintained or improved

### Documentation

- [ ] README updated (if needed)
- [ ] API documentation updated (if needed)
- [ ] Changelog updated (if needed)
- [ ] Migration guide provided (for breaking changes)

### Security

- [ ] Security implications considered
- [ ] No sensitive data exposed
- [ ] Dependencies reviewed for vulnerabilities
- [ ] Input validation added where appropriate

### CI/CD

- [ ] All CI checks pass
- [ ] Branch is up to date with main
- [ ] Commit messages follow conventional format
- [ ] PR is ready for review

## Additional Notes

<!-- Any additional information that reviewers should know -->

## Screenshots (if applicable)

<!-- Add screenshots or GIFs to help explain your changes -->

---

**Reviewer Guidelines:**
- Verify all checklist items are completed
- Test the changes locally
- Check for security implications
- Ensure backward compatibility (unless breaking change is justified)
- Verify performance impact is acceptable