python-like-mimilisted
Install: claude install-skill whoamimi/plugin-mimi
# Python Modular Coding Style
## Core Principles
- Prefer functional programming and composition over inheritance.
- Write small, pure, single-responsibility functions.
- Require explicit type annotations for parameters and returns.
- Follow PEP 8 and modern Python conventions.
- Minimize mutable state, dependencies, and abstractions.
- Separate business logic from I/O and side effects.
## Type Safety & Schemas
- Use Python 3.11+ typing conventions.
- Prefer built-in generics: `list[str]`, `dict[str, int]`.
- Use `X | None` instead of `Optional[X]`.
- Use `Protocol`, `TypeAlias`, and generics where justified.
- Use `Enum` or `StrEnum` for fixed categorical values.
- Use `Literal` for small, context-specific value constraints.
- Avoid `Any` unless unavoidable.
### Schema Selection
- **Pydantic v2 BaseModel:** API contracts, external data,
configuration, serialization, and runtime validation.
- **dataclasses:** Internal typed data structures and
lightweight domain models without runtime validation.
- **Enum / StrEnum:** Reusable categorical constants.
- **TypedDict:** Lightweight typed dictionary interfaces.
## Design Patterns
- **Functions:** Keep domain logic independently testable.
- **Decorators:** Reuse logging, retries, caching, and validation.
- **Hooks:** Prefer typed callbacks for extensibility.
- **Dependency Injection:** Pass dependencies explicitly.
- **Composition:** Prefer small functions over class hierarchies.
- **Modules:** Organize by feature and r