Python
These pages hold the Python conventions referenced by AGENTS.md. Read the
page that matches the work you are doing instead of treating AGENTS.md as a
long-form style manual.
Pages
- Imports and typing: import paths, annotation rules, and type boundary constraints.
- Conventions: Python style, docstrings, async patterns, error handling, and framework-specific rules.
- Comments: comment, docstring, and field comment expectations.
- Module layout and exports: file naming, package layout,
__init__.pyusage, and export rules. - Testing and pull requests: test conventions, fixture placement, PR expectations, and commit message guidance.
- Tool design: first-party tool contracts, model-facing results, error boundaries, docs, examples, and tests.