For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /packs/languages/python/naming.md.
Quick start

Naming

Name the operation and its domain value clearly.

Conventions

Why

Predictable casing and explicit verbs make modules easier to navigate without a framework's conventions.

Rules

  • MUST use snake_case for files, modules, functions, and ordinary values. [review]
  • MUST use PascalCase for named data types, enums, and protocols. [review]
  • MUST use SCREAMINGSNAKECASE for constants. [review]
  • MUST give predicates an is_, has_, can_, or should_ prefix when appropriate. [review]
  • MUST prefix module-private declarations with an underscore. [review]
  • MUST name modules for their owning capability rather than a generic helpers bucket. [review]
  • MUST avoid abbreviations that obscure the domain meaning. [review]

[review]

Configured lint rules check their supported conventions. Review checks operation precision and scope.

Enforcement

Configured lint rules check their supported conventions. Review checks operation precision and scope.