---
description:
globs:
alwaysApply: true
---
1. The technical details for the project are in [SPEC.md](mdc:SPEC.md).
2. The project structure is reflected in [AGENTS.md](mdc:AGENTS.md).
3. Local testing hints are in [TESTING.md](mdc:TESTING.md)
4. You are working in VSCode devcontainer environment, so no any additional virtual environment management is required.
5. If any new package needs to be installed it needs to be done with 'sudo `which uv` pip install --system "<package>"' command. Don't forget to update [pyproject.toml](mdc:pyproject.toml) with the new package.
6. **File Size Guidelines**: Regular Python modules should generally not exceed 500 lines of code (LOC). If a module approaches this limit, consider splitting it into multiple focused modules (e.g., `address_tools.py` and `address_tools_advanced.py`) to maintain readability and logical organization.
7. **Import Placement**: ALL import statements must be placed at the top of the Python module, immediately after the module docstring (if present) and before any other code. Never insert imports inline near where the functionality is used. Follow PEP 8 import order.
8. **Formatting & Linting**: ALL linting and formatting issues must be resolved before committing or pushing code. Use the Ruff rules defined in [300-ruff-lint-and-format.mdc](mdc:.cursor/rules/300-ruff-lint-and-format.mdc) to identify and fix issues.