See @README.md for project overview and @package.json for available npm/pnpm commands for this project.
- Use descriptive variable names
- Follow existing patterns in the codebase
- Extract complex conditions into meaningful boolean variables
Add important architectural decisions and patterns here.
Document frequently used workflows and commands here.