## Summary

<!-- Provide a concise description of your changes. What does this PR do? -->


## Changes

<!-- Describe your changes in detail. Use checkboxes if applicable. -->

- [ ] Change 1
- [ ] Change 2
- [ ] Change 3

## Problem

<!-- (Optional) Describe the problem this PR solves. What was broken or missing? -->


## Solution

<!-- (Optional) Explain your approach and key decisions. Why did you choose this solution? -->


## Implementation Details

<!-- (Optional) For complex changes, provide technical details: -->
<!-- - Architecture decisions -->
<!-- - Key algorithms or patterns used -->
<!-- - Important file/line references (use file_path:line_number format) -->


## Trade-offs

<!-- (Optional) Discuss any trade-offs made (performance, memory, complexity, etc.) -->


## Benefits

<!-- (Optional) Highlight the advantages of this change -->


## Test Results

<!-- Describe testing performed. Include relevant command outputs. -->

```bash
# Commands used to test
pnpm build
pnpm lint
pnpm typecheck
pnpm test:all
```

**Results:**
- [ ] All tests passing
- [ ] Build successful
- [ ] Type checking passing
- [ ] Lint passing (0 errors)


## Test Coverage

<!-- (Optional) Describe what scenarios are covered by tests -->

- [ ] Core functionality tested
- [ ] Edge cases covered
- [ ] Error scenarios handled
- [ ] Integration tests added


## Breaking Changes

<!-- Does this PR introduce breaking changes? If yes, describe migration path. -->

**None** / **Yes** (delete as appropriate)

<!-- If yes, provide migration guide: -->


## Checklist

<!-- Ensure all items are checked before requesting review -->

- [ ] Code follows project conventions (see `docs/develop/STANDARDS.md`)
- [ ] Commit messages follow conventional commits (see `docs/develop/commit-convention.md`)
- [ ] Tests added/updated and all passing
- [ ] Build passes (`pnpm build`)
- [ ] Type checking passes (`pnpm typecheck`)
- [ ] Lint passes with 0 errors (`pnpm lint`)
- [ ] Documentation updated (if needed)
- [ ] Related issue linked (if applicable)


## Related Issues

<!-- Link related issues using GitHub keywords -->

Closes #
Fixes #
Related to #


## Screenshots/Demos

<!-- (Optional) Add screenshots, GIFs, or command outputs to demonstrate changes -->


## Migration Guide

<!-- (Optional) If breaking changes, provide clear migration instructions for users -->


## Next Steps

<!-- (Optional) List follow-up tasks or future improvements -->

- [ ] Task 1
- [ ] Task 2