python-patternslisted
Install: claude install-skill ku5ic/dotfiles
# Python patterns
Default assumption: Python 3.11 or later, type hints required on public function signatures, mypy or pyright in strict mode.
- 3.11 is the floor: `TaskGroup`, `Self`, `StrEnum`, and `ExceptionGroup` all landed there.
- 3.14 (current stable, released 2025-10-07) made deferred annotation evaluation the default; on older supported versions, `from __future__ import annotations` is still useful for forward references.
- Adapt advice to the version in the project's `.tool-versions`, `pyproject.toml`, or `.python-version`.
## Severity rubric
Severity rubric: matches `rules/markdown-report.md` (failure/warning/info).
## Reference files
| File | Covers |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| [reference/typing.md](reference/typing.md) | Type hints, strictness, mypy/pyright per-module overrides |
| [reference/project-layout.md](reference/project-layout.md) | `src/` layout, `pyproject.toml`, packaging, `py.typed` (PEP 561), namespace packages (PEP 420) |
| [reference/async.md](reference/async.md) | `async def` hazards, `TaskGroup`, `anyio` cancellation scopes |
| [reference/errors.md](refere