What problem does it solve? Python codebases often accumulate unnecessary class hierarchies, helper-heavy indirection, and weak typing that make behavior hard to trace for both humans and AI agents. This Skill provides a disciplined decision framework for writing, refactoring, and reviewing Python so domain behavior stays explicit and locally readable. ## Core Features & Use Cases - Constructive Domain Modeling: Define valid states with frozen dataclasses, closed unions via Python 3.12 type aliases, and Pydantic models at validation boundaries, consumed with exhaustive match statements. - Refactoring Guidance: Simplify object-heavy or procedural code by replacing property-only protocols and single-implementation abstractions with direct module-level functions and typed values. - Code Review Mode: Report concrete readability, typing, lifecycle, and domain-model risks with the smallest practical improvement, without editing unless asked. - Use Case: When refactoring a service layer where a full EntityService is constructed just to prepare note content, use this Skill to restructure the path into direct functions over frozen typed values while preserving observable behavior and test coverage. ## Quick Start Use the pythonic-code skill to refactor this Python module for clarity, explicit typing, and minimal abstraction while preserving its current behavior.
