Refactor code for readability Prompt

Refactor this code for readability and maintainability.

[PASTE CODE]

Language: [describe]
Context: [what this code does]
Priorities (check all that apply):
- [ ] Improve naming
- [ ] Break up long functions
- [ ] Remove duplication
- [ ] Add comments
- [ ] Improve error handling

Constraints: must not change external behaviour. [Other constraints]

Please:
1. Return the refactored code
2. List each change and why
3. Flag bigger architectural issues to address separately