Generate production-ready Python Cursor rules for Project Rules (.mdc), AGENTS.md, or legacy .cursorrules. This template encodes stack-specific conventions for projects using Python. High-level language with dynamic typing, extensive standard library, and broad ecosystem.
The template focuses Cursor AI on concrete Python practices instead of generic coding advice. Required sections are always included; optional sections can be enabled when they match your project.
The generator turns these sections into Project Rules with frontmatter, AGENTS.md, or a single .cursorrules file depending on the output format you choose.
- Follow PEP 8 conventions.
- Use 4 spaces for indentation (no tabs).
- Use {{QUOTE}} quotes for strings consistently.
- Maximum line length: 88 characters (Black default).
- Use snake_case for variables, functions, and methods.
- Use PascalCase for class names.- Use type hints for all function signatures.
- Use Optional[T] instead of T | None for Python < 3.10 compatibility.
- Use collections.abc types for interfaces (Iterable, Sequence, Mapping).
- Use typing.TypedDict for structured dictionaries.
- Use dataclasses for data containers.
- Use Protocol for duck-typing interfaces.- Use src-layout: put source code under src/ directory.
- Use pyproject.toml for project configuration.
- Separate tests in a tests/ directory mirroring the source tree.
- Use __init__.py files (even if empty) for explicit package boundaries.
- Use relative imports within packages where appropriate.
- Keep modules focused and under 500 lines.