- Read
docs/architecture.mdfor an architectural overview of the project. Refactors should always start here first. - The project uses
uv,ruffandty - Typechecking is done via
uv run ty check - Run commands should be prefixed with
uv:uv run ... - Use
asynciofeatures, if such is needed - Prefer early returns
- Private methods always go below public methods
- Absolutely no useless comments! Every class and method does not need to be documented (unless it is legitimetly complex or "lib-ish")
- Imports belong at the top of files, not inside functions (unless needed to avoid circular imports)
- Never delete behavior tests to make things pass. Fix the code or update the tests to reflect new behavior